jiedian/docs/troubleshooting.md

运维与故障排查

服务检查

systemctl is-active sing-box jiedian-panel nginx
sing-box check -c /etc/sing-box/config.json
ss -ulnp | grep 8443      # 默认 8443，多节点还有 8444…
ss -tlnp | grep :80       # Nginx 面板

---

常见问题

Hy2 连不上 / 延迟 -1

检查顺序：

1. 安全组 是否放行 8443–8499/UDP（不只 8443）
2. 域名 是否解析到 VPS IP：dig +short A 你的域名
3. 证书 是否存在：ls /etc/sing-box/certs/fullchain.pem
4. 从面板 重新复制 Hy2 链接（增删节点后端口会变）
5. 重启 sing-box：systemctl restart sing-box

客户端核对：

项	正确值
地址	域名（如 66.hyf2.cc），不是 IP
SNI	与域名相同
端口	面板显示的端口（8443 / 8444…）

面板打不开

• 使用 https://域名/PANEL_PATH/ 登录（推荐）
• 输入 http:// 也会自动跳转到 HTTPS
• 安全组需放行 443/TCP 与 80/TCP（ACME 续期）

grep PANEL_PATH /opt/jiedian/.env
curl -Ik "https://$(grep ^DOMAIN= /opt/jiedian/.env | cut -d= -f2)/$(grep ^PANEL_PATH= /opt/jiedian/.env | cut -d= -f2)/login"

旧 VPS 升级 HTTPS 面板

cd /opt/jiedian && git pull
sudo bash scripts/enable-panel-https.sh
systemctl restart jiedian-panel

多节点全部显示离线

1. 更新并重载：

cd /opt/jiedian && git pull
python3 scripts/render-server.py
systemctl restart sing-box jiedian-panel

2. 安全组放行 8443–8499/UDP
3. 各节点 重新复制 Hy2 链接（第二节点端口 8444…）

添加/删除节点后白屏或 503

创建/删除节点会后台重启 sing-box，等 5–10 秒 刷新；新版前端会自动重试。

忘记面板密码

grep PANEL_PASSWORD /opt/jiedian/.env
# 或
bash /opt/jiedian/scripts/generate-keys.sh
systemctl restart jiedian-panel

从旧版 VLESS 迁移后客户端仍连不上

1. VPS 执行：bash /opt/jiedian/scripts/remove-vless.sh
2. 客户端 删除所有 VLESS 节点
3. 从面板 仅导入 Hy2 链接

---

端口一览

端口	协议	用途
22	TCP	SSH
80	TCP	ACME 续期
443	TCP	HTTPS 管理面板
8443–8499	UDP	Hysteria2

---

相关文档

• 部署：DEPLOY.md
• 使用：GUIDE.md
• 客户端：client-import.md