ProxyPool With UI

一个功能完善的代理池系统，带有现代化的 Web 管理界面，支持多种代理协议和 Clash 订阅。

✨ 核心特性

🎯 自动爬取 - 从 14+ 个免费代理源自动爬取代理
✅ 自动验证 - 实时验证代理可用性，只返回可用代理
🌐 多协议支持 - HTTP、HTTPS、SOCKS4、SOCKS5
🎨 现代化 UI - 基于 Nuxt 3 + Vue 3 + Ant Design Vue
⚡ Clash 订阅 - 一键导入 Clash，支持 50+ 国家节点筛选
🚀 V2Ray 订阅 - 支持 V2Ray 客户端，Base64 编码格式
🔐 安全订阅链接 - JWT加密的订阅链接，支持临时和永久链接
📋 订阅管理 - 统一管理所有生成的订阅链接，支持刷新和删除
🔄 实时监控 - 代理状态、爬取器状态实时展示
📍 地理位置 - 自动识别代理 IP 归属地（国家/城市）
🛠️ 手动添加 - 支持手动添加自有代理
🔐 登录鉴权 - JWT Token 认证，保护管理接口安全
🔒 单实例运行 - 防止多实例冲突，确保数据一致性
⚙️ API管理 - 支持禁用/启用特定API接口，状态持久化保存

🚀 快速开始

方式一：本地运行

# 1. 克隆项目
git clone https://github.com/huppugo1/ProxyPoolWithUI.git
cd ProxyPoolWithUI

# 2. 安装依赖
pip install -r requirements.txt

# 3. 配置安全设置（重要！）
python setup_security.py

# 4. 启动服务
python main.py

🔐 安全提示: 首次运行前必须配置 JWT 密钥！运行 python setup_security.py 进行安全配置。

方式二：Docker 运行

快速开始

临时运行（数据不持久化）

docker run -d \
  --name proxy-pool \
  -p 5000:5000 \
  ghcr.io/huppugo1/proxypoolwithui:latest

⚠️ 注意: 容器删除后数据会丢失，仅适用于测试

持久化运行（推荐）

docker run -d \
  --name proxy-pool \
  -p 5000:5000 \
  -v $(pwd)/data:/proxy/data \
  ghcr.io/huppugo1/proxypoolwithui:latest

数据持久化配置

1. 使用绝对路径（推荐）

# 创建数据目录
mkdir -p /home/yourusername/proxy-data

# 运行容器
docker run -d \
  --name proxy-pool \
  -p 5000:5000 \
  -v /home/yourusername/proxy-data:/proxy/data \
  ghcr.io/huppugo1/proxypoolwithui:latest

✅ 优势: 路径明确，便于管理和备份

2. 使用相对路径

# 进入项目目录
cd /path/to/your/project

# 创建数据目录
mkdir -p ./data

# 运行容器
docker run -d \
  --name proxy-pool \
  -p 5000:5000 \
  -v ./data:/proxy/data \
  ghcr.io/huppugo1/proxypoolwithui:latest

✅ 优势: 便于项目迁移，路径相对简单

3. 使用Docker命名卷

docker run -d \
  --name proxy-pool \
  -p 5000:5000 \
  -v proxy-data:/proxy/data \
  ghcr.io/huppugo1/proxypoolwithui:latest

✅ 优势: Docker自动管理，适合生产环境

完整部署示例

# 1. 创建数据目录
mkdir -p ./data

# 2. 运行容器（生产环境配置）
docker run -d \
  --name proxy-pool \
  -p 5000:5000 \
  -v $(pwd)/data:/proxy/data \
  --restart unless-stopped \
  --memory=512m \
  --cpus=1.0 \
  ghcr.io/huppugo1/proxypoolwithui:latest

# 3. 验证部署
echo "等待服务启动..."
sleep 10

# 检查容器状态
docker ps | grep proxy-pool

# 查看数据目录
ls -la ./data/

# 查看服务日志
docker logs -f proxy-pool

# 测试API接口
curl http://localhost:5000/api/proxies

常用管理命令

