1. 项目定位与用途
proxy-fleet 是基于 Python 标准库开发的命令行工具，专为多 VPS 代理节点集中管理场景设计，核心能力是统一管理多台 VPS 上的 3x-ui 代理服务，支持一键部署 VLESS+Reality 协议节点，自动生成并实时同步 Clash/Mihomo 格式的订阅链接，无需手动逐个配置节点和更新订阅。
项目档案命令行工具
proxy-fleet：多VPS代理节点一键管理工具，支持3x-ui部署与Clash订阅自动同步
proxy-fleet 是基于 Python 的命令行工具，用于集中管理多台 VPS 上的 3x-ui 代理节点，支持一键部署 VLESS+Reality 服务、自动生成并同步 Clash/Mihomo 订阅链接，简化多节点代理运维流程，本文档涵盖项目安装、
AI 总结
proxy-fleet 是基于 Python 标准库的命令行工具，用于集中管理多台 VPS 代理节点，支持一键部署 3x-ui + VLESS+Reality 服务，自动生成并同步 Clash/Mihomo 订阅链接，简化多节点代理运维流程。
中文项目介绍
proxy-fleet 是面向多 VPS 代理运维场景的命令行管理工具，核心用途是统一管理分散在不同 VPS 上的 3x-ui 代理节点，降低多节点部署、配置、运维的门槛。
它解决了多 VPS 代理节点分散管理、手动配置易出错、订阅链接无法自动同步更新的痛点：传统方式每新增一台 VPS 都需要单独安装面板、配置协议、手动更新订阅，节点多了之后运维成本极高。
适用场景包括个人用户统一管理多个海外 VPS 代理节点、为小范围用户提供自动更新的代理订阅服务、快速部署基于 3x-ui 的 VLESS+Reality 节点、按 AI 服务、流媒体等类型配置智能流量路由规则。
从仓库信息可见，该工具仅依赖 Python 3.8+ 标准库与本地 curl，无需额外 pip 依赖，通过 SSH 密钥连接 VPS，支持一键部署、并行健康检查、NAT 端口自动选择、模块化路由规则管理，生成的 Clash 订阅文件可托管在 VPS 的 nginx 服务上供客户端使用。
详细信息与使用说明
2. 解决的问题
传统多 VPS 代理运维模式下，每新增一台节点需要单独登录 VPS 安装 3x-ui 面板、手动配置 VLESS+Reality 参数、开放防火墙、手动更新订阅链接，节点数量增多后运维成本极高，且容易出现配置不一致、订阅与实际节点不符的问题。proxy-fleet 将上述流程整合为单条命令，自动处理端口冲突检测、防火墙配置、订阅同步等繁琐操作，解决多节点分散管理的效率痛点。
3. 适用场景
1. 个人用户统一管理多个海外 VPS 代理节点，降低运维成本；2. 为小范围团队或用户提供自动更新的代理订阅服务；3. 快速批量部署基于 3x-ui 的 VLESS+Reality 代理节点；4. 按 AI 服务、流媒体、通用代理等类别配置智能流量路由规则，满足差异化访问需求。
4. 安装方式
1. 确保本地环境已安装 Python 3.8+ 和 curl 工具；2. 提前通过 SSH 密钥配置对目标 Debian/Ubuntu VPS 的访问权限，可在 ~/.ssh/config 中配置主机别名；3. 克隆仓库到本地：git clone https://github.com/oaker-io/proxy-fleet.git，进入项目目录；4. 运行交互式初始化命令 python3 scripts/fleet.py init，根据提示生成实际使用的 config.json 配置文件。
5. 使用方式
工具提供 init、status、deploy、remove、sync 五类核心命令：init 用于交互式生成配置文件；deploy 支持部署到一台或多台 VPS，可通过 --name、--emoji 自定义节点显示名称，通过 --nat 参数指定 NAT 环境下的端口扫描范围；status 可并行检查所有节点的健康状态与流量统计；remove 用于从订阅中移除指定节点；sync 用于从所有节点拉取实时配置重新生成并上传订阅文件。编辑 templates/rules/ 目录下的路由规则文件后，运行 sync 即可使规则生效。
6. 补充说明与实现特点
1. 工具仅依赖 Python 标准库，无需安装额外 pip 依赖；2. 部署流程自动扫描端口冲突、适配 ufw/iptables 防火墙、生成 x25519 密钥，兼容 Xray v26 及更早版本的密钥格式；3. 订阅文件可托管在任意 VPS 的 nginx + SSL 服务上，用户通过订阅 URL 即可在 Clash Verge Rev、Mihomo 等客户端获取最新节点列表与路由规则；4. 代理分组覆盖 AI 服务、通用代理、流媒体、国内直连四类，支持灵活调整路由策略。
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
imraywang/proxy-fleet 是做什么的？
proxy-fleet 是基于 Python 标准库的命令行工具，用于集中管理多台 VPS 代理节点，支持一键部署 3x-ui + VLESS+Reality 服务，自动生成并同步 Clash/Mihomo 订阅链接，简化多节点代理运维流程。
imraywang/proxy-fleet 适合用在什么场景？
proxy-fleet 是基于 Python 标准库开发的命令行工具，专为多 VPS 代理节点集中管理场景设计，核心能力是统一管理多台 VPS 上的 3x-ui 代理服务，支持一键部署 VLESS+Reality 协议节点，自动生成并实时同步 Clash/Mihomo 格式的订阅链接，无需手动逐个配置节点和更新订阅。
imraywang/proxy-fleet 如何安装？
1. 确保本地环境已安装 Python 3.8+ 和 curl 工具；2. 提前通过 SSH 密钥配置对目标 Debian/Ubuntu VPS 的访问权限，可在 ~/.ssh/config 中配置主机别名；3. 克隆仓库到本地：git clone https://github.com/oaker-io/proxy-fleet.git，进入项目目录；4. 运行交互式初始化命令 python3 scripts/fleet.py init，根据提示生成实际使用的 config.json 配置文件。
imraywang/proxy-fleet 如何开始使用？
工具提供 init、status、deploy、remove、sync 五类核心命令：init 用于交互式生成配置文件；deploy 支持部署到一台或多台 VPS，可通过 --name、--emoji 自定义节点显示名称，通过 --nat 参数指定 NAT 环境下的端口扫描范围；status 可并行检查所有节点的健康状态与流量统计；remove 用于从订阅中移除指定节点；sync 用于从所有节点拉取实时配置重新生成并上传订阅文件。编辑 templates/rules/ 目录下的路由规则文件后，运行 sync 即可使规则生效。