Files
jiedian/docs/DEPLOY.md
T
dekun 6edba863b5 fix: use Clash API only for traffic stats on stock sing-box builds
Official sing-box binaries lack v2ray_api, so drop that config and grpcio
and track per-node traffic from Clash connection stats instead.

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

2.8 KiB
Raw Blame History

Ubuntu 部署指南

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

项目
VPS IP 47.76.87.111
域名 66.hyf2.cc
管理面板 http://66.hyf2.cc/<PANEL_PATH>/
部署目录 /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/UDP无需 8444


一键部署

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

安装结束会输出:

管理面板: http://66.hyf2.cc/jiedian-xxxx/
面板路径: jiedian-xxxx (见 .env 中 PANEL_PATH
用户名:   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 80 端口子路径反向代理管理面板

管理面板功能

功能 说明
登录 .envPANEL_USERNAME / PANEL_PASSWORD
添加节点 自动生成 UUID + Hy2 密码,更新 sing-box
复制链接 VLESS Reality + Hysteria2 分享链接
删除节点 至少保留 1 个节点
连接状态 在线/离线、当前连接数(Clash API)
流量统计 实时速率 + 累计上下行(Clash API 连接统计)

部署后验证

systemctl status sing-box jiedian-panel
ss -tlnp | grep -E '80|443|5080'
ss -ulnp | grep 8443
PANEL_PATH=$(grep ^PANEL_PATH= /opt/jiedian/.env | cut -d= -f2)
curl -I "http://66.hyf2.cc/${PANEL_PATH}/login"

故障排查

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

更多见 troubleshooting.md