# 查看容器状态
docker ps -a | grep proxy-pool

# 查看实时日志
docker logs -f proxy-pool

# 停止容器
docker stop proxy-pool

# 启动容器
docker start proxy-pool

# 重启容器
docker restart proxy-pool

# 删除容器（保留数据）
docker rm proxy-pool

# 删除容器和数据
docker rm -v proxy-pool

数据备份与恢复

# 备份数据
tar -czf proxy-data-backup-$(date +%Y%m%d).tar.gz ./data/

# 恢复数据
tar -xzf proxy-data-backup-20240101.tar.gz

# 迁移到新服务器
scp -r ./data/ user@new-server:/path/to/new/location/

国内用户可将镜像名替换为 ghcr.nju.edu.cn/huppugo1/proxypoolwithui:latest

启动成功后访问：http://localhost:5000/web

💡 首次启动需要等待 5-10 分钟让系统爬取和验证代理

默认登录账户

用户名: admin
密码: admin123

⚠️ 重要提示: 首次登录后请立即修改默认密码！

🔐 登录鉴权

系统已集成 JWT Token 认证机制，所有管理接口均需要登录后才能访问。

认证流程

登录获取 Token

curl -X POST http://localhost:5000/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "admin123"}'

返回示例：

{
  "success": true,
  "message": "登录成功",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "username": "admin",
    "role": "admin"
  }
}

使用 Token 访问接口

curl http://localhost:5000/proxies_status \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

认证接口

接口	方法	说明	是否需要认证
`/auth/login`	POST	用户登录	❌
`/auth/verify`	GET	验证 Token	✅
`/auth/change_password`	POST	修改密码	✅

Token 说明

Token 有效期：24 小时（可在 config.py 中配置）
Token 过期后需要重新登录
前端会自动处理 Token 过期跳转

修改默认密码

登录后点击右上角用户名，选择”修改密码”即可修改。

或通过 API：

curl -X POST http://localhost:5000/auth/change_password \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"old_password": "admin123", "new_password": "your_new_password"}'

📡 API 接口

⚠️ 注意: 除了 /ping、/fetch_*、/clash* 和 /v2ray 等代理获取接口外，其他管理接口均需要认证。

基础接口

接口	说明	示例
`/ping`	测试 API 状态	`curl http://localhost:5000/ping`
`/fetch_random`	随机获取一个可用代理	`curl http://localhost:5000/fetch_random`
`/fetch_all`	获取所有可用代理	`curl http://localhost:5000/fetch_all`
`/fetch_http`	获取一个 HTTP 代理	`curl http://localhost:5000/fetch_http`
`/fetch_https`	获取一个 HTTPS 代理	`curl http://localhost:5000/fetch_https`
`/fetch_socks5`	获取一个 SOCKS5 代理	`curl http://localhost:5000/fetch_socks5`

Clash 订阅接口

接口	说明	参数
`/clash`	获取 Clash 完整订阅配置	`c`, `nc`, `protocol`, `limit`
`/clash/proxies`	获取 Clash 代理节点列表	`c`, `nc`, `protocol`, `limit`

V2Ray 订阅接口

接口	说明	参数
`/v2ray`	获取 V2Ray 订阅配置（Base64 编码）	`c`, `nc`, `protocol`, `limit`

安全订阅接口（需要认证）

接口	说明	参数
`/generate_subscription_links`	生成加密的订阅链接	`type`, `permanent`, `params`
`/subscribe/clash`	使用加密token获取Clash配置	`token`, `params`
`/subscribe/v2ray`	使用加密token获取V2Ray配置	`token`, `params`
`/subscription_links`	获取用户的订阅链接列表	-
`/subscription_links/<id>`	删除指定订阅链接	-
`/subscription_links/<id>/refresh`	刷新订阅链接（重新生成token）	-

API接口管理（需要认证）

接口	说明	参数
`/api_status`	获取所有API接口的启用状态	-
`/api_toggle/<path>`	切换指定API的启用/禁用状态	-

参数说明：

