jiedian/docs/GUIDE.md

使用说明

本文档面向日常使用 jiedian 的用户，说明管理面板、节点与客户端的基本操作。

---

一、项目是什么

jiedian 是一套自建代理方案：

• 服务端：VPS 上运行 sing-box，提供 Hysteria2（Hy2） 协议
• 管理面板：Web 界面管理节点、复制链接、查看在线与流量
• 客户端：v2rayN（Windows）、v2rayNG（Android）、Shadowrocket（iOS）等导入 Hy2 链接即可使用

当前版本 仅支持 Hysteria2，不再提供 VLESS/Reality。

---

二、管理面板

访问地址

http://你的域名/<PANEL_PATH>/

• 必须使用 HTTP（端口 80），不要用 HTTPS
• PANEL_PATH 在安装时生成，保存在 VPS 的 /opt/jiedian/.env 中：

grep PANEL_PATH /opt/jiedian/.env

登录

使用 .env 中的 PANEL_USERNAME 和 PANEL_PASSWORD。

面板功能

功能	说明
节点列表	查看各设备节点状态、连接数、实时/累计流量
添加节点	为每台设备创建独立 Hy2 账号
复制链接	一键复制 hy2:// 分享链接
删除节点	删除后对应链接立即失效（至少保留 1 个节点）

---

三、节点与设备

一设备一节点（推荐）

每个节点包含：

• 独立的 Hy2 密码
• 独立的 UDP 端口（按创建顺序递增）

节点顺序	Hy2 端口	示例
第 1 个	8443	手机
第 2 个	8444	电脑
第 3 个	8445	平板

添加节点

1. 面板点击 「+ 添加节点」
2. 输入名称（如「手机」「电脑」）
3. 等待约 5–10 秒页面刷新（后台重载 sing-box）
4. 点击 「复制」 获取 Hy2 链接
5. 在客户端 从剪贴板导入

不要共用链接

同一 hy2:// 链接 技术上可多台设备同时连，但不建议：

• 流量统计无法区分设备
• 带宽互相抢占
• 链接泄露影响所有共用设备

---

四、客户端配置

详细步骤见 client-import.md。

快速步骤

1. 在面板复制 hy2://... 链接
2. 打开客户端 → 从剪贴板导入
3. 设为活动节点并连接

链接格式

hy2://密码@域名:端口?sni=域名#节点名-Hy2

示例：

hy2://xxxx@66.hyf2.cc:8443?sni=66.hyf2.cc#默认节点-Hy2

注意：

• 地址是 域名（66.hyf2.cc），不是 IP
• SNI 与域名相同
• 端口以面板显示为准（多节点时 8444、8445…）

推荐客户端

平台	客户端
Windows	v2rayN
Android	v2rayNG
iOS	Shadowrocket / Streisand
macOS	v2rayN / Nekoray / sing-box

---

五、Hy2 稳定性说明

Hysteria2 基于 UDP，特点：

优点	说明
弱网表现好	高丢包环境下通常比 TCP 代理更流畅
部署简单	无需 Reality 密钥、SNI 等复杂参数
本方案已验证	同 VPS 下 Hy2 通常比 VLESS 更易连通

注意	说明
UDP 依赖	部分网络可能对 UDP 限速，可换 WiFi/热点试
证书	依赖域名与 Let's Encrypt，acme.sh 会自动续期
安全组	必须放行 8443–8499/UDP

---

六、日常维护

查看服务状态

systemctl status sing-box jiedian-panel

更新代码（VPS 上）

cd /opt/jiedian
git pull
python3 scripts/render-server.py
systemctl restart sing-box jiedian-panel

忘记面板密码

grep PANEL_PASSWORD /opt/jiedian/.env
# 或重新生成
bash /opt/jiedian/scripts/generate-keys.sh
systemctl restart jiedian-panel

换设备 / 丢链接

在面板找到对应节点，重新 复制 Hy2 链接导入即可，无需改服务端。

删除旧设备

面板删除该节点 → 客户端删除对应配置。

---

七、安全建议

1. 不要公开分享节点链接
2. 面板使用随机 PANEL_PATH，不要对外暴露
3. 可设置 PANEL_ALLOW_IP 限制面板访问来源
4. 不要将 .env 或节点链接提交到公开仓库
5. 定期 git pull 更新到最新版本

---

八、文档索引

文档	内容
DEPLOY.md	VPS 部署、升级、验证
client-import.md	各平台客户端导入
troubleshooting.md	故障排查
STACK.md	技术架构