58 lines
4.2 KiB
JSON
58 lines
4.2 KiB
JSON
|
{
|
|||
|
|
"_comment": "IM 线 · 第 12 棒 —— 外部连接层的参考部署配置（Centrifugo v6）。",
|
|||
|
|
"_comment2": "键位以 E-2 实测可用的 /root/im-e2/config.json 为准（v6 已把密钥挪进 client.token / http_api）。",
|
|||
|
|
"_comment3": "凭据一律用环境变量或密钥文件注入，⛔ 不要把这个文件里的占位串当真值提交到生产。",
|
|||
|
|
"_comment4": "package.json 的运行时依赖**不含**本组件 —— 它是外部进程，不在 Node 依赖树里。",
|
|||
|
|
|
|||
|
|
"client": {
|
|||
|
|
"allowed_origins": ["*"],
|
|||
|
|
"_comment_ping": "🔻 第 15 棒部署实测修正：原值 `0s` 会让客户端保活帧被判 bad request —— 没有待回的 ping 时，协议里的 `{}` 是**空命令**而非 pong。三向实测（47 就地部署，240 连接）：off（从不回帧）⇒ 80/80 被断开（code 3012 `no pong`）；conn（**按每连接**收到 ping 才回 `{}`）⇒ **掉 0**；global（整进程一个节拍器给所有连接发 `{}`）⇒ 80/80 被断开（code 3501 `bad request`）。⇒ 网关**自己发协议级 ping**，客户端只需按连接回 `{}`。",
|
|||
|
|
"ping_interval": "25s",
|
|||
|
|
"token": {
|
|||
|
|
"hmac_secret_key": "REPLACE_WITH_ROTATED_SECRET"
|
|||
|
|
}
|
|||
|
|
},
|
|||
|
|
|
|||
|
|
"http_api": {
|
|||
|
|
"key": "REPLACE_WITH_ROTATED_SECRET"
|
|||
|
|
},
|
|||
|
|
|
|||
|
|
"channel": {
|
|||
|
|
"_comment_proxy": "🔻 第 16 棒新增（选型单 §十六）：**订阅回检** —— 客户端订某个频道时，**由平台**回答「这个用户能不能读这个房」。⛔ 不加这一段的话，连接票据只回答「你是谁」，任何登录用户都能订 `im:<任意房间>` 并收到该房实时消息 ⇒ 「成员表判读房」这条会被破掉。`endpoint` 指平台回检面（回环即可：网关与平台同机）；头里的密钥必须与 `http_api.key` / `client.token.hmac_secret_key` / 平台 drop-in 的 `DSH_IM_GATEWAY_KEY` **四者同值**。⚠️ 这个共享密钥必须放 `http.static_headers`（**固定值头**），⛔ **不能**放 `http_headers` —— `http_headers` 是 `array[string]` 且元素**只是头名**（转发客户端带来的同名头）；拿它塞 `\"Name: value\"` 会变成「带名无值」，平台侧取不到密钥 ⇒ 回检 401（v6.9.6 实测 `error proxying subscribe: unexpected HTTP status code: 401`）。",
|
|||
|
|
"proxy": {
|
|||
|
|
"subscribe": {
|
|||
|
|
"endpoint": "http://127.0.0.1:3080/api/im/gateway/subscribe",
|
|||
|
|
"timeout": "2s",
|
|||
|
|
"http": {
|
|||
|
|
"static_headers": { "X-DSH-IM-Gateway-Key": "REPLACE_WITH_ROTATED_SECRET" }
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
},
|
|||
|
|
"namespaces": [
|
|||
|
|
{
|
|||
|
|
"_comment": "命名空间 = 频道名里第一个 `:` 之前的部分 ⇒ 配合 DSH_IM_GATEWAY_CHANNEL_PREFIX=im: 使用。",
|
|||
|
|
"name": "im",
|
|||
|
|
"_comment2": "🔻 第 16 棒修正：`allow_subscribe_for_client` 只是「已认证连接可以不带 token 订阅」，**不是**权限判定；真正的授权走 `subscribe_proxy_enabled`（平台判成员表）或平台签发的订阅票据（带 token 时 token 优先，代理不参与）。两者都由**平台**裁决 ⇒ 保留 `true`。",
|
|||
|
|
"allow_subscribe_for_client": true,
|
|||
|
|
"_comment6": "🔻 第 16 棒新增：打开订阅回检。⚠️ 它不是「可选优化」—— 关掉它，任何登录用户都能订任意 `im:*` 频道。",
|
|||
|
|
"subscribe_proxy_enabled": true,
|
|||
|
|
"_comment3": "presence / join_leave 是**在线态取数**的候选来源（第 15 棒已接线平台侧；⚠️ 网关侧尚无 join/leave 回调调用方，见 §六 已知限）。",
|
|||
|
|
"presence": true,
|
|||
|
|
"join_leave": true,
|
|||
|
|
"_comment4": "history 只作断线**加速**，⛔ 不是游标权威 —— 权威在平台 GET /api/im/rooms/:id/messages。",
|
|||
|
|
"history_size": 100,
|
|||
|
|
"history_ttl": "300s",
|
|||
|
|
"_comment5": "🔻 第 15 棒修正（原文：⛔ 不启用服务端 WS ping）：网关**要**发协议级 ping（见上方 `_comment_ping`）；「不发 WS ping」这条实测本身没错（`wsPingRecv=0` 数的是 **WS 控制帧**），错的是由它推出的结论 —— 协议级 ping 照样存在，且客户端必须按连接回 `{}`。",
|
|||
|
|
"force_push_join_leave": false
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
},
|
|||
|
|
|
|||
|
|
"prometheus": {
|
|||
|
|
"enabled": true
|
|||
|
|
},
|
|||
|
|
|
|||
|
|
"log": {
|
|||
|
|
"level": "info"
|
|||
|
|
}
|
|||
|
|
}
|