feat: add bootstrap one-click deploy and update deployment docs

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
dekun
2026-07-11 13:49:20 +08:00
parent 46728e12f7
commit 1f36a76ce0
11 changed files with 525 additions and 223 deletions
+31 -30
View File
@@ -16,7 +16,7 @@
| 文档 | 说明 |
|------|------|
| **[docs/DEPLOY.md](docs/DEPLOY.md)** | 部署指南(安全组、安装、升级、验证 |
| **[docs/DEPLOY.md](docs/DEPLOY.md)** | 部署指南(**前期准备、端口、一键安装** |
| **[docs/GUIDE.md](docs/GUIDE.md)** | 使用说明(面板、节点、客户端、维护) |
| **[docs/client-import.md](docs/client-import.md)** | 客户端导入 Hy2 链接 |
| **[docs/troubleshooting.md](docs/troubleshooting.md)** | 故障排查 |
@@ -25,21 +25,36 @@
---
## 部署前准备
| # | 项目 | 要求 |
|---|------|------|
| 1 | VPS | Ubuntu 22.04 / 24.04root 权限 |
| 2 | 域名 | A 记录指向 VPS 公网 IP |
| 3 | 安全组 | 放行下方端口 |
### 需要开放的端口
| 端口 | 协议 | 用途 |
|------|------|------|
| 22 | TCP | SSH |
| 80 | TCP | ACME 证书验证 |
| 443 | TCP | HTTPS 管理面板 |
| **84438499** | **UDP** | Hysteria2 代理(多节点递增) |
> Hy2 走 **UDP**,安全组必须放行 **84438499/UDP 整段**。详细说明见 **[docs/DEPLOY.md](docs/DEPLOY.md)**。
---
## 快速部署
```bash
ssh root@YOUR_VPS_IP
SSH 登录新 VPS 后,一条命令完成部署(自动 clone,交互输入域名/邮箱/账号):
apt update && apt install -y git
git clone https://git.bz121.com/dekun/jiedian.git /opt/jiedian
cd /opt/jiedian
cp .env.example .env # 填写 VPS_IP、DOMAIN、ACME_EMAIL
bash scripts/install.sh
```bash
curl -fsSL https://git.bz121.com/dekun/jiedian/raw/main/scripts/bootstrap.sh | bash
```
安装完成后浏览器打开面板 → 登录 → **添加节点** → 复制 **Hy2 链接** 到 v2rayN / v2rayNG。
详细步骤见 **[docs/DEPLOY.md](docs/DEPLOY.md)**。
安装完成后会输出面板地址、用户名和密码。浏览器打开 → 登录 → **添加节点** → 复制 **Hy2 链接** 到 v2rayN / v2rayNG。
---
@@ -62,19 +77,6 @@ bash scripts/install.sh
---
## 端口与防火墙
| 端口 | 协议 | 用途 |
|------|------|------|
| 22 | TCP | SSH |
| 80 | TCP | HTTPACME 证书验证 + 跳转 HTTPS |
| 443 | TCP | **HTTPS 管理面板** |
| 84438499 | UDP | Hysteria2(每节点递增) |
云厂商安全组需放行 **443/TCP****84438499/UDP**
---
## 常用命令
```bash
@@ -89,8 +91,8 @@ cd /opt/jiedian && git pull
python3 scripts/render-server.py
systemctl restart sing-box jiedian-panel
# 从旧版(含 VLESS)迁移
bash scripts/remove-vless.sh
# 重置面板密码
bash scripts/generate-keys.sh
```
---
@@ -103,11 +105,10 @@ bash scripts/remove-vless.sh
├── data/nodes.db # 节点数据库
├── panel/ # Flask 管理面板
├── scripts/
│ ├── install.sh # 一键部署
│ ├── bootstrap.sh # 一键部署入口(自动 clone + 交互配置)
│ ├── install.sh # 核心安装逻辑
│ ├── uninstall.sh # 卸载
│ ├── remove-vless.sh # 旧版停用 VLESS
│ ├── enable-panel-https.sh # 启用 HTTPS 面板
│ ├── generate-keys.sh # 生成/重置面板密码
│ ├── generate-keys.sh # 重置面板密码
│ └── render-server.py # 生成 sing-box 配置
└── docs/ # 文档
```