Skip to content

About

基于Rust的正向代理、反向代理和静态资源托管。 forward proxy、reverse proxy and static file serving

Topics

Resources

Stars

60 stars

Watchers

1 watching

Forks

Latest commit

 

History

1,817 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rust HTTP Proxy

Open in GitHub Codespaces Ask DeepWiki

一个基于 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 服务模式

安装使用

方式一:Linux AMD64 可执行文件

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 运行(推荐)

# 标准版本
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!

📮 联系方式


⭐ 如果这个项目对你有帮助,请给一个 Star!

Chrome / Edge 扩展

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<版本号>.zip

PR 构建也会验证并上传扩展工件;推送 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,无需安装图形依赖。

About

基于Rust的正向代理、反向代理和静态资源托管。 forward proxy、reverse proxy and static file serving

Topics

Resources

Stars

60 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages