4b3f6a1de221a3d1d8f9d2251c87e2cd726b1b6d
Document new install flow, ports, migration script, and v2rayN Reality settings across README and docs/. Co-authored-by: Cursor <cursoragent@cursor.com>
jiedian — VPS 自建节点
个人/家庭自用的 VLESS + Reality(主力) + Hysteria2(备用) 双栈方案,带 Web 管理面板。
| 组件 | 职责 |
|---|---|
| Xray | VLESS + Reality(TCP 443) |
| sing-box | Hysteria2(UDP 8443+,每节点独立端口) |
| 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
快速部署(Ubuntu VPS)
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
安装完成后会显示面板地址、用户名和密码。登录面板即可 添加节点、复制分享链接。
架构
浏览器 ──► Nginx:80/<PANEL_PATH>/ ──► Web 管理面板(登录、添加节点)
│
▼
render-server.py + render-xray.py
│
┌───────────────┴───────────────┐
▼ ▼
Xray :443 sing-box :8443+
VLESS + Reality Hysteria2(每节点一端口)
客户端 (Win/iOS/Android)
├─ TCP 443 ──► Xray VLESS+Reality
└─ UDP 8443+ ► sing-box Hysteria2
VLESS Reality 使用 Xray 服务端,与 v2rayN / v2rayNG(Xray 核心)兼容性最好。Hy2 仍由 sing-box 承载。
目录结构
/opt/jiedian/
├── .env # VPS / Reality / 面板账号配置
├── data/nodes.db # 节点数据库(安装后生成)
├── panel/ # Web 管理面板(Flask)
├── scripts/
│ ├── install.sh # 一键部署(Xray + sing-box + 面板)
│ ├── uninstall.sh # 卸载后重装
│ ├── generate-keys.sh # 生成 Reality 密钥与面板密码
│ ├── render-xray.py # 生成 Xray VLESS Reality 配置
│ ├── render-server.py # 生成 sing-box Hy2 配置
│ ├── migrate-xray-reality.sh # 旧版 sing-box Reality 迁移到 Xray
│ └── verify-reality.sh # Reality 密钥与配置诊断
└── docs/
├── DEPLOY.md
├── client-import.md
└── troubleshooting.md
端口与防火墙
| 端口 | 协议 | 用途 |
|---|---|---|
| 22 | TCP | SSH |
| 80 | TCP | HTTP(ACME 验证 + 管理面板) |
| 443 | TCP | VLESS + Reality(Xray) |
| 8443–8499 | UDP | Hysteria2(sing-box,每节点递增) |
阿里云安全组需放行 8443–8499/UDP,不只 8443。
常用运维
# 面板地址
grep PANEL_PATH /opt/jiedian/.env
# 服务状态
systemctl status xray sing-box jiedian-panel
# Reality 诊断
bash /opt/jiedian/scripts/verify-reality.sh
# 增删节点后手动重载配置
python3 /opt/jiedian/scripts/render-xray.py
python3 /opt/jiedian/scripts/render-server.py
systemctl restart xray sing-box
# 卸载后干净重装
bash scripts/uninstall.sh
bash scripts/generate-keys.sh # 可选:重置密钥与面板密码
bash scripts/install.sh
防墙要点
- 不要公开分享节点链接
- Reality SNI 使用
www.microsoft.com(或.env中REALITY_SERVER_NAME),不要用域名66.hyf2.cc - 客户端开启 uTLS / chrome 指纹;v2rayN 中 SpiderX 填
/ - 面板路径与密码请妥善保管,安装后可在
.env查看PANEL_PATH/PANEL_PASSWORD
免责声明
本项目仅供学习网络技术使用。请遵守当地法律法规。
Description
Languages
Python
47.2%
Shell
23.4%
JavaScript
13.1%
HTML
8.5%
CSS
7.8%