c - 按国家筛选（如：c=CN,US,JP）
nc - 排除指定国家（如：nc=CN）
protocol - 筛选协议类型（http/https/socks4/socks5）
limit - 限制返回数量（如：limit=50）

支持的国家代码： CN、HK、TW、US、CA、JP、SG、AU、RU、CH、DE、FR、GB、NL 等 50+ 个

使用示例：

# 获取所有代理
http://localhost:5000/clash
http://localhost:5000/v2ray

# 仅获取美国和日本的代理，限制 50 个
http://localhost:5000/clash?c=US,JP&limit=50
http://localhost:5000/v2ray?c=US,JP&limit=50

# 排除中国大陆的代理
http://localhost:5000/clash?nc=CN
http://localhost:5000/v2ray?nc=CN

# 仅获取 SOCKS5 代理
http://localhost:5000/clash?protocol=socks5
http://localhost:5000/v2ray?protocol=socks5

🎯 Clash 使用指南

方法 A：直接订阅（推荐）

打开 Clash 客户端
进入「配置」或「Profiles」
添加订阅链接：http://localhost:5000/clash
点击更新订阅并启用

方法 B：手动导入

访问：http://localhost:5000/clash
复制返回的 YAML 配置
在 Clash 中创建新配置文件并保存

支持的 Clash 客户端

✅ Clash for Windows
✅ Clash for Android
✅ ClashX / ClashX Pro (macOS)
✅ Clash Premium
✅ Clash Meta / Mihomo

使用建议

定期更新 - 建议设置自动更新订阅（每 6 小时）
限制数量 - 使用 limit 参数限制代理数量（推荐 20-50 个）
自动测试 - 启用 Clash 自动测试，选择最快的代理
节点名称 - 自动显示国家 emoji 和 IP（如：🇨🇳 中国+1.2.3.4）

🚀 V2Ray 使用指南

方法 A：直接订阅（推荐）

打开 V2Ray 客户端（如 V2RayN、V2RayX、Qv2ray 等）
进入「订阅」或「Subscription」
添加订阅链接：http://localhost:5000/v2ray
点击更新订阅并启用

方法 B：手动导入

访问：http://localhost:5000/v2ray
复制返回的 Base64 编码内容
在 V2Ray 客户端中导入订阅

🔐 安全订阅使用指南

生成加密订阅链接

登录管理界面：http://localhost:5000/web
在首页点击「Clash 订阅」或「V2Ray 订阅」按钮
选择订阅类型：
- 临时链接：1小时有效期，适合临时使用
- 永久链接：永久有效，直到用户被删除
配置筛选参数（可选）：
- 国家筛选：选择特定国家
- 协议筛选：选择特定协议类型
- 数量限制：限制代理数量
点击「生成订阅链接」获取加密链接

使用加密订阅链接

Clash 客户端：

复制生成的加密链接
在 Clash 中添加订阅链接
客户端会自动使用加密链接获取配置

V2Ray 客户端：

复制生成的加密链接
在 V2Ray 客户端中添加订阅
客户端会自动解析加密链接

订阅管理

访问「订阅管理」页面
查看所有已生成的订阅链接
支持的操作：
- 复制链接：快速复制订阅链接
- 刷新链接：重新生成token（保持原参数）
- 删除链接：删除不需要的订阅链接
- 批量操作：支持批量复制、刷新、删除

安全特性

JWT 加密：所有订阅链接使用 JWT 加密，确保安全性
参数保护：筛选参数被加密保护，无法被篡改
用户隔离：每个用户只能管理自己的订阅链接
自动过期：临时链接自动过期，避免长期暴露

⚙️ API接口管理

管理API接口状态

系统支持禁用/启用特定的API接口，提供细粒度的接口控制。

访问管理界面

登录管理界面：http://localhost:5000/web
进入”API接口文档”页面
展开”API接口管理”面板

管理功能

单个接口管理：

使用开关控件启用/禁用单个API
实时显示接口状态（绿色=启用，灰色=禁用）
支持按路径和分类搜索接口

批量操作：

