docs: add deployment guide and user manual for Hy2-only stack

Expand DEPLOY.md, add GUIDE.md and docs index, and cross-link troubleshooting and client-import docs.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
dekun
2026-06-28 00:28:41 +08:00
parent daa76b6b9e
commit 5704ab1a0a
6 changed files with 535 additions and 86 deletions
+47 -36
View File
@@ -8,19 +8,24 @@
| **Flask 面板** | 节点管理、分享链接、在线/流量统计 |
**仓库**https://git.bz121.com/dekun/jiedian.git
**部署路径**`/opt/jiedian`Ubuntu
| 项目 | 值 |
|------|-----|
| VPS IP | `47.76.87.111` |
| 域名 | `66.hyf2.cc` |
| 管理面板 | `http://66.hyf2.cc/<PANEL_PATH>/`(安装时输出,见 `.env` |
> 完整部署步骤见 **[docs/DEPLOY.md](docs/DEPLOY.md)**
**部署路径**`/opt/jiedian`Ubuntu 22.04 / 24.04
---
## 快速部署(Ubuntu VPS
## 文档
| 文档 | 说明 |
|------|------|
| **[docs/DEPLOY.md](docs/DEPLOY.md)** | 部署指南(安全组、安装、升级、验证) |
| **[docs/GUIDE.md](docs/GUIDE.md)** | 使用说明(面板、节点、客户端、维护) |
| **[docs/client-import.md](docs/client-import.md)** | 客户端导入 Hy2 链接 |
| **[docs/troubleshooting.md](docs/troubleshooting.md)** | 故障排查 |
| **[docs/STACK.md](docs/STACK.md)** | 技术架构 |
| **[docs/README.md](docs/README.md)** | 文档索引 |
---
## 快速部署
```bash
ssh root@YOUR_VPS_IP
@@ -32,7 +37,9 @@ cp .env.example .env # 填写 VPS_IP、DOMAIN、ACME_EMAIL
bash scripts/install.sh
```
安装完成后登录面板 **添加节点、复制 Hy2 链接**
安装完成后浏览器打开面板 → 登录 → **添加节点** → 复制 **Hy2 链接** 到 v2rayN / v2rayNG
详细步骤见 **[docs/DEPLOY.md](docs/DEPLOY.md)**。
---
@@ -54,24 +61,6 @@ bash scripts/install.sh
---
## 目录结构
```
/opt/jiedian/
├── .env
├── data/nodes.db
├── panel/ # Flask 管理面板
├── scripts/
│ ├── install.sh
│ ├── uninstall.sh
│ ├── remove-vless.sh # 旧版双栈 VPS 停用 VLESS
│ ├── generate-keys.sh # 生成面板密码
│ └── render-server.py # 生成 sing-box Hy2 配置
└── docs/
```
---
## 端口与防火墙
| 端口 | 协议 | 用途 |
@@ -80,22 +69,44 @@ bash scripts/install.sh
| 80 | TCP | HTTPACME + 管理面板) |
| 84438499 | UDP | Hysteria2(每节点递增) |
阿里云安全组需放行 **84438499/UDP**
厂商安全组需放行 **84438499/UDP**
---
## 常用运维
## 常用命令
```bash
# 面板地址
grep PANEL_PATH /opt/jiedian/.env
# 服务状态
systemctl status sing-box jiedian-panel
# 增删节点后手动重载
python3 /opt/jiedian/scripts/render-server.py
systemctl restart sing-box
# 更新代码
cd /opt/jiedian && git pull
python3 scripts/render-server.py
systemctl restart sing-box jiedian-panel
# 从旧版(含 VLESS)迁移到仅 Hy2
bash /opt/jiedian/scripts/remove-vless.sh
# 从旧版(含 VLESS)迁移
bash scripts/remove-vless.sh
```
---
## 目录结构
```
/opt/jiedian/
├── .env # VPS / 域名 / 面板账号
├── data/nodes.db # 节点数据库
├── panel/ # Flask 管理面板
├── scripts/
│ ├── install.sh # 一键部署
│ ├── uninstall.sh # 卸载
│ ├── remove-vless.sh # 旧版停用 VLESS
│ ├── generate-keys.sh # 生成/重置面板密码
│ └── render-server.py # 生成 sing-box 配置
└── docs/ # 文档
```
---