🔌 WebSocket 与旧配置

优先选择 Redis 通信。WS 适合已有单代理环境继续兼容，不取消基础 Redis 依赖。

代理配置

# 明确使用 ws，避免与新版模板 redis 混用。
transport = "ws"
# ACK 超时，默认 1500 毫秒，允许 100–10000。
handoff-timeout-ms = 1500

[ws]
# 示例内网地址，请替换；默认监听 0.0.0.0，生产应限制入口。
host = "10.0.0.1"
port = 8765
# 示例占位，必须改为长随机密钥，代理与子服完全一致。
secret = "替换为长随机密钥"
# 默认模板 lobby、survival；空列表表示不限制，生产显式列出。
allowed-servers = ["lobby", "survival"]

子服配置

# 默认 false；开启后才建立通道。
enabled: true
transport: ws
# 名称必须对应代理里的子服名，并在各子服间唯一。
server-name: 'survival'
ws:
  # 代理内网 IP，不要照抄 localhost 到其他机器。
  url: 'ws://10.0.0.1:8765/invsync'
  secret: '替换为长随机密钥'
# 默认留空，自动检测。
player-data-folder: ''

只允许可信子服 IP 访问 WS 端口，密钥不是 TLS 加密，ws:// 应走可信内网。避免公网明文传输。

旧配置兼容

• 缺 transport 时保留 WS，不代表自动启用 Redis。
• 旧 ws.server-name 在顶层 server-name 留空时可用。
• 代理旧顶层 WS 字段保留兼容，新配置优先使用 [ws]。
• 更换方式时代理和子服同一次维护一起改，重启后验证。

多代理

每台子服的 WS 客户端只连一个地址，不能把单地址配置当成多代理覆盖。需要多个代理进入同一批子服时，迁移到Redis 方式。