221 lines
3.7 KiB
Markdown
221 lines
3.7 KiB
Markdown
# 代理管理平台
|
|
|
|
一个智能代理调度平台，支持用户通过 SOCKS5 连接，根据解锁能力和使用规则自动选择最优节点。
|
|
|
|
## 功能特性
|
|
|
|
- **SOCKS5 代理服务**：支持用户名密码认证，连接数限制
|
|
- **智能节点调度**：基于延迟、连接数、权重的负载均衡
|
|
- **WARP IP 管理**：自动刷新 IP，解锁检测
|
|
- **解锁能力筛选**：支持 GPT、Netflix、Disney+ 等服务
|
|
- **规则引擎**：根据解锁失败、使用次数等条件自动更换 IP
|
|
- **管理面板**：用户管理、节点管理、统计报表
|
|
|
|
## 快速开始
|
|
|
|
### 前置要求
|
|
|
|
- Go 1.21+
|
|
- PostgreSQL 15+
|
|
- Redis 7+
|
|
- Node.js 18+ (前端开发)
|
|
- Docker & Docker Compose（推荐）
|
|
|
|
### 使用 Docker Compose 启动
|
|
|
|
```bash
|
|
# 克隆项目
|
|
git clone https://git.viaeon.com/your-org/proxy-platform.git
|
|
cd proxy-platform
|
|
|
|
# 启动服务
|
|
docker-compose -f deployments/docker-compose.yml up -d
|
|
|
|
# 查看日志
|
|
docker-compose -f deployments/docker-compose.yml logs -f scheduler
|
|
```
|
|
|
|
### 手动启动
|
|
|
|
```bash
|
|
# 安装依赖
|
|
go mod download
|
|
|
|
# 启动数据库
|
|
docker-compose -f deployments/docker-compose.yml up -d postgres redis
|
|
|
|
# 构建程序
|
|
make build
|
|
|
|
# 启动调度中心
|
|
./bin/scheduler
|
|
|
|
# 启动节点 Agent（在另一台服务器上）
|
|
./bin/agent
|
|
```
|
|
|
|
## 配置说明
|
|
|
|
### 调度中心配置 (configs/scheduler.yaml)
|
|
|
|
```yaml
|
|
server:
|
|
host: "0.0.0.0"
|
|
port: 8080
|
|
|
|
socks5:
|
|
host: "0.0.0.0"
|
|
port: 1080
|
|
max_connections: 10000
|
|
timeout: 30
|
|
|
|
database:
|
|
host: "localhost"
|
|
port: 5432
|
|
user: "postgres"
|
|
password: "postgres"
|
|
database: "proxy_platform"
|
|
|
|
scheduler:
|
|
strategy: "least_latency" # 负载均衡策略
|
|
health_check_interval: 10
|
|
```
|
|
|
|
### 节点 Agent 配置 (configs/agent.yaml)
|
|
|
|
```yaml
|
|
agent:
|
|
node_id: "node_001"
|
|
name: "US-Node-1"
|
|
region: "US"
|
|
|
|
warp:
|
|
enabled: true
|
|
socks5_port: 40000
|
|
refresh_cooldown: 300
|
|
max_refresh_retries: 5
|
|
|
|
unlock:
|
|
check_interval: 300
|
|
services:
|
|
- name: "gpt"
|
|
url: "https://chat.openai.com/"
|
|
- name: "netflix"
|
|
url: "https://www.netflix.com/title/80018499"
|
|
```
|
|
|
|
## API 文档
|
|
|
|
### 用户管理
|
|
|
|
```bash
|
|
# 创建用户
|
|
POST /api/v1/users
|
|
{
|
|
"username": "user1",
|
|
"password": "password123",
|
|
"traffic_quota": 107374182400,
|
|
"expire_days": 30
|
|
}
|
|
|
|
# 获取用户列表
|
|
GET /api/v1/users?page=1&page_size=20
|
|
|
|
# 更新用户
|
|
PUT /api/v1/users/:id
|
|
|
|
# 删除用户
|
|
DELETE /api/v1/users/:id
|
|
```
|
|
|
|
### 节点管理
|
|
|
|
```bash
|
|
# 创建节点
|
|
POST /api/v1/nodes
|
|
{
|
|
"node_id": "node_001",
|
|
"name": "US-Node-1",
|
|
"host": "1.2.3.4",
|
|
"port": 1080,
|
|
"region": "US"
|
|
}
|
|
|
|
# 获取节点列表
|
|
GET /api/v1/nodes
|
|
|
|
# 刷新节点 IP
|
|
POST /api/v1/nodes/:id/refresh-ip
|
|
```
|
|
|
|
### Agent 接口
|
|
|
|
```bash
|
|
# 心跳上报
|
|
POST /api/v1/agent/heartbeat
|
|
{
|
|
"node_id": "node_001",
|
|
"online": true,
|
|
"warp_connected": true,
|
|
"current_ip": "104.16.132.229",
|
|
"connections": 42
|
|
}
|
|
|
|
# 上报解锁状态
|
|
POST /api/v1/agent/unlock/report
|
|
```
|
|
|
|
## 使用示例
|
|
|
|
### 连接代理
|
|
|
|
```bash
|
|
# 使用 curl 测试
|
|
curl --socks5 user1:password123@127.0.0.1:1080 https://httpbin.org/ip
|
|
|
|
# 使用 Python
|
|
import requests
|
|
|
|
proxies = {
|
|
'http': 'socks5://user1:password123@127.0.0.1:1080',
|
|
'https': 'socks5://user1:password123@127.0.0.1:1080'
|
|
}
|
|
response = requests.get('https://httpbin.org/ip', proxies=proxies)
|
|
print(response.json())
|
|
```
|
|
|
|
### 节点部署
|
|
|
|
```bash
|
|
# 安装 WARP
|
|
curl -fsSL https://pkg.cloudflareclient.com/install.sh | sudo bash
|
|
|
|
# 连接 WARP
|
|
sudo warp-cli register
|
|
sudo warp-cli connect
|
|
sudo warp-cli set-mode proxy
|
|
|
|
# 配置 agent.yaml
|
|
# 启动 Agent
|
|
./agent
|
|
```
|
|
|
|
## 开发
|
|
|
|
```bash
|
|
# 运行测试
|
|
go test ./...
|
|
|
|
# 构建所有组件
|
|
make build
|
|
|
|
# 构建 Docker 镜像
|
|
make docker
|
|
|
|
# 运行代码检查
|
|
make lint
|
|
```
|
|
|
|
## License
|
|
|
|
MIT |