Files
jiedian/docs/DEPLOY.md
T
dekun bccf6cfdce feat: add web admin panel for node management
Add Flask panel with login, add/delete nodes, and share link copy.
Generate sing-box config from SQLite; add uninstall script and clean install flow.
Panel served at https://DOMAIN:8444 via nginx.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-16 09:10:19 +08:00

2.5 KiB

Ubuntu 部署指南

仓库:https://git.bz121.com/dekun/jiedian.git

项目
VPS IP 47.76.87.111
域名 66.hyf2.cc
管理面板 https://66.hyf2.cc:8444
部署目录 /opt/jiedian
系统 Ubuntu 22.04 / 24.04

部署前准备

1. DNS 解析

66.hyf2.cc  →  47.76.87.111

验证:

dig +short A 66.hyf2.cc

2. 阿里云安全组

放行:2280443/TCP8443/UDP8444/TCP


一键部署

apt update && apt install -y git
git clone https://git.bz121.com/dekun/jiedian.git /opt/jiedian
cd /opt/jiedian
bash scripts/install.sh

安装结束会输出:

管理面板: https://66.hyf2.cc:8444
用户名:   admin
密码:     xxxxx

浏览器打开面板 → 登录 → 添加节点 → 复制 VLESS / Hysteria2 链接到客户端。


卸载后重装(推荐流程)

若之前部署混乱,先卸载再装:

cd /opt/jiedian
git pull
bash scripts/uninstall.sh
bash scripts/generate-keys.sh    # 重新生成 Reality 密钥与面板密码
bash scripts/install.sh

uninstall.sh 会停止服务并清理配置,保留 /opt/jiedian 代码与 .env 基础字段。


安装脚本做了什么

  1. 安装 sing-box、nginx、Python 面板依赖
  2. 防火墙放行 22/80/443/8443/8444
  3. acme.sh 申请 66.hyf2.cc 证书
  4. 初始化 SQLite 节点库 + 默认管理员
  5. 生成 sing-box 配置并启动服务
  6. Nginx 8444 端口提供 HTTPS 管理面板

管理面板功能

功能 说明
登录 .envPANEL_USERNAME / PANEL_PASSWORD
添加节点 自动生成 UUID + Hy2 密码,更新 sing-box
复制链接 VLESS Reality + Hysteria2 分享链接
删除节点 至少保留 1 个节点

部署后验证

systemctl status sing-box jiedian-panel
ss -tlnp | grep -E '443|8444'
ss -ulnp | grep 8443
curl -k -I https://66.hyf2.cc:8444/login

故障排查

问题 处理
apt 锁被占用 等待自动更新结束,或 bash scripts/install.sh 会自动等待
sing-box 443 被占用 ss -tlnp | grep 443,停止占用进程后重装
忘记面板密码 grep PANEL_PASSWORD /opt/jiedian/.env 或重新 generate-keys.sh
SSH 主机密钥变更 重装系统后本地执行 ssh-keygen -R 47.76.87.111

更多见 troubleshooting.md