local_proxy_pool

项目概述

本项目是一个基于 FastAPI + Vue3 的代理池管理系统，主要用于通过订阅链接获取服务商提供的代理池数据，并通过 mihomo 工具启动本地代理池服务。系统支持对代理池进行增删改查操作，方便用户管理和使用代理服务器。

核心功能

1. 订阅管理

• 用户可以通过 API 添加订阅链接。
• 系统会自动解析订阅链接中的代理服务器信息，并将其存储到数据库中。

2. 代理池管理

• 随机获取代理：通过 /get 接口可以随机获取一个代理，支持过滤仅返回支持 HTTPS 的代理。
• 删除代理：通过 /delete 接口可以删除指定的代理。
• 添加代理：通过 /add 接口可以手动添加新的代理。
• 查看所有代理：通过 /all 接口可以获取当前所有的代理列表。
• 统计代理数量：通过 /count 接口可以查看当前代理池中的代理数量。

3. 本地代理池启动

• 使用 mihomo 工具启动本地代理池服务，方便开发和测试。

技术实现

后端实现细节

后端基于 FastAPI 框架开发，主要功能模块包括：

1. 生命周期管理：

   • lifespan(app: FastAPI) 函数用于管理应用的启动和关闭流程，确保资源的正确初始化和释放。

2. 健康检查：

   • health_check() 函数提供了一个健康检查接口，用于验证服务是否正常运行。

3. API 接口：

   • root() 函数定义了根路径接口，返回 API 的基本介绍。
   • get_random_proxy() 函数实现了随机获取代理的功能，支持根据需求过滤代理类型。

4. Mihomo 相关路由：

   • POST /mihomo/start: 启动 Mihomo 代理。
   • POST /mihomo/start-each-provider: 启动每个服务商的代理。
   • POST /mihomo/stop: 停止指定的 Mihomo 代理。
   • GET /mihomo/status: 获取当前运行的 Mihomo 状态。
   • GET /mihomo/reachability: 检查代理的可达性。
   • POST /mihomo/reachability/start-all: 启动所有代理的可达性检查。
   • GET /mihomo/controller-urls: 获取控制器 URL 列表。
   • POST /mihomo/stop-all: 停止所有 Mihomo 代理。

5. 订阅相关路由：

   • POST /subscriptions/add: 添加订阅链接。
   • GET /subscriptions/list: 列出所有订阅。
   • GET /proxies/list: 列出所有代理。

进程管理

系统通过 ProcessManager 类管理子进程，主要功能包括：

• 启动子进程: start_process(command: str, process_name: str) 方法用于启动一个子进程并记录其 PID。
• 停止子进程: stop_process(process_name: str) 方法用于停止指定名称的子进程。
• 停止所有子进程: stop_all_processes() 方法用于停止所有子进程。

数据库设计

• 系统使用数据库存储代理池数据和订阅链接信息，确保数据的持久化和高效查询。

当前状态

• 后端: 已完成
• 前端: 尚未开始

后续计划

• 完成前端开发
• 进行整体测试和部署