dekun
121 lines
3.3 KiB
Markdown
121 lines
3.3 KiB
Markdown
# jiedian — VPS 自建节点
|
||
|
||
个人/家庭自用的 **Hysteria2** 方案，带 **Web 管理面板**。
|
||
|
||
| 组件 | 职责 |
|
||
|------|------|
|
||
| **sing-box** | Hysteria2（UDP 8443+，每节点独立端口） |
|
||
| **Flask 面板** | 节点管理、分享链接、在线/流量统计 |
|
||
|
||
**仓库**：https://git.bz121.com/dekun/jiedian.git
|
||
**部署路径**：`/opt/jiedian`（Ubuntu 22.04 / 24.04）
|
||
|
||
---
|
||
|
||
## 文档
|
||
|
||
| 文档 | 说明 |
|
||
|------|------|
|
||
| **[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)** | 故障排查 |
|
||
| **[docs/STACK.md](docs/STACK.md)** | 技术架构 |
|
||
| **[docs/README.md](docs/README.md)** | 文档索引 |
|
||
|
||
---
|
||
|
||
## 部署前准备
|
||
|
||
| # | 项目 | 要求 |
|
||
|---|------|------|
|
||
| 1 | VPS | Ubuntu 22.04 / 24.04，root 权限 |
|
||
| 2 | 域名 | A 记录指向 VPS 公网 IP |
|
||
| 3 | 安全组 | 放行下方端口 |
|
||
|
||
### 需要开放的端口
|
||
|
||
| 端口 | 协议 | 用途 |
|
||
|------|------|------|
|
||
| 22 | TCP | SSH |
|
||
| 80 | TCP | ACME 证书验证 |
|
||
| 443 | TCP | HTTPS 管理面板 |
|
||
| **8443–8499** | **UDP** | Hysteria2 代理（多节点递增） |
|
||
|
||
> Hy2 走 **UDP**，安全组必须放行 **8443–8499/UDP 整段**。详细说明见 **[docs/DEPLOY.md](docs/DEPLOY.md)**。
|
||
|
||
---
|
||
|
||
## 快速部署
|
||
|
||
SSH 登录新 VPS 后，一条命令完成部署（自动 clone，交互输入域名/邮箱/账号）：
|
||
|
||
```bash
|
||
curl -fsSL https://git.bz121.com/dekun/jiedian/raw/main/scripts/bootstrap.sh | bash
|
||
```
|
||
|
||
安装完成后会输出面板地址、用户名和密码。浏览器打开 → 登录 → **添加节点** → 复制 **Hy2 链接** 到 v2rayN / v2rayNG。
|
||
|
||
---
|
||
|
||
## 架构
|
||
|
||
```
|
||
浏览器 ──► Nginx:443 HTTPS/<PANEL_PATH>/ ──► Web 管理面板
|
||
└─► Nginx:80（ACME 验证 + 跳转 HTTPS）
|
||
│
|
||
▼
|
||
render-server.py
|
||
│
|
||
▼
|
||
sing-box :8443+
|
||
Hysteria2（每节点一端口）
|
||
|
||
客户端 (Win/iOS/Android)
|
||
└─ UDP 8443+ ► sing-box Hysteria2
|
||
```
|
||
|
||
---
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
# 面板地址
|
||
grep PANEL_PATH /opt/jiedian/.env
|
||
|
||
# 服务状态
|
||
systemctl status sing-box jiedian-panel
|
||
|
||
# 更新代码
|
||
cd /opt/jiedian && git pull
|
||
python3 scripts/render-server.py
|
||
systemctl restart sing-box jiedian-panel
|
||
|
||
# 重置面板密码
|
||
bash scripts/generate-keys.sh
|
||
```
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
/opt/jiedian/
|
||
├── .env # VPS / 域名 / 面板账号
|
||
├── data/nodes.db # 节点数据库
|
||
├── panel/ # Flask 管理面板
|
||
├── scripts/
|
||
│ ├── bootstrap.sh # 一键部署入口（自动 clone + 交互配置）
|
||
│ ├── install.sh # 核心安装逻辑
|
||
│ ├── uninstall.sh # 卸载
|
||
│ ├── generate-keys.sh # 重置面板密码
|
||
│ └── render-server.py # 生成 sing-box 配置
|
||
└── docs/ # 文档
|
||
```
|
||
|
||
---
|
||
|
||
## 免责声明
|
||
|
||
本项目仅供学习网络技术使用。请遵守当地法律法规。
|