From 7857492ebd34ceb509045596c56a11bf2c4c5a44 Mon Sep 17 00:00:00 2001 From: agent-sync Date: Tue, 17 Nov 2026 19:53:01 +0900 Subject: [PATCH] docs: use general wording for the public and internal listeners MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 内部のネットワーク構成 (Cloudflare Tunnel への言及) を、「外に公開する側」「外へ公開する経路」という一般的な表現に置き換えます。設計の内容 (公開の待受と内部専用の待受を分ける) は変わりません。 --- docs/design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/design.md b/docs/design.md index dd3d343..a52c7e9 100644 --- a/docs/design.md +++ b/docs/design.md @@ -70,7 +70,7 @@ URL を足すには、機能のモジュールにハンドラーを書き、`src - **Dynmap の DB を読む**: TiDB の `dynmap` データベースを読みます (地図の表示のための読み取り)。**発行するのは SELECT だけ**で、文は `src/map/store.rs` の定数に固定してあります (値は必ず bind)。接続は `MAP_DB_*` で決め、`MAP_DB_HOST` が無ければ地図 API は動きません (`/map/v1/*` は 404)。本番では読み取り専用の専用利用者を使います - **ドライバは sqlx** (`mysql` と `runtime-tokio` だけ。TLS なし)。純 Rust で、OpenSSL も zlib も依存に入らないので、musl の静的リンク (scratch イメージ) のままビルドできます。`mysql_async` は zlib (`libz-sys`) の C のビルドを引くので選びませんでした。接続は最初の問い合わせまで張らず、プールは 16 本、1 つの問い合わせは 30 秒で切ります - **キャッシュ**: HTTP の各ハンドラーは毎回 DB を引きます。HTTP のキャッシュは前段の入り口のプロキシが担います。WebSocket のハブだけが、ワールドごとに 1 秒に 1 度だけ DB を読み、`timestamp` が変わったときだけ全員へ送ります (ワールドの一覧は 30 秒ごとに読み直し、知らない名前では DB を読みません) -- **公開の待受と内部専用の待受を分ける**: 公開の待受 (`PORT`。Tunnel の先) は `/map/v1/*` だけを受け、`/live/*` は 404 です。dynmap-live からの位置 (`/live/plugin`) は、`MAP_LIVE_ADDR` で決めた内部専用の待受でだけ受けます (決めなければ待受を起動しません)。`X-Toro-Token` を SHA-256 にして定数時間で比べ、`MAP_LIVE_TOKEN` が空ならどんな値も通しません。この待受を Tunnel の規則に載せないでください +- **公開の待受と内部専用の待受を分ける**: 公開の待受 (`PORT`。外に公開する側) は `/map/v1/*` だけを受け、`/live/*` は 404 です。dynmap-live からの位置 (`/live/plugin`) は、`MAP_LIVE_ADDR` で決めた内部専用の待受でだけ受けます (決めなければ待受を起動しません)。`X-Toro-Token` を SHA-256 にして定数時間で比べ、`MAP_LIVE_TOKEN` が空ならどんな値も通しません。この待受を外へ公開する経路に載せないでください - **WebSocket は、ボディを読む前に分ける**: ふつうの要求は本文を全部読む作りなので、`/map/v1/ws` の Upgrade は `src/routes.rs` の入り口で先に分けます。同時処理の枠 (256) は使わず、接続数は別に数えます (ブラウザ 2048、`/live/plugin` 8)。1 つのメッセージは 256 KiB まで、ブラウザからの購読は 512 文字までで、2 秒に 5 通を超えたものは無視します。Origin は空、`localhost`、`127.0.0.1`、`*.torosaba.net` だけを許し、他は接続のあとで 1008 で閉じます - **3D (BlueMap) は含みません**: `/map/v1/ws` の `{"bluemap":""}` は 3D 用で、この段階では未対応です (黙って無視します)。3D の動的な側は、あとの段階で `src/map/` の隣に足します - **JavaScript と同じ結果にする道具** (`src/map/js.rs`): `Number()`、`decodeURI`、`decodeURIComponent`、`Date#toUTCString`、`JSON.stringify` の数の書き方を、移管前と同じに再現しています (パスの数字やワールド名の解き方で、同じ入力が同じ応答になるように)