Files

T

dekun 4b3f6a1de2 docs: update deployment and troubleshooting for Xray + sing-box split

Document new install flow, ports, migration script, and v2rayN Reality settings across README and docs/.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-16 12:03:03 +08:00

5.7 KiB

Raw Blame History

Ubuntu 部署指南

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

项目	值
VPS IP	你的 VPS 公网 IP
域名	已解析到 VPS 的域名
管理面板	`http://域名/<PANEL_PATH>/`（必须 http，不要用 https）
部署目录	`/opt/jiedian`
系统	Ubuntu 22.04 / 24.04

部署前准备

1. DNS 解析

将域名 A 记录 指向 VPS 公网 IP（用于 Hy2 证书与面板访问）：

your.domain.com  →  YOUR_VPS_IP

验证：

dig +short A your.domain.com
# 应返回 VPS IP

2. 阿里云 / 云厂商安全组

端口	协议	用途	必须
22	TCP	SSH	是
80	TCP	ACME + 管理面板	是
443	TCP	VLESS Reality（Xray）	是
8443–8499	UDP	Hysteria2（sing-box，多节点递增）	是

注意：多节点时 Hy2 端口为 8443、8444、8445…，安全组需放行 8443–8499/UDP，不能只开 8443。

3. 填写 `.env`（首次部署）

cd /opt/jiedian
cp .env.example .env
nano .env

至少填写：

变量	说明
`VPS_IP`	VPS 公网 IP
`DOMAIN`	域名（Hy2 与证书用）
`ACME_EMAIL`	Let's Encrypt 邮箱
`REALITY_SERVER_NAME`	Reality 伪装 SNI，默认 `www.microsoft.com`

REALITY_* 密钥、PANEL_PASSWORD、PANEL_PATH 可在安装时由 generate-keys.sh / install.sh 自动生成。

一键部署（新机器）

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

安装结束会输出类似：

管理面板: http://your.domain.com/jiedian-xxxx/
面板路径: jiedian-xxxx （见 .env 中 PANEL_PATH）
用户名:   admin
密码:     xxxxx

浏览器打开面板 → 登录 → 添加节点（或使用默认节点）→ 复制 VLESS / Hysteria2 链接到客户端。

安装脚本做了什么

安装 sing-box（Hysteria2）、Xray（VLESS Reality）、nginx、Python 面板依赖
UFW 放行 22/80/443 TCP 与 8443–8499 UDP
acme.sh 为 DOMAIN 申请 TLS 证书（供 Hy2 使用）
初始化 SQLite 节点库 + 默认管理员
render-server.py → /etc/sing-box/config.json（仅 Hy2 inbound）
render-xray.py → /usr/local/etc/xray/config.json（VLESS Reality 443）
启动 xray、sing-box、jiedian-panel
Nginx 80 端口子路径反向代理管理面板

服务与端口对照

服务	端口	协议	说明
xray	443	TCP	VLESS + Reality，所有节点 UUID 共用
sing-box	8443+	UDP	Hysteria2，每节点独立端口（按 ID 排序）
jiedian-panel	5080	TCP	仅本机，经 Nginx 80 对外
nginx	80	TCP	ACME + 面板

查看监听：

ss -tlnp | grep -E ':443|:80|:5080'
ss -ulnp | grep 8443
systemctl status xray sing-box jiedian-panel

管理面板功能

功能	说明
登录	`.env` 中 `PANEL_USERNAME` / `PANEL_PASSWORD`
添加节点	自动生成 UUID + Hy2 密码，后台更新 Xray + sing-box 配置
复制链接	VLESS Reality + Hysteria2（Hy2 端口随节点自动变化）
删除节点	至少保留 1 个节点
连接状态	在线/离线、连接数
流量统计	实时速率 + 累计上下行

部署后验证

# 服务
systemctl is-active xray sing-box jiedian-panel

# 配置语法
xray run -test -c /usr/local/etc/xray/config.json
sing-box check -c /etc/sing-box/config.json

# Reality 密钥是否一致
bash /opt/jiedian/scripts/verify-reality.sh

# 面板可访问
PANEL_PATH=$(grep ^PANEL_PATH= /opt/jiedian/.env | cut -d= -f2)
curl -I "http://$(grep ^DOMAIN= /opt/jiedian/.env | cut -d= -f2)/${PANEL_PATH}/login"

客户端：导入面板复制的 VLESS 链接，v2rayN 测速应显示延迟（非 -1）。详见 client-import.md。

卸载后重装（推荐流程）

若之前部署混乱，先卸载再装：

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

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

从旧版升级（sing-box 跑 Reality → Xray）

若你之前用 sing-box 监听 443 且 v2rayN Reality 一直 -1，拉代码后执行：

cd /opt/jiedian && git pull
bash scripts/migrate-xray-reality.sh

客户端 无需改参数，直接重测 VLESS 节点即可。

增删节点后的配置

面板会自动后台执行 render-xray.py、render-server.py 并重启服务。若需手动：

cd /opt/jiedian
python3 scripts/render-xray.py
python3 scripts/render-server.py
systemctl restart xray sing-box

修改 Reality 密钥后（generate-keys.sh）也必须执行上述命令。

故障排查速查

问题	处理
面板 404	URL 须含完整 `PANEL_PATH`，见 `grep PANEL_PATH .env`
面板 Invalid URL / [No Host]	用 http:// 访问，不要用 https
VLESS 测速 `-1`	`bash scripts/verify-reality.sh`；确认未用 https 访问面板
Hy2 不通	安全组放行 8443–8499/UDP；重新复制面板 Hy2 链接
apt 锁被占用	等待自动更新结束，`install.sh` 会自动等待
443 被占用	`ss -tlnp \| grep 443`，应为 xray
忘记面板密码/路径	`grep PANEL_ /opt/jiedian/.env` 或 `generate-keys.sh`

更多见 troubleshooting.md。

5.7 KiB Raw Blame History Unescape Escape