
モダンCで書かれたssh-chat

汎用BBSソフトウェア
SSH-Chatterは、Go製のssh-chatサーバーをC言語で再実装することから始まりました。オリジナルの挙動を踏襲しつつ拡張を加え、モダンなCのパターンと小さくテスト可能なコアを採用しています。サーバーはSSH/TELNET接続を待ち受け、認証されたすべてのユーザーを共有チャットルームに配置し、Goのリファレンス実装と同じコマンド群を提供します。
Cを理解するのにどうしてそんなに時間がかかるか知っていますか?それは本能だからです。
/rss list、/rss read <tag> でアクセスでき、さらに /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まで)、親の著者に通知され、返信先のコメントが削除されると1レベル上に移動します。返信リンクは bbs_state_threads.dat サイドカーに保存されるため、bbs_state.dat はv3レイアウトを維持します。/bbs プレフィックスなしでコマンドを自動ルーティングします。/bbs post art <title>(または /asciiart bbs <title>、あるいは art ボード上で単に post)で art ボードのアートコンポーザーが開きます。貼り付けられたSGRカラー(16/256/トゥルーカラー)は保持され、各行の後にリセットを入れて行ごとに再生されます。カーソル移動、画面クリア、OSC/DCS文字列、ターミナルクエリは保存前と表示時に再度除去されます。/asciiart ライブコンポーザーで、640行の制限、IPごとの10分間のクールダウン、複数行出力、Ctrl+Aでキャンセル、Ctrl+Sまたはロケール対応の >/__ARTWORK_END> デフォルトで送信するキーボードショートカットを備えています。/birthday で誕生日を登録し、/grant <ip> でLANオペレーターがアドレスごとに権限を委任でき、/revoke <ip> でトップLAN管理者が権限を回収できます。/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 は、直近に生成された 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)を設定するか、変数を未設定のままにして自動 BAN エントリを書き込まずに警告とスロットリングを維持します。CHATTER_PROTECTED_IPS(カンマ区切り、デフォルトは 127.0.0.1,::1,192.168.0.1)で信頼されたイングレスポイント(VPN 出口、リバースプロキシ、localhost)をマークできるため、緊急 BAN がデーモンを自身のコントロールプレーンから締め出すことはありません。/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ごとに1回、BinkP(CRAM-MD5、発信と応答の両方)を介して交換されます。受信したパケットとArcMailバンドルは、重複チェックとUTF-8への文字コード変換を行って処理されます。すべての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では、依存関係を次のコマンドでインストールできます: