正向还是反向?Proxelar两种代理模式选型指南与本地调试场景全解
正向还是反向?Proxelar两种代理模式选型指南与本地调试场景全解
Proxelar 是一款可脚本化的本地流量工作台,能对 HTTP/HTTPS 与 WebSocket 流量进行捕获、检查、拦截、回放和重写。本文带你弄懂它最核心的两个代理模式——正向代理(Forward Proxy) 与 反向代理(Reverse Proxy) 的适用边界,让你 3 分钟选对本地调试方案。
两种模式,一张图看懂
先记住这条数据流向,所有选型的判断都基于它:
正向代理: 你的 App ──► Proxelar :8080 ──► 目标服务器(App 需配置代理)
反向代理: 客户端 ──► Proxelar :8080 ──► 你的后端服务(客户端无需配置代理)
- 正向代理:客户端主动"找上门",把流量交给 Proxelar 转发。适合"我想看某个 App 到底在发什么包"。
- 反向代理:Proxelar 站在你本地服务前面当"门卫",所有请求先经过它再转到真实后端。适合"我想给本地 API 加料、改包、造故障"。
正向代理:抓包检查的首选模式
正向代理是 Proxelar 的默认模式,直接运行即可启动:
proxelar
然后把浏览器、curl 或目标 App 的 HTTP/HTTPS 代理指向 127.0.0.1:8080,流量就会实时出现在界面上。
正向代理模式下,每条请求的路径、方法、状态码、大小与耗时一目了然
HTTPS 流量如何"看得见"?
Proxelar 内置本地 CA(证书颁发机构):对 HTTPS 请求,它会自动为目标域名签发叶子证书并终结 TLS,从而看到解密后的明文内容。首次使用时访问 http://proxel.ar(流量需经过 Proxelar)即可下载并安装信任证书。
正向代理的典型场景
- 🔍 检查浏览器、App、
curl发出的每一个请求与响应 - 🔍 排查接口联调时"到底是谁改了参数"
- 🔍 拦截并手动编辑请求/响应后再放行、丢弃或重放
模式原理与常用参数详见 docs/src/proxy-modes/forward.md。
反向代理:本地 API 调试的最快配置方法
反向代理只需一条命令,客户端完全不用配置代理:
proxelar -m reverse --target http://localhost:3000
客户端照常访问 http://127.0.0.1:8080,Proxelar 会把请求原样(保留 path 和 query)转发到 localhost:3000,并把 Host 头改写为目标。
反向代理能"加料"什么?
配合 Lua 脚本(on_request / on_response 钩子),常见玩法:
| 玩法 | 效果 | 现成示例脚本 |
|---|---|---|
| 注入认证头 | 自动带上 Authorization: Bearer dev-token |
auth_inject.lua |
| Mock 接口 | 只拦截某个 URL 返回假数据,其余透传 | mock_api.lua |
| 加 CORS 头 | 解决前端本地跨域报错 | inject_cors.lua |
| 模拟故障 | 对指定路径返回 500/503,测试前端容错 | modify_json_response.lua |
更多脚本集中在 examples/scripts/,完整教程见 docs/src/guides/reverse-proxy-mocking.md。
一张对比表:快速选型
| 维度 | 正向代理(forward) | 反向代理(reverse) |
|---|---|---|
| 启动命令 | proxelar |
proxelar -m reverse --target http://localhost:3000 |
| 客户端是否需要配代理 | ✅ 需要 | ❌ 不需要 |
| 能否看到任意第三方域名流量 | ✅ 可以 | ❌ 只针对指定 target |
| 典型用途 | 抓包、检查、重放 | 本地 API 调试、Mock、注入头 |
| 支持 HTTP/2 / HTTP/3 | HTTP/1、HTTP/2 | 额外支持 HTTPS/HTTP/3 目标 |
3 步决策法:
- 要调试的对象是"别人的服务/App" → 正向代理
- 要调试的对象是"你自己写、跑在本地的服务" → 反向代理
- 既要看流量又要改流量,且对象是本地服务 → 反向代理 + Lua 脚本
四种界面,按习惯选用
无论选哪种模式,捕获到的流量都可以通过 4 种界面查看:
proxelar -i tui # 终端 TUI(默认)
proxelar -i terminal # 纯终端输出
proxelar -i gui # 浏览器 Web GUI(http://localhost:8081)
proxelar -i api # 无头 REST API,适合自动化
进阶:不止两种模式
Proxelar 还内置了更多捕获模式,可组合使用:
- WireGuard 模式:手机/物联网设备免配代理直接抓包,扫码即用
- SOCKS5 模式:
proxelar -m socks5 -p 1080,兼容只支持 SOCKS 的客户端 - DNS 模式:记录并重写 DNS 查询,把指定域名指到
127.0.0.1
各模式命令详见 docs/src/proxy-modes/wireguard-socks-dns.md,CLI 全参数见 README.md。
总结
- 🎯 看流量、抓包、重放 → 正向代理,一条
proxelar搞定 - 🎯 调试自己的本地服务、Mock 接口 → 反向代理,
-m reverse --target即可 - 🎯 两者都想要 → 反向代理叠 Lua 脚本,流量"看得见、改得动"
按需 git clone 仓库 https://gitcode.com/gh_mirrors/pro/proxelar 查看 proxelar-cli/src/main.rs 与 proxyapi/src/proxy/mod.rs 中的模式实现源码,把本地调试效率再提一档。




