dekun
5704ab1a0a
Expand DEPLOY.md, add GUIDE.md and docs index, and cross-link troubleshooting and client-import docs. Co-authored-by: Cursor <cursoragent@cursor.com>
94 lines
2.3 KiB
Markdown
94 lines
2.3 KiB
Markdown
# 运维与故障排查
|
||
|
||
## 服务检查
|
||
|
||
```bash
|
||
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…） |
|
||
|
||
### 面板打不开 / Invalid URL
|
||
|
||
- 使用 **`http://域名/PANEL_PATH/`**，不要用 `https://`
|
||
- 面板在 **80** 端口，不是 443
|
||
- 域名建议 **关闭 CDN**，仅 DNS 解析到 VPS
|
||
|
||
```bash
|
||
grep PANEL_PATH /opt/jiedian/.env
|
||
curl -I "http://$(grep ^DOMAIN= /opt/jiedian/.env | cut -d= -f2)/$(grep ^PANEL_PATH= /opt/jiedian/.env | cut -d= -f2)/login"
|
||
```
|
||
|
||
### 多节点全部显示离线
|
||
|
||
1. 更新并重载：
|
||
|
||
```bash
|
||
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 秒** 刷新；新版前端会自动重试。
|
||
|
||
### 忘记面板密码
|
||
|
||
```bash
|
||
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 |
|
||
| 8443–8499 | UDP | Hysteria2 |
|
||
|
||
---
|
||
|
||
## 相关文档
|
||
|
||
- 部署：[DEPLOY.md](DEPLOY.md)
|
||
- 使用：[GUIDE.md](GUIDE.md)
|
||
- 客户端：[client-import.md](client-import.md)
|