全部启用：一键启用所有API接口
全部禁用：一键禁用所有API接口
刷新状态：重新加载接口状态

接口分类

认证接口：登录、验证、修改密码等
代理接口：获取代理相关接口
Clash接口：Clash订阅相关接口
V2Ray接口：V2Ray订阅相关接口
订阅接口：安全订阅相关接口
管理接口：系统管理相关接口

状态持久化

API状态保存在 api_status.json 文件中
重启服务后状态设置不会丢失
支持手动编辑配置文件

安全特性

禁用后的API返回403错误
错误信息包含明确的禁用提示
所有管理操作需要JWT认证

使用示例

# 获取所有API状态
curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:5000/api_status

# 禁用特定API
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" http://localhost:5000/api_toggle/fetch_random

# 启用特定API
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" http://localhost:5000/api_toggle/fetch_random

支持的 V2Ray 客户端

✅ V2RayN (Windows)
✅ V2RayX (macOS)
✅ Qv2ray (跨平台)
✅ V2RayNG (Android)
✅ Shadowrocket (iOS)
✅ ClashX (macOS)

代理格式说明

V2Ray 订阅支持以下代理格式：

HTTP/HTTPS 代理 - 转换为 VMess 格式
SOCKS4/SOCKS5 代理 - 转换为 socks:// 格式
认证信息 - 自动处理用户名密码认证

使用建议

定期更新 - 建议设置自动更新订阅（每 6 小时）
限制数量 - 使用 limit 参数限制代理数量（推荐 20-50 个）
协议选择 - 根据网络环境选择合适的协议类型
节点测试 - 启用 V2Ray 自动测试，选择最快的代理

🐍 Python 使用示例

import requests

# 获取一个随机代理
proxy_uri = requests.get('http://localhost:5000/fetch_random').text

if proxy_uri:
    proxies = {'http': proxy_uri, 'https': proxy_uri}
    response = requests.get('https://www.example.com', proxies=proxies)
    print(response.text)
else:
    print('暂时没有可用代理')

📦 已集成的代理源

名称	地址	备注
悠悠网络代理	https://uu-proxy.com/
快代理	https://www.kuaidaili.com/
全网代理	http://www.goubanjia.com/
66代理	http://www.66ip.cn/
云代理	http://www.ip3366.net/
免费代理库	https://ip.jiangxianli.com/
小幻HTTP代理	https://ip.ihuan.me/
89免费代理	https://www.89ip.cn/
ProxyScan	https://www.proxyscan.io/
开心代理	http://www.kxdaili.com/
西拉代理	http://www.xiladaili.com/
小舒代理	http://www.xsdaili.cn/
ProxyList	https://www.proxy-list.download/
ProxyScrape	https://proxyscrape.com/	国内无法直接访问

📁 项目结构

ProxyPoolWithUI/
├── api/              # API 服务（Flask）
├── auth/             # 认证模块（JWT）
├── db/               # 数据库封装（SQLite）
├── fetchers/         # 代理爬取器
├── proc/             # 爬取和验证进程
├── frontend/         # Web 前端（Nuxt 3 + Vue 3）
├── utils/            # 工具类（IP 定位、单实例管理）
├── data/             # 数据目录（数据库、配置文件等）
│   ├── config.py     # 配置文件
│   ├── data.db       # SQLite 数据库
│   ├── users.json    # 用户数据
│   ├── api_status.json # API接口状态配置
│   └── sub.json      # 订阅链接存储
└── main.py           # 启动入口

⚙️ 配置说明

大部分配置在 data/config.py 中，默认配置已经可以适应大部分情况。

数据目录结构

所有数据文件和配置文件统一存放在 data/ 目录下：

data/config.py - 主配置文件，包含所有系统配置
data/data.db - SQLite 数据库文件，存储代理数据
data/users.json - 用户账户数据（用户名、密码哈希等）
data/api_status.json - API接口启用/禁用状态配置
data/sub.json - 生成的订阅链接存储

数据备份

建议定期备份 data/ 目录，包含所有重要的运行时数据：

