Files

T

dekun 78b85c0d83 feat: enable HTTPS admin panel on port 443 for new deployments

Add Nginx SSL panel config, enable-panel-https.sh, secure Flask cookies, and update docs for https login.

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

2026-06-28 00:46:08 +08:00

5.3 KiB

Raw Blame History

部署指南

本文档说明如何在 Ubuntu VPS 上部署 jiedian（Hysteria2 + Web 管理面板）。

项目	说明
仓库	https://git.bz121.com/dekun/jiedian.git
部署目录	`/opt/jiedian`
系统要求	Ubuntu 22.04 / 24.04（root 或 sudo）
协议	Hysteria2（UDP 8443+）
管理面板	`https://域名/<PANEL_PATH>/`（安装完成后输出；HTTP 80 自动跳转）

一、部署前准备

1. 购买 VPS 并获取 root 登录

建议使用境外 VPS，带宽 ≥ 30Mbps。记录：

公网 IP（写入 .env 的 VPS_IP）
SSH 登录方式（密码或密钥）

2. 域名与 DNS

将域名 A 记录 解析到 VPS 公网 IP（用于 Hy2 TLS 证书与面板访问）：

your.domain.com  →  YOUR_VPS_IP

验证：

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

3. 云厂商安全组

在阿里云 / 腾讯云等控制台放行：

端口	协议	用途	必须
22	TCP	SSH	是
80	TCP	ACME 证书验证	是
443	TCP	HTTPS 管理面板	是
8443–8499	UDP	Hysteria2（多节点递增）	是

重要：每增加一个节点，Hy2 端口 +1（8443、8444、8445…）。安全组必须放行 8443–8499/UDP 整段，不能只开 8443。

4. 填写 `.env`

git clone https://git.bz121.com/dekun/jiedian.git /opt/jiedian
cd /opt/jiedian
cp .env.example .env
nano .env

变量	必填	说明
`VPS_IP`	是	VPS 公网 IP
`DOMAIN`	是	已解析到 VPS 的域名
`ACME_EMAIL`	是	Let's Encrypt 申请证书邮箱
`PANEL_USERNAME`	否	面板登录用户名，默认 `admin`
`PANEL_PASSWORD`	否	面板密码；留空则安装时自动生成
`PANEL_PATH`	否	面板 URL 路径；留空则自动生成如 `jiedian-a1b2c3d4`
`PANEL_ALLOW_IP`	否	仅允许指定 IP 访问面板（可选）

CLASH_API_SECRET 由 install.sh 自动生成，供面板读取连接统计，无需手动填写。

二、一键安装（新机器）

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
# 编辑 .env 填写 VPS_IP、DOMAIN、ACME_EMAIL
bash scripts/install.sh

安装脚本会自动完成：

安装 sing-box、nginx、Python 面板依赖
配置 UFW 防火墙（22/80/443 TCP，8443–8499 UDP）
通过 acme.sh 为 DOMAIN 申请 TLS 证书
初始化 SQLite 节点库与默认管理员
生成 sing-box 配置、启用 HTTPS 面板并启动服务

安装结束输出示例：

==========================================
  管理面板: https://66.hyf2.cc/jiedian-xxxx/
  （HTTP 会自动跳转到 HTTPS）
  面板路径: jiedian-xxxx
  用户名:   dekun
  密码:     xxxxx
==========================================

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

客户端导入详见 client-import.md。

三、部署后验证

# 服务状态
systemctl is-active sing-box jiedian-panel nginx

# sing-box 配置语法
sing-box check -c /etc/sing-box/config.json

# Hy2 端口监听（默认 8443，多节点还有 8444…）
ss -ulnp | grep 8443

# 面板 HTTPS 可访问（应返回 200/302）
PANEL_PATH=$(grep ^PANEL_PATH= /opt/jiedian/.env | cut -d= -f2)
curl -Ik "https://$(grep ^DOMAIN= /opt/jiedian/.env | cut -d= -f2)/${PANEL_PATH}/login"

客户端导入 Hy2 链接后测速，应显示正常延迟（非 -1）。

四、已有 VPS 更新代码

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

从旧版（含 VLESS/Xray）升级到仅 Hy2

若你之前部署过带 VLESS Reality 的版本：

cd /opt/jiedian
git pull
sudo bash scripts/remove-vless.sh

该脚本会：

停止并禁用 Xray
重载 sing-box 配置
启用 HTTPS 管理面板（443）
重启面板

完成后客户端 删除所有 VLESS 节点，从面板复制 hy2:// 链接，并用 HTTPS 登录面板。

已有 VPS 仅升级 HTTPS 面板

cd /opt/jiedian && git pull
sudo bash scripts/enable-panel-https.sh
systemctl restart jiedian-panel

五、增删节点后的配置重载

面板添加/删除节点时会 后台自动 重载 sing-box。若需手动执行：

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

六、卸载与重装

cd /opt/jiedian
bash scripts/uninstall.sh
# 保留 .env 与代码，清理 data/ 与 venv
bash scripts/install.sh

七、架构说明

浏览器 ──► Nginx:443 HTTPS/<PANEL_PATH>/ ──► Flask 管理面板
         └─► Nginx:80（ACME + 跳转 HTTPS）
                              │
                              ▼
                    render-server.py
                              │
                              ▼
                    sing-box :8443+
                    Hysteria2（每节点独立端口 + 密码）

客户端 ── UDP 8443+ ──► sing-box

更多技术细节见 STACK.md。

八、常见问题

见 troubleshooting.md。

日常使用见 GUIDE.md。

5.3 KiB Raw Blame History Unescape Escape