jiedian — VPS 自建节点

个人/家庭自用的 Hysteria2 方案，带 Web 管理面板。

组件	职责
sing-box	Hysteria2（UDP 8443+，每节点独立端口）
Flask 面板	节点管理、分享链接、在线/流量统计

仓库：https://git.bz121.com/dekun/jiedian.git
部署路径：/opt/jiedian（Ubuntu 22.04 / 24.04）

---

文档

文档	说明
docs/DEPLOY.md	部署指南（安全组、安装、升级、验证）
docs/GUIDE.md	使用说明（面板、节点、客户端、维护）
docs/client-import.md	客户端导入 Hy2 链接
docs/troubleshooting.md	故障排查
docs/STACK.md	技术架构
docs/README.md	文档索引

---

快速部署

ssh root@YOUR_VPS_IP

apt update && apt install -y git
git clone https://git.bz121.com/dekun/jiedian.git /opt/jiedian
cd /opt/jiedian
cp .env.example .env    # 填写 VPS_IP、DOMAIN、ACME_EMAIL
bash scripts/install.sh

安装完成后浏览器打开面板 → 登录 → 添加节点 → 复制 Hy2 链接 到 v2rayN / v2rayNG。

详细步骤见 docs/DEPLOY.md。

---

架构

浏览器 ──► Nginx:443 HTTPS/<PANEL_PATH>/ ──► Web 管理面板
         └─► Nginx:80（ACME 验证 + 跳转 HTTPS）
                              │
                              ▼
                    render-server.py
                              │
                              ▼
                    sing-box :8443+
                    Hysteria2（每节点一端口）

客户端 (Win/iOS/Android)
    └─ UDP 8443+ ► sing-box Hysteria2

---

端口与防火墙

端口	协议	用途
22	TCP	SSH
80	TCP	HTTP（ACME 证书验证 + 跳转 HTTPS）
443	TCP	HTTPS 管理面板
8443–8499	UDP	Hysteria2（每节点递增）

云厂商安全组需放行 443/TCP 与 8443–8499/UDP。

---

常用命令

# 面板地址
grep PANEL_PATH /opt/jiedian/.env

# 服务状态
systemctl status sing-box jiedian-panel

# 更新代码
cd /opt/jiedian && git pull
python3 scripts/render-server.py
systemctl restart sing-box jiedian-panel

# 从旧版（含 VLESS）迁移
bash scripts/remove-vless.sh

---

目录结构

/opt/jiedian/
├── .env                 # VPS / 域名 / 面板账号
├── data/nodes.db        # 节点数据库
├── panel/               # Flask 管理面板
├── scripts/
│   ├── install.sh       # 一键部署
│   ├── uninstall.sh     # 卸载
│   ├── remove-vless.sh       # 旧版停用 VLESS
│   ├── enable-panel-https.sh # 启用 HTTPS 面板
│   ├── generate-keys.sh # 生成/重置面板密码
│   └── render-server.py # 生成 sing-box 配置
└── docs/                # 文档

---

免责声明

本项目仅供学习网络技术使用。请遵守当地法律法规。