# 备份数据目录
tar -czf proxypool_backup_$(date +%Y%m%d).tar.gz data/

# 恢复数据目录
tar -xzf proxypool_backup_20241019.tar.gz

主要配置项

验证超时时间 - 代理验证的超时设置
验证间隔 - 代理重新验证的时间间隔
爬取间隔 - 爬取器运行的时间间隔
数据库路径 - SQLite 数据库文件位置

认证配置

在 config.py 中可以配置认证相关参数：

# JWT密钥 - 建议在生产环境使用环境变量
JWT_SECRET_KEY = os.environ.get('JWT_SECRET_KEY', 'your-secret-key-change-it-in-production-2025')

# Token过期时间（小时）
TOKEN_EXPIRATION_HOURS = 24

生产环境建议设置环境变量：

export JWT_SECRET_KEY="your-very-strong-secret-key-here"
python main.py

🔧 高级功能

单实例运行保护

系统具备完善的单实例运行机制，防止多个实例同时运行：

端口占用检查 - 检测5000端口是否被占用
PID文件锁 - 在用户主目录创建PID文件记录进程ID
锁文件机制 - 创建包含时间戳的锁文件，支持过期清理
进程状态验证 - 验证PID对应的进程是否真实存在

如果检测到已有实例运行，系统会显示清理命令：

# Windows 清理命令
taskkill /f /im python.exe
del "%USERPROFILE%\.proxypoolwithui.pid"
del "%USERPROFILE%\.proxypoolwithui.lock"

# Linux/Unix 清理命令
pkill -f python.*main.py
rm -f ~/.proxypoolwithui.pid
rm -f ~/.proxypoolwithui.lock

📊 工作流程

[代理源] → [爬取器] → [数据库] → [验证器] → [API] → [用户]
             ↓                      ↓
         [定时爬取]             [定时验证]

爬取进程 - 定时从各代理源爬取代理，存入数据库
验证进程 - 定时验证数据库中的代理是否可用
API 服务 - 提供 HTTP 接口和 Web 界面

详细流程图：

🔒 生产环境部署

安全检查清单

在部署到生产环境之前，请确保完成以下安全检查：

必须完成的项目

JWT 密钥配置

修改默认 JWT 密钥
使用环境变量存储密钥（推荐）
密钥长度至少 32 位
使用随机字符串作为密钥

# 生成强密钥示例
python -c "import secrets; print(secrets.token_urlsafe(32))"

# 设置环境变量
export JWT_SECRET_KEY="your-generated-secret-key"

修改默认密码
- 首次登录后立即修改默认管理员密码
- 新密码长度至少 8 位
- 包含大小写字母、数字和特殊字符
文件权限
```
chmod 600 users.json
chmod 600 data.db
```
网络安全
- 生产环境使用 HTTPS（必须）
- 配置防火墙规则
- 限制管理接口访问 IP（推荐）
- 使用反向代理（Nginx/Apache）

Nginx 反向代理配置

server {
    listen 443 ssl http2;
    server_name your-domain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    # 安全头
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # 超时设置
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }

    # 限制上传大小
    client_max_body_size 10M;
}

# HTTP 重定向到 HTTPS
server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

Systemd 服务配置

创建 /etc/systemd/system/proxypool.service：

[Unit]
Description=ProxyPool Management System
After=network.target

[Service]
Type=simple
User=proxypool
WorkingDirectory=/path/to/ProxyPoolWithUI
Environment="JWT_SECRET_KEY=your-secret-key-here"
ExecStart=/usr/bin/python3 /path/to/ProxyPoolWithUI/main.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl daemon-reload
sudo systemctl enable proxypool
sudo systemctl start proxypool
sudo systemctl status proxypool

Docker 部署安全配置

# 使用非 root 用户
RUN adduser --disabled-password --gecos '' proxypool
USER proxypool

# 健康检查
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD curl -f http://localhost:5000/ping || exit 1

运行容器：

docker run -d \
  --name proxypool \
  -p 5000:5000 \
  -e JWT_SECRET_KEY="your-secret-key" \
  -v /path/to/data:/proxy \
  --restart unless-stopped \
  --read-only \
  --tmpfs /tmp \
  proxy_pool

