# jiedian — VPS 自建节点

个人/家庭自用的 **VLESS + Reality（主力）** + **Hysteria2（备用）** 双栈方案，带 **Web 管理面板**。

| 组件 | 职责 |
|------|------|
| **Xray** | VLESS + Reality（TCP 443） |
| **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
```

安装完成后会显示面板地址、用户名和密码。登录面板即可 **添加节点、复制分享链接**。

---

## 架构

```
浏览器 ──► Nginx:80/<PANEL_PATH>/ ──► Web 管理面板（登录、添加节点）
                              │
                              ▼
                    render-server.py + render-xray.py
                              │
              ┌───────────────┴───────────────┐
              ▼                               ▼
         Xray :443                    sing-box :8443+
    VLESS + Reality                  Hysteria2（每节点一端口）

客户端 (Win/iOS/Android)
    ├─ TCP 443 ──► Xray VLESS+Reality
    └─ UDP 8443+ ► sing-box Hysteria2
```

> VLESS Reality 使用 **Xray 服务端**，与 v2rayN / v2rayNG（Xray 核心）兼容性最好。Hy2 仍由 sing-box 承载。

---

## 目录结构

```
/opt/jiedian/
├── .env                        # VPS / Reality / 面板账号配置
├── data/nodes.db               # 节点数据库（安装后生成）
├── panel/                      # Web 管理面板（Flask）
├── scripts/
│   ├── install.sh              # 一键部署（Xray + sing-box + 面板）
│   ├── uninstall.sh            # 卸载后重装
│   ├── generate-keys.sh        # 生成 Reality 密钥与面板密码
│   ├── render-xray.py          # 生成 Xray VLESS Reality 配置
│   ├── render-server.py        # 生成 sing-box Hy2 配置
│   ├── migrate-xray-reality.sh # 旧版 sing-box Reality 迁移到 Xray
│   └── verify-reality.sh       # Reality 密钥与配置诊断
└── docs/
    ├── DEPLOY.md
    ├── client-import.md
    └── troubleshooting.md
```

---

## 端口与防火墙

| 端口 | 协议 | 用途 |
|------|------|------|
| 22 | TCP | SSH |
| 80 | TCP | HTTP（ACME 验证 + **管理面板**） |
| 443 | TCP | VLESS + Reality（**Xray**） |
| 8443–8499 | UDP | Hysteria2（**sing-box**，每节点递增） |

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

---

## 常用运维

```bash
# 面板地址
grep PANEL_PATH /opt/jiedian/.env

# 服务状态
systemctl status xray sing-box jiedian-panel

# Reality 诊断
bash /opt/jiedian/scripts/verify-reality.sh

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

# 卸载后干净重装
bash scripts/uninstall.sh
bash scripts/generate-keys.sh   # 可选：重置密钥与面板密码
bash scripts/install.sh
```

---

## 防墙要点

1. 不要公开分享节点链接
2. Reality **SNI** 使用 `www.microsoft.com`（或 `.env` 中 `REALITY_SERVER_NAME`），**不要用域名 `66.hyf2.cc`**
3. 客户端开启 uTLS / **chrome** 指纹；v2rayN 中 **SpiderX 填 `/`**
4. 面板路径与密码请妥善保管，安装后可在 `.env` 查看 `PANEL_PATH` / `PANEL_PASSWORD`

---

## 免责声明

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