一个基于 Rust 构建的高性能、多功能 HTTP 代理服务器,使用 hyper、axum 和 rustls 实现。
- 正向代理:支持 HTTP/HTTPS 代理,可通过用户名密码认证
- HTTPS MITM:可使用自定义 CA 动态签发目标域名证书并解密转发;管理面板支持 Stub 规则:按 URL 或正则匹配,返回静态响应、转发到替代上游或仅修改请求/响应头,配置文件规则优先级最高、UI 规则可排序并持久化、Header 修改顺序累积,可输入 URL 查看各规则是否生效(详见 HTTPS MITM)
- 反向代理:支持灵活配置反向代理路由规则(详见 反向代理)
- 链式代理:通过
--forward-bypass-url指定上游代理服务器。父代理 CONNECT 握手(发送请求及读取响应头)总超时为 30 秒,响应头(含状态行)上限为 32 KiB;隧道数据不计入此上限。 - websocket: 正向代理和反向代理均支持websocket
- 类 Nginx 托管:完整的静态资源托管能力(详见 静态文件托管)
- 压缩支持:自动 gzip 压缩,减少传输流量
- 断点续传:支持 Accept-Ranges 和断点续传(单 range)
- 防盗链:基于 Referer 请求头的图片防盗链功能
- TLS 加密代理:支持
--over-tls参数,对正向代理流量进行 TLS 加密(详见 TLS/SSL 配置) - 自动证书加载:每天自动重新加载 TLS 证书,支持 ACME 证书自动续期,无需重启服务
- 高匿代理:完整实现高匿代理,去除代理特征(详见 高匿代理实现)
- 访问控制校验:无效的 Basic 认证用户或 CIDR 白名单会导致启动失败。静态托管与反向代理在路由前统一校验请求路径,拒绝歧义路径;静态文件解析后必须位于托管根目录内。
- Prometheus 集成:提供完整的 Prometheus metrics 导出(详见 可观测性与监控)
- 网速监控:Linux 平台支持实时网卡流量监控(
/net路径) - eBPF 支持:可选 eBPF socket filter 进行高性能流量统计
- Grafana 大盘:提供开箱即用的 Grafana 模板
- 多端口、多用户:支持同时监听多个端口,配置多个用户认证
- 连接管理:10 分钟空闲自动关闭连接,节省资源
- 跨平台:支持 Linux、macOS、Windows,提供 Windows 服务模式
curl -SLf https://us.arloor.dev/https://github.com/arloor/rust_http_proxy/releases/download/latest/rust_http_proxy -o /tmp/rust_http_proxy
install /tmp/rust_http_proxy /usr/bin/rust_http_proxy
/usr/bin/rust_http_proxy -p 7788# 标准版本
docker run --rm -it --net host --pid host quay.io/arloor/rust_http_proxy -p 7788
# eBPF 增强版本
docker run --rm -it --privileged --net host --pid host quay.io/arloor/rust_http_proxy:bpf_static -p 7788💡 Docker 镜像通过 GitHub Actions 自动构建,始终保持最新版本
# 克隆仓库
git clone https://github.com/arloor/rust_http_proxy.git
cd rust_http_proxy
# 标准编译
cargo build --release
# eBPF 增强版本(需要额外依赖,见 docs/cargo-features.md)
cargo build --release --features bpf_vendored启动服务后,使用 curl 测试:
# 测试正向代理(HTTP)
curl http://ip.im/info -x http://localhost:7788
# 测试正向代理(HTTPS + 认证)
curl https://ip.im/info -U "username:password" -x https://localhost:7788 --proxy-insecure各功能的详细介绍和配置说明拆分在 docs/ 目录下的独立文档中:
| 文档 | 内容 |
|---|---|
| 命令行参数 | 全部命令行参数说明 |
| TLS/SSL 配置 | 证书生成与配置、--over-tls TLS 加密代理 |
| HTTPS MITM | MITM 配置、管理面板与实时明文查看(断线重连自动同步、历史浏览保留窗口)、Stub 响应 |
| 静态文件托管 | 静态资源托管、Basic 认证、缓存控制、基于域名和路径的高级配置 |
| 反向代理 | 反向代理规则、upstream 配置项、GitHub 资源代理、快捷反向代理 |
| 可观测性与监控 | Prometheus metrics、Grafana 大盘、实时网速监控 |
| Cargo Features | eBPF 增强、jemalloc、aws-lc-rs 编译特性 |
| 高匿代理实现 | 代理特征清除与抓包验证 |
| Windows 服务模式 | Windows 服务的编译、安装与管理 |
| 容器化开发 | 本地构建与测试容器镜像 |
| 客户端推荐 | 兼容的代理客户端 |
| RPM 打包 | RPM 打包说明 |
本项目采用双许可证:
欢迎提交 Issue 和 Pull Request!
- GitHub Issues: arloor/rust_http_proxy/issues
- 项目主页: github.com/arloor/rust_http_proxy
⭐ 如果这个项目对你有帮助,请给一个 Star!
MITM UI 支持浏览器工具栏弹出框:配置服务连接、查看连接状态、管理目标域名后缀和编辑 Stub 规则。Web 管理页继续保留。
cd mitm-ui
npm ci
npm run build:extension在 edge://extensions 或 chrome://extensions 开启开发者模式,选择“加载解压缩的扩展”,加载 mitm-ui/dist-extension 目录。固定扩展图标后点击它,填写服务地址(例如 https://127.0.0.1:444)以及服务端 Basic Auth 用户名和密码,点击“保存并连接”,按浏览器提示授予该服务地址访问权限。连接成功后,工具栏弹出框直接展示 Stub 规则。
- 需要 Chrome / Edge 116 或以上版本;两者使用同一份构建产物。
- 工具栏弹出框在同一页展示 Stub 规则、可展开的域名后缀管理和连接设置,不提供完整管理页入口或明文抓取开关。域名后缀支持添加、启停和删除,启动参数管理的后缀不可删除;没有已启用后缀时自动展开。展开或收起后缀管理不会丢失当前 Stub 编辑内容。Stub 生效需 CA 可用、客户端信任 CA,并启用覆盖请求域名的后缀;后缀变更仅影响新连接,请重新建立连接。连接状态显示在标题栏,支持下载 CA 证书;连接失败时提供 HTTPS 证书信任排查提示。保存连接设置后自动重载规则和后缀。工具栏弹出框使用浏览器允许的最大尺寸 800 × 600。点击弹出框外部会关闭它,未保存的编辑会丢失。
- 地址填写服务的 origin,不包含
/mitm/路径。扩展按需请求所选服务主机的访问权限,浏览器的主机授权不区分端口。 - 地址和用户名保存在本机;密码只保存在浏览器会话内存中,重启浏览器、重载或更新扩展后需重新输入。切换服务或认证信息后,请关闭旧管理页并重新打开。
- 扩展仍需连接运行中的 Rust 代理服务;它不自动修改浏览器代理设置,也不安装 CA。请按 HTTPS MITM 配置流量代理及证书信任。服务端 HTTPS 证书须被浏览器信任,扩展不能使用 Vite 的
secure: false跳过校验。 - “明文抓取”开关修改服务端共享设置;由
--mitm-dump锁定时不可切换。关闭弹窗或管理页不会停止服务端抓包。 - 扩展构建输出与 Web 构建分离;
npm run build仍生成原来的mitm-ui/dist。
CI 会先测试并重新构建 Web UI,再将生成的 mitm-ui/dist 嵌入 Rust 二进制。推送 release 或 release/* 分支时,即使仓库中的 dist 未同步更新,也会使用当次构建产物继续发布;UI 测试或构建失败仍会中止发布。PR 构建保留 dist 一致性检查,前端变更请同时提交 npm run build 生成的产物。
Release 流程会独立构建并上传 rust-http-proxy-mitm-extension-v<版本号>.zip,Chrome 和 Edge 共用。ZIP 内的 manifest.json 位于根目录,其版本号取自 rust_http_proxy/Cargo.toml。下载后先解压,再在浏览器扩展管理页选择“加载解压缩的扩展”,指向解压目录;这不是商店自动安装包。
本地生成同样的发行包(需要 Python 3.9+):
cd mitm-ui
npm ci
npm run package:extension
# 输出:mitm-ui/release/rust-http-proxy-mitm-extension-v<版本号>.zipPR 构建也会验证并上传扩展工件;推送 release 或 release/* 分支时,ZIP 会和三个 Rust 二进制一起附加到 GitHub Release。开发构建的版本号保留在源 manifest 中,打包时仅覆盖 ZIP 内的版本号。
扩展工具栏、管理列表、弹窗和标签页使用统一的青绿色 M / 连接节点图标。图标位于 mitm-ui/extension/icons/,含 16、32、48、128 像素 PNG;修改图标生成脚本后,可使用安装了 Pillow 的 Python 执行 python3 mitm-ui/scripts/generate-extension-icons.py 重新生成。CI 直接使用已提交的 PNG,无需安装图形依赖。