❓ 常见问题

Q: 没有可用代理？

A: 首次启动需要等待 5-10 分钟。访问 http://localhost:5000/web 查看爬取和验证状态。

Q: 代理不稳定？

A: 免费代理质量参差不齐，建议：

使用 Clash 自动测试功能
定期更新订阅
使用 limit 参数限制数量

Q: 如何禁用某个爬取器？

A: 在 Web 界面的「爬取器状态」页面中操作，或访问 API：

http://localhost:5000/fetcher_enable?name=爬取器名称&enable=0

Q: 如何远程访问？

A: 将 localhost 替换为服务器 IP，并确保防火墙允许 5000 端口。

Q: Docker 容器如何持久化数据？

A: 使用 -v 参数挂载数据目录：

docker run -p 5000:5000 -v /path/to/data:/proxy -d proxy_pool

Q: 忘记密码怎么办？

A: 删除项目根目录下的 users.json 文件，重启服务会自动创建默认管理员账户。

Q: 如何禁用登录认证？

A: 不建议禁用认证。如果确实需要，可以在 api/api.py 中移除需要保护接口的 @token_required 装饰器。

Q: API 接口需要认证吗？

需要认证：所有管理接口（代理状态、爬取器管理、添加代理、订阅管理等）
无需认证：代理获取接口（/fetch_*、/clash*、/v2ray）和健康检查（/ping）
部分认证：安全订阅接口（/subscribe/clash、/subscribe/v2ray）需要有效的JWT token

Q: 支持哪些订阅格式？

Clash 订阅：/clash - 返回 YAML 格式配置
V2Ray 订阅：/v2ray - 返回 Base64 编码的代理链接
代理列表：/clash/proxies - 仅返回 Clash 代理节点列表
安全订阅：/subscribe/clash、/subscribe/v2ray - 使用JWT token的加密订阅

Q: 提示”检测到已有实例在运行”？

A: 系统具备单实例保护机制。如果确定没有其他实例运行，可以手动清理锁文件：

# Windows
del "%USERPROFILE%\.proxypoolwithui.pid"
del "%USERPROFILE%\.proxypoolwithui.lock"

# Linux/Mac
rm ~/.proxypoolwithui.pid
rm ~/.proxypoolwithui.lock

Q: 如何修改 JWT 密钥？

A: 生产环境建议使用环境变量：

export JWT_SECRET_KEY="your-very-strong-secret-key"
python main.py

Q: 如何禁用特定的API接口？

A: 有两种方式：

Web界面：登录后进入”API接口文档”页面，展开”API接口管理”面板，使用开关控件管理
API调用：使用 /api_toggle/<path> 接口切换状态

Q: API禁用状态保存在哪里？

A: API状态保存在项目根目录的 api_status.json 文件中，重启服务后设置不会丢失。

Q: 禁用的API会返回什么错误？

A: 禁用的API会返回403状态码，错误信息为：API接口 <path> 已被禁用。

Q: 如何批量管理API接口？

A: 在API管理界面中，可以使用”全部启用”和”全部禁用”按钮进行批量操作。

🛠️ 技术栈

后端：

Python 3.6+
Flask - Web 框架
SQLite - 数据库
Requests - HTTP 库
PyYAML - Clash 配置生成
PyJWT - JWT 认证
psutil - 进程管理

前端：

Nuxt 3 - Vue 框架
Vue 3 - JavaScript 框架
TypeScript - 类型安全
Ant Design Vue - UI 组件库
Vite - 构建工具
Axios - HTTP 客户端

🔐 安全配置

JWT 密钥配置

ProxyPool 使用 JWT Token 进行身份认证，必须配置强密钥以确保系统安全。

自动配置（推荐）

# 运行安全配置脚本，自动生成密钥并保存到 .env 文件
python setup_security.py

手动配置

创建 .env 文件：

# 生成强密钥
python -c "import secrets; print(secrets.token_urlsafe(32))"

