
ssh-chat (현대 C 언어로 구현)

범용 BBS 소프트웨어
SSH-Chatter는 Go로 작성된 ssh-chat 서버를 C로 재구현한 것에서 시작되었습니다. 현대적인 C 패턴과 작고 테스트 가능한 코어를 사용하면서 원래 동작을 그대로 반영하고 확장합니다. 이 서버는 SSH/TELNET 연결을 수신하고 인증된 모든 사용자를 공유 채팅방에 배치하며, 이 채팅방은 Go 참조 구현과 동일한 명령 인터페이스를 제공합니다.
C를 이해하는 데 왜 그렇게 오래 걸리는지 아시나요? 그것은 본능이기 때문입니다.
/rss list, /rss read <tag>로 접근 가능한 터미널 친화적 RSS 리더와 /rss add <url> <tag>, /rss del <tag>(운영자 전용)를 통해 방 사용자들이 함께 헤드라인을 둘러볼 수 있습니다./delete-msg가 있습니다./bbs 명령입니다.
list [hot|top|new|bumped|all]을 사용해 bumped(최근 활동), hot(점수 및 댓글 기준 인기), top(최고 순점수), new(작성일) 기준으로 정렬된 게시물을 볼 수 있습니다.search <query>로 게시물 제목, 본문, 작성자 또는 태그를 대소문자 구분 없이 즉시 검색할 수 있습니다.Score: 12 Comments: 5)를 바로 표시합니다.cmtreply <id> <idx> <text>는 댓글에 답글을 답니다. 답글은 부모 아래에 들여쓰기되어 표시되며(깊이는 최대 4단계), 부모 작성자에게 알림을 보내고, 답글 대상 댓글이 삭제되면 한 단계 위로 이동합니다. 답글 링크는 bbs_state_threads.dat 사이드카에 저장되므로 bbs_state.dat는 v3 레이아웃을 유지합니다./bbs 접두사 없이도 명령이 자동 라우팅됩니다./bbs post art <title>(또는 /asciiart bbs <title>, 또는 art 게시판에서 일반 post)을 실행하면 art 게시판용 아트 작성기가 열립니다. 붙여넣은 SGR 색상(16/256/트루컬러)은 유지되며 각 행 뒤에 리셋을 넣어 줄 단위로 재생됩니다. 커서 이동, 화면 지우기, OSC/DCS 문자열 및 터미널 쿼리는 저장 전과 표시 시에 다시 제거됩니다.>/__ARTWORK_END> 기본값으로 제출하는 키보드 단축키를 갖춘 /asciiart 라이브 작성기입니다./birthday, LAN 운영자가 주소로 권한을 위임할 수 있는 /grant <ip>, 최상위 LAN 관리자가 권한을 회수할 수 있는 /revoke <ip>가 있습니다./multilingual-route on|off로 선택적 인코딩 기반 채팅방을 사용할 수 있습니다. 비ASCII UTF-8 메시지는 UTF-8로 라우팅되고, 레거시 비CP437 입력은 해당 코드페이지 방(예: CP949)으로 라우팅됩니다. 방은 처음 사용할 때 생성되어 기록에 유지되며, /room list와 /room join <name>으로 탐색할 수 있습니다./unread를 통한 방별 읽기 위치 영구 저장과, 멘션·답글·비공개 메시지를 위한 /unread mentions가 있습니다. /room list는 사용자 수, 읽지 않은 수, 마지막 활동을 보여주며, /help <command>는 현지화된 사용법, 예제, 관련 명령을 제공합니다./update를 실행해 모든 레거시 사용자 기록을 현재 디스크 형식으로 마이그레이션하고 서버를 정상적으로 재시작할 수 있습니다. 마이그레이션 실패 시 재시작이 취소됩니다./ban 업그레이드가 있습니다./weather <city>가 있습니다.

새 기여자가 빠르게 탐색할 수 있도록 코드베이스는 의도적으로 간결하게 유지됩니다:
| 경로 | 설명 |
|---|---|
src/main.c | 명령줄 파싱 및 프로세스 부트스트랩(바인드 주소, 포트, MOTD, 호스트 키 디렉터리). |
src/host_aggregate.c, include/ssh_chatter/host.h | 채팅 호스트 구현 – 세션 수명 주기, MOTD 처리, 향후 메시지 브로드캐스트 로직을 위한 훅. |
src/host | src/host_aggregate.c를 통해 단일 번역 단위로 컴파일되는 모듈식 호스트 하위 시스템. |
include/ssh_chatter | 데몬, 스트레스 도구, 번역 백엔드를 위한 공유 헤더. |
include/ssh_chatter/contexts | 연결별 상태를 캡슐화하는 session_ctx_t 및 관련 구조체 정의. |
data/banner/banner | CHATTER_WELCOME_BANNER로 지정할 수 있는 샘플 환영 배너. |
scripts/install_chatter_service.sh | 바이너리를 빌드하고 /usr/local/bin 아래에 설치하며 systemd 유닛(chatter.service)을 구성하는 편의 설치 스크립트. |
scripts/install_dependencies.sh | Debian/Ubuntu 시스템에서 빌드 필수 패키지를 설치하는 최소 패키지 설치 스크립트. |

