# jiedian — VPS 自建节点

个人/家庭自用的 **Hysteria2** 方案，带 **Web 管理面板**。

| 组件 | 职责 |
|------|------|
| **sing-box** | Hysteria2（UDP 8443+，每节点独立端口） |
| **Flask 面板** | 节点管理、分享链接、在线/流量统计 |

**仓库**：https://git.bz121.com/dekun/jiedian.git  
**部署路径**：`/opt/jiedian`（Ubuntu）

| 项目 | 值 |
|------|-----|
| VPS IP | `47.76.87.111` |
| 域名 | `66.hyf2.cc` |
| 管理面板 | `http://66.hyf2.cc/<PANEL_PATH>/`（安装时输出，见 `.env`） |

> 完整部署步骤见 **[docs/DEPLOY.md](docs/DEPLOY.md)**

---

## 快速部署（Ubuntu VPS）

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

安装完成后登录面板 **添加节点、复制 Hy2 链接**。

---

## 架构

```
浏览器 ──► Nginx:80/<PANEL_PATH>/ ──► Web 管理面板
                              │
                              ▼
                    render-server.py
                              │
                              ▼
                    sing-box :8443+
                    Hysteria2（每节点一端口）

客户端 (Win/iOS/Android)
    └─ UDP 8443+ ► sing-box Hysteria2
```

---

## 目录结构

```
/opt/jiedian/
├── .env
├── data/nodes.db
├── panel/                      # Flask 管理面板
├── scripts/
│   ├── install.sh
│   ├── uninstall.sh
│   ├── remove-vless.sh         # 旧版双栈 VPS 停用 VLESS
│   ├── generate-keys.sh        # 生成面板密码
│   └── render-server.py        # 生成 sing-box Hy2 配置
└── docs/
```

---

## 端口与防火墙

| 端口 | 协议 | 用途 |
|------|------|------|
| 22 | TCP | SSH |
| 80 | TCP | HTTP（ACME + 管理面板） |
| 8443–8499 | UDP | Hysteria2（每节点递增） |

阿里云安全组需放行 **8443–8499/UDP**。

---

## 常用运维

```bash
grep PANEL_PATH /opt/jiedian/.env
systemctl status sing-box jiedian-panel

# 增删节点后手动重载
python3 /opt/jiedian/scripts/render-server.py
systemctl restart sing-box

# 从旧版（含 VLESS）迁移到仅 Hy2
bash /opt/jiedian/scripts/remove-vless.sh
```

---

## 免责声明

本项目仅供学习网络技术使用。请遵守当地法律法规。