# 创建 .env 文件并添加密钥
echo "JWT_SECRET_KEY=your-generated-secret-key" > .env

编辑 .env 文件：

JWT_SECRET_KEY=your-strong-secret-key-here

安全要求

✅ 密钥长度至少 32 字符
✅ 使用随机生成的强密钥
❌ 禁止使用弱密钥（如：admin123、password、secret）
❌ 禁止将 .env 文件提交到版本控制

验证配置

# 检查配置是否正确
python -c "from config import JWT_SECRET_KEY; print('密钥长度:', len(JWT_SECRET_KEY))"

默认账户

用户名: admin
密码: admin123
⚠️ 重要: 首次登录后请立即修改密码！

📝 开发贡献

欢迎提交 Issue 和 Pull Request！

Fork 本项目
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
创建 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

🙏 致谢

感谢所有免费代理源提供者
感谢开源社区的贡献者

版本: 2.0.2
更新时间: 2025-10-19
状态: ✅ 生产就绪

🔄 更新日志

v2.0.2 (2025-10-19)

🔐 新增安全订阅链接功能
📋 订阅管理界面，支持链接的生成、刷新、删除
🔑 JWT加密的订阅链接，支持临时和永久链接
🛡️ 订阅参数加密保护，防止篡改
👥 用户隔离的订阅链接管理
⚙️ API接口管理功能，支持禁用/启用特定接口
💾 API状态持久化保存，重启后设置不丢失
🎨 优化前端界面，新增订阅管理和API管理页面
📁 重构数据目录结构，统一管理配置和数据文件
🧹 移除过时文档，优化项目结构

v2.0.1 (2025-10-19)

✨ 新增 JWT Token 登录鉴权功能
🔐 所有管理接口添加认证保护
👤 用户管理：登录、修改密码
🎨 全新登录页面设计
🛡️ 自动 Token 刷新和过期处理
🔒 单实例运行保护机制
📝 完善的认证 API 文档
🧹 代码优化和文档合并

v2.0.0

初始版本发布

ProxyPoolWithUI：多功能现代代理池及管理系统

ProxyPool With UI

✨ 核心特性

🚀 快速开始

方式一：本地运行

方式二：Docker 运行

快速开始

数据持久化配置

完整部署示例

常用管理命令

数据备份与恢复

默认登录账户

🔐 登录鉴权

认证流程

认证接口

Token 说明

修改默认密码

📡 API 接口

基础接口

Clash 订阅接口

V2Ray 订阅接口

安全订阅接口（需要认证）

API接口管理（需要认证）

🎯 Clash 使用指南

方法 A：直接订阅（推荐）

方法 B：手动导入

支持的 Clash 客户端

使用建议

🚀 V2Ray 使用指南

方法 A：直接订阅（推荐）

方法 B：手动导入

🔐 安全订阅使用指南

生成加密订阅链接

使用加密订阅链接

订阅管理

安全特性

⚙️ API接口管理

管理API接口状态

访问管理界面

管理功能

接口分类

状态持久化

安全特性

使用示例

支持的 V2Ray 客户端

代理格式说明

使用建议

🐍 Python 使用示例

📦 已集成的代理源

📁 项目结构

⚙️ 配置说明

数据目录结构

数据备份

主要配置项

认证配置

🔧 高级功能

单实例运行保护

添加自定义代理源

自定义验证算法

前端开发指南

📊 工作流程

🔒 生产环境部署

安全检查清单

必须完成的项目

Nginx 反向代理配置

Systemd 服务配置

Docker 部署安全配置

❓ 常见问题

Q: 没有可用代理？

Q: 代理不稳定？

Q: 如何禁用某个爬取器？

Q: 如何远程访问？

Q: Docker 容器如何持久化数据？

Q: 忘记密码怎么办？

Q: 如何禁用登录认证？

Q: API 接口需要认证吗？

Q: 支持哪些订阅格式？

Q: 提示”检测到已有实例在运行”？

Q: 如何修改 JWT 密钥？

Q: 如何禁用特定的API接口？