MirrorProxy

MirrorProxy 是自托管的统一软件源代理缓存服务，解决上游官方源访问不稳、第三方镜像不可靠、各种包管理器改源繁琐、CI构建随机失败的痛点。它不需要全量同步仓库，采用按需拉取+本地缓存模式，单服务统一接管各类开发源。

核心设计亮点

• 多上游故障转移：同一个源配置多条上游地址，自动熔断、健康巡检、超时切换备用节点
• 客户端配套工具：跨平台客户端，一键切换/回滚系统与包管理器源，不用手动修改各类配置文件
• 团队权限体系：OAuth/OIDC登录、三级流量配额、IP黑白名单、子域名隔离、审计日志、告警通知
• 离线GeoIP统计：访问IP本地解析归属，不调用外部定位接口；支持Prometheus指标、OTLP链路追踪
• 可平滑扩容：从个人自用极简模式，按需开启账号、配额、分权管理，不用迁移底层服务

覆盖生态（约30类内置适配器）

• 代码&发布：GitHub、GitHub Raw、Git HTTP克隆
• OCI容器：Docker Hub、GHCR、Quay、GCR、NVCR、MCR等
• 语言包：PyPI、npm、crates.io、Go Module、Maven、NuGet、Composer、RubyGems、Julia、CocoaPods等
• AI生态：Hugging Face（HTTP下载，默认不缓存）
• 系统发行版：Debian、Ubuntu、Arch、Alpine、Fedora、openEuler、Deepin、OpenWrt、Termux、MSYS2、ROS 等大量Linux/BSD发行版
• 工具源：Homebrew、WinGet、TeX Live、Nix、Flatpak、ELPA

特色能力

✅ 自定义HTTPS文件下载通道（默认关闭，管理员授权开启），带token、限速、域名黑名单，CLI与MCP均可调用，文件不灌入模型上下文
✅ MCP原生集成（重点）：支持 Cursor、Claude Code、Codex、Gemini CLI、WorkBuddy 等AI Agent；Agent可以查询源状态、生成对应的源配置命令、执行受控下载
✅ 出站代理、内部私有上游凭据、自定义CA，适配企业内网环境
✅ ACME自动HTTPS，兼容Caddy/Nginx/Traefik反向代理，部署方式包含 Docker Compose、系统二进制包、systemd

部署 & 客户端安装

服务端（Docker Compose）

MIRRORPROXY_ADMIN_PASSWORD='高强度密码' docker compose up -d

后台默认地址：http://localhost:3000/admin

客户端

macOS/Linux一键脚本：

curl -fsSL https://raw.githubusercontent.com/inbjo/MirrorProxy/main/scripts/install.sh | sh

Windows PowerShell：

irm https://raw.githubusercontent.com/inbjo/MirrorProxy/main/scripts/install.ps1 | iex

同时支持 Homebrew、winget、Debian APT 仓库安装。