main과 최신 상태 유지하기work 브랜치는 대규모 기능이 프로덕션 트래픽을 방해하지 않고 배양될 수 있도록 업스트림 개발과 정기적으로 분기됩니다. main과 동기화할 시점이 되면 최신 트리를 가져와 로컬에서 병합한 후 풀 리퀘스트를 여십시오:
git fetch origin main
git checkout work
git merge --no-ff origin/main
충돌이 발생하면 해당 위치에서 해결하세요(src/host_aggregate.c의 헬퍼 루틴은 이미 main에서 사용하는 레이아웃을 그대로 반영하고 있으므로 일반적으로 병합은 간단합니다). 그리고 결과를 푸시하기 전에 make를 실행하여 빌드가 여전히 성공하는지 확인하세요.
host_snapshot_last_captcha는 가장 최근에 생성된 캡차 프롬프트와 정답을 타임스탬프와 함께 노출하여 외부 클라이언트가 무인 자동화를 대신하여 챌린지를 통과할 수 있게 합니다.scripts/safe_permission.sh는 런타임 데이터 파일(BBS 상태, 투표 상태, 쿨다운 스냅샷, 일반 채터 상태)의 소유권과 모드를 강화합니다. 배포 후에 실행하여 데이터 디렉터리를 ssh-chatter로 제한하고 각 파일이 0600으로 설정되도록 하세요. 실행 전에 명시적 경로를 전달하거나 STATE_ROOT 또는 해당 CHATTER_*_FILE 환경 변수를 내보내서 대상을 재정의할 수 있습니다.CHATTER_SECURITY_AI=on으로 활성화하세요(Gemini의 경우 GEMINI_API_KEY 설정; 데몬은 자동으로 http://127.0.0.1:11434의 로컬 Ollama 엔드포인트로 폴백합니다). 모든 것을 비활성화하려면 CHATTER_SECURITY_FILTER=off로 설정하세요. 모든 제공자가 실패하면 필터는 콘텐츠를 조용히 버리는 대신 대화가 계속 흐르도록 자동으로 비활성화됩니다.CHATTER_AUTO_BAN=on(또는 true/1)으로 설정하거나, 변수를 설정하지 않은 채로 두어 자동 밴 항목을 작성하지 않고 경고와 스로틀링만 유지하세요.CHATTER_PROTECTED_IPS(쉼표로 구분, 기본값 127.0.0.1,::1,192.168.0.1)로 신뢰할 수 있는 인그레스 지점(VPN 출구, 리버스 프록시, localhost)을 표시할 수 있어 긴급 밴이 데몬을 자체 제어 플레인에서 잠그지 않도록 합니다./etc/ssh-chatter/user-files 아래에 있습니다(CHATTER_FILESTORE_PATH로 재정의, 레거시 폴백: CHATTER_FILE_STORAGE_ROOT). 데몬은 필요 시 디렉터리를 생성하고 업로드를 그 안에 제한합니다.scp를 사용합니다. /name.ext를 저장소 트리의 루트로 취급하세요: scp my.zip user@host:/demos/my.zip은 /etc/ssh-chatter/user-files/demos/my.zip에 쓰고, scp user@host:/readme.txt ./는 /etc/ssh-chatter/user-files/readme.txt를 다운로드합니다./filestore 명령을 사용합니다. /filestore는 사용 가능한 파일을 나열하고, /filestore-upload는 rz 세션을 시작하며, /filestore-download <name>은 sz 세션을 시작합니다. ZMODEM 백엔드가 해당 헬퍼를 실행할 수 있도록 서버에 lrzsz(또는 rz/sz를 제공하는 패키지)를 설치하세요./filestore-upload는 선택적 대상을 허용합니다(예: /filestore-upload /kitten/meow.png). SSH-Chatter는 /kitten 디렉터리를 자동으로 생성하고 업로드된 파일을 그곳에 배치하며, 이는 SCP가 user@host:/kitten/meow.png와 같은 경로를 사용하는 방식과 동일합니다.SSH-Chatter는 업링크 뒤의 FidoNet 노드로 실행될 수 있습니다: /fido는 전달되는 에코 영역을 나열하고, 스레드를 보여주며, 사용자가 읽고, 게시하고, 답장할 수 있게 합니다. 메일은 기본적으로 노드 존의 Zone Mail Hour마다 한 번씩 BinkP(CRAM-MD5, 호출 및 응답 모두)를 통해 교환됩니다. 인바운드 패킷과 ArcMail 번들은 중복 검사 및 UTF-8로의 문자셋 변환과 함께 toss됩니다. 모든 FidoNet 데이터는 bbs_state.dat와 분리된 자체 fidonet/ 디렉터리에 저장됩니다. docs/FIDONET.md를 참조하세요.
SSH-Chatter는 아마추어 햄 라디오 중계를 지원합니다.
이는 전역 모스 신호를 표시합니다.
보려면 /morse on, 보내려면 /morse-reply를 사용하세요.
구현은 Binkp 프로토콜 사양을 따릅니다:
프로젝트를 빌드하려면 다음을 갖춘 POSIX 환경이 필요합니다:
gcc 또는 clang)makelibssh 개발 헤더 및 라이브러리 (Debian/Ubuntu에서는 libssh-dev)libcurl 개발 헤더 및 라이브러리 (Debian/Ubuntu에서는 libcurl4-openssl-dev)uchardet 개발 헤더 및 라이브러리 (Debian/Ubuntu에서는 libuchardet-dev)icu (International Components for Unicode) 개발 헤더 및 라이브러리 (Debian/Ubuntu에서는 libicu-dev)lz4 압축 라이브러리 및 개발 헤더 (Debian/Ubuntu에서는 liblz4-dev)libpthread에서 제공)python3-pygments (Tetris 위장 화면을 위한 pygmentize 하이라이터 제공)Debian/Ubuntu에서는 다음 명령으로 의존성을 설치할 수 있습니다: