proxy-platform/PLAN.md

代理管理平台开发计划

项目概述

构建一个智能代理调度平台，支持用户通过 SOCKS5 连接，根据解锁能力和使用规则自动选择最优节点，节点服务器使用 WARP 出口实现 IP 管理。

---

开发阶段

Phase 1: 基础框架 (第1周)

1.1 项目初始化

• 创建项目目录结构
• 初始化 Go 模块
• 配置开发环境
• 搭建基础框架

1.2 数据库设计

• 创建数据库表结构
• 编写数据库迁移脚本
• 实现 ORM 模型

1.3 基础 API

• 用户认证 API
• 节点管理 API
• 健康检查 API

Phase 2: 核心功能 (第2周)

2.1 调度中心

• SOCKS5 服务端实现
• 节点选择算法
• 流量转发逻辑
• 用户认证中间件

2.2 节点 Agent

• WARP 管理模块
• 解锁检测模块
• 心跳上报模块
• 指令执行模块

2.3 规则引擎

• IP 更换规则
• 规则触发逻辑
• 规则配置 API

Phase 3: 管理面板 (第3周)

3.1 后端 API

• 用户管理 API
• 节点管理 API
• 统计报表 API
• 规则配置 API

3.2 前端界面

• 登录页面
• 仪表盘
• 节点管理页面
• 用户管理页面
• 规则配置页面

Phase 4: 测试与部署 (第4周)

4.1 测试

• 单元测试
• 集成测试
• 压力测试

4.2 部署

• Docker 镜像
• 部署脚本
• 监控配置

---

技术栈

组件	技术选型
后端语言	Go 1.21+
Web 框架	Gin
SOCKS5	gost / 自研
数据库	PostgreSQL
缓存	Redis
消息队列	Redis Streams
前端	Vue 3 + Element Plus
部署	Docker + Docker Compose

---

目录结构

proxy-platform/
├── cmd/
│   ├── scheduler/          # 调度中心
│   │   └── main.go
│   ├── agent/              # 节点 Agent
│   │   └── main.go
│   └── admin/              # 管理后台
│       └── main.go
├── internal/
│   ├── models/             # 数据模型
│   ├── repository/         # 数据访问层
│   ├── service/            # 业务逻辑层
│   ├── handler/            # HTTP 处理器
│   ├── socks5/             # SOCKS5 实现
│   ├── scheduler/          # 调度引擎
│   ├── agent/              # Agent 逻辑
│   ├── warp/               # WARP 管理
│   ├── unlock/             # 解锁检测
│   └── config/              # 配置管理
├── pkg/
│   ├── logger/             # 日志工具
│   ├── cache/              # 缓存封装
│   └── utils/              # 工具函数
├── web/                    # 前端代码
│   ├── src/
│   ├── package.json
│   └── vite.config.ts
├── deployments/
│   ├── docker-compose.yml
│   └── Dockerfile.*
├── scripts/
│   ├── migrate.sh
│   └── deploy.sh
├── configs/
│   ├── scheduler.yaml
│   ├── agent.yaml
│   └── admin.yaml
├── docs/
│   └── api.md
├── go.mod
├── go.sum
├── Makefile
└── README.md

---

当前进度

• 需求文档整理
• 项目初始化
• 数据库设计
• 调度中心开发
• 节点 Agent 开发
• 管理面板开发
• 测试与部署

---

最后更新: 2024-01