fix: multi-node online stats, per-node Hy2 ports, and panel reload stability

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/troubleshooting.md

@@ -74,6 +74,26 @@ systemctl restart jiedian-panel
 
 若域名在阿里云/Cloudflare 开了 **CDN 代理**，建议对管理域名 **关闭 CDN**（仅 DNS 解析到 VPS），否则 80 端口回源也可能异常。
 
+### 多节点全部显示离线
+
+sing-box 的 Clash API **不会在连接详情里返回用户 UUID**（单节点时面板用兜底逻辑，多节点必须按 inbound 区分）。
+
+升级后每个节点有 **独立 Hysteria2 端口**（按节点 ID 排序：8443、8444、8445…）。请：
+
+1. 更新代码并重新生成配置：
+   ```bash
+   cd /opt/jiedian && git pull
+   python3 scripts/render-server.py
+   systemctl restart sing-box jiedian-panel
+   ```
+2. **阿里云安全组** 放行 `8443-8499/UDP`（不只 8443）
+3. 在面板 **重新复制** 各节点的 Hysteria2 链接（端口可能已变）
+4. VLESS 多用户在线状态依赖 sing-box 日志，需保持 `log.level` 为 `info`（render-server 已默认）
+
+### 添加/删除节点后白屏或 503
+
+创建节点会触发 sing-box 重启，页面刷新时可能短暂不可用。新版前端会自动重试；若仍白屏，等 10 秒后手动刷新 `http://域名/面板路径/`。
+
 ### 在线节点 / 统计一直显示「检测中」
 
 页面初始状态是「检测中」。若长期不变且数字一直是 `-`，说明 **前端 JS 或 `/api/stats` 请求失败**（常见：静态资源路径缺少 `PANEL_PATH` 前缀）。
@@ -290,7 +310,7 @@ Hysteria2 仍需单独部署（或使用 sing-box 仅跑 Hy2 inbound）。
 | 22 | TCP | SSH | 是 |
 | 80 | TCP | ACME 验证 + **管理面板** | 是 |
 | 443 | TCP | VLESS + Reality | 是 |
-| 8443 | UDP | Hysteria2 | 是 |
+| 8443-8499 | UDP | Hysteria2（每节点递增端口） | 是 |
 | ~~8444~~ | ~~TCP~~ | ~~旧版面板的独立 HTTPS~~ | **已废弃，无需放行** |
 
 ## 安全建议