dekun
bccf6cfdce
Add Flask panel with login, add/delete nodes, and share link copy. Generate sing-box config from SQLite; add uninstall script and clean install flow. Panel served at https://DOMAIN:8444 via nginx. Co-authored-by: Cursor <cursoragent@cursor.com>
115 lines
2.5 KiB
Markdown
115 lines
2.5 KiB
Markdown
# Ubuntu 部署指南
|
|
|
|
仓库：[https://git.bz121.com/dekun/jiedian.git](https://git.bz121.com/dekun/jiedian.git)
|
|
|
|
| 项目 | 值 |
|
|
|------|-----|
|
|
| VPS IP | `47.76.87.111` |
|
|
| 域名 | `66.hyf2.cc` |
|
|
| 管理面板 | `https://66.hyf2.cc:8444` |
|
|
| 部署目录 | `/opt/jiedian` |
|
|
| 系统 | Ubuntu 22.04 / 24.04 |
|
|
|
|
---
|
|
|
|
## 部署前准备
|
|
|
|
### 1. DNS 解析
|
|
|
|
```
|
|
66.hyf2.cc → 47.76.87.111
|
|
```
|
|
|
|
验证：
|
|
|
|
```bash
|
|
dig +short A 66.hyf2.cc
|
|
```
|
|
|
|
### 2. 阿里云安全组
|
|
|
|
放行：`22`、`80`、`443/TCP`、`8443/UDP`、`8444/TCP`
|
|
|
|
---
|
|
|
|
## 一键部署
|
|
|
|
```bash
|
|
apt update && apt install -y git
|
|
git clone https://git.bz121.com/dekun/jiedian.git /opt/jiedian
|
|
cd /opt/jiedian
|
|
bash scripts/install.sh
|
|
```
|
|
|
|
安装结束会输出：
|
|
|
|
```
|
|
管理面板: https://66.hyf2.cc:8444
|
|
用户名: admin
|
|
密码: xxxxx
|
|
```
|
|
|
|
浏览器打开面板 → 登录 → **添加节点** → 复制 VLESS / Hysteria2 链接到客户端。
|
|
|
|
---
|
|
|
|
## 卸载后重装（推荐流程）
|
|
|
|
若之前部署混乱，先卸载再装：
|
|
|
|
```bash
|
|
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 8444 端口提供 HTTPS 管理面板
|
|
|
|
---
|
|
|
|
## 管理面板功能
|
|
|
|
| 功能 | 说明 |
|
|
|------|------|
|
|
| 登录 | `.env` 中 `PANEL_USERNAME` / `PANEL_PASSWORD` |
|
|
| 添加节点 | 自动生成 UUID + Hy2 密码，更新 sing-box |
|
|
| 复制链接 | VLESS Reality + Hysteria2 分享链接 |
|
|
| 删除节点 | 至少保留 1 个节点 |
|
|
|
|
---
|
|
|
|
## 部署后验证
|
|
|
|
```bash
|
|
systemctl status sing-box jiedian-panel
|
|
ss -tlnp | grep -E '443|8444'
|
|
ss -ulnp | grep 8443
|
|
curl -k -I https://66.hyf2.cc:8444/login
|
|
```
|
|
|
|
---
|
|
|
|
## 故障排查
|
|
|
|
| 问题 | 处理 |
|
|
|------|------|
|
|
| apt 锁被占用 | 等待自动更新结束，或 `bash scripts/install.sh` 会自动等待 |
|
|
| sing-box 443 被占用 | `ss -tlnp \| grep 443`，停止占用进程后重装 |
|
|
| 忘记面板密码 | `grep PANEL_PASSWORD /opt/jiedian/.env` 或重新 `generate-keys.sh` |
|
|
| SSH 主机密钥变更 | 重装系统后本地执行 `ssh-keygen -R 47.76.87.111` |
|
|
|
|
更多见 [troubleshooting.md](troubleshooting.md)。
|