dekunjiedian — 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 | 文档索引 |
部署前准备
| # | 项目 | 要求 |
|---|---|---|
| 1 | VPS | Ubuntu 22.04 / 24.04，root 权限 |
| 2 | 域名 | A 记录指向 VPS 公网 IP |
| 3 | 安全组 | 放行下方端口 |
需要开放的端口
| 端口 | 协议 | 用途 |
|---|---|---|
| 22 | TCP | SSH |
| 80 | TCP | ACME 证书验证 |
| 443 | TCP | HTTPS 管理面板 |
| 8443–8499 | UDP | Hysteria2 代理（多节点递增） |
Hy2 走 UDP，安全组必须放行 8443–8499/UDP 整段。详细说明见 docs/DEPLOY.md。
快速部署
SSH 登录新 VPS 后，一条命令完成部署（自动 clone，交互输入域名/邮箱/账号）：
curl -fsSL https://git.bz121.com/dekun/jiedian/raw/main/scripts/bootstrap.sh | bash
安装完成后会输出面板地址、用户名和密码。浏览器打开 → 登录 → 添加节点 → 复制 Hy2 链接 到 v2rayN / v2rayNG。
架构
浏览器 ──► 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
常用命令
# 面板地址
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
# 重置面板密码
bash scripts/generate-keys.sh
目录结构
/opt/jiedian/
├── .env # VPS / 域名 / 面板账号
├── data/nodes.db # 节点数据库
├── panel/ # Flask 管理面板
├── scripts/
│ ├── bootstrap.sh # 一键部署入口（自动 clone + 交互配置）
│ ├── install.sh # 核心安装逻辑
│ ├── uninstall.sh # 卸载
│ ├── generate-keys.sh # 重置面板密码
│ └── render-server.py # 生成 sing-box 配置
└── docs/ # 文档
免责声明
本项目仅供学习网络技术使用。请遵守当地法律法规。