正向还是反向?Proxelar两种代理模式选型指南与本地调试场景全解

原创2026-10-16 06:52:021,962 阅读

正向还是反向?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,流量就会实时出现在界面上。

Proxelar正向代理模式下捕获的HTTP流量列表界面

正向代理模式下,每条请求的路径、方法、状态码、大小与耗时一目了然

HTTPS 流量如何"看得见"?

Proxelar 内置本地 CA(证书颁发机构):对 HTTPS 请求,它会自动为目标域名签发叶子证书并终结 TLS,从而看到解密后的明文内容。首次使用时访问 http://proxel.ar(流量需经过 Proxelar)即可下载并安装信任证书。

Proxelar生成本地CA证书的终端界面

正向代理的典型场景

  • 🔍 检查浏览器、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 头改写为目标。

Proxelar Web 界面中填写本地代理地址并启动捕获

反向代理能"加料"什么?

配合 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 步决策法:

  1. 要调试的对象是"别人的服务/App" → 正向代理
  2. 要调试的对象是"你自己写、跑在本地的服务" → 反向代理
  3. 既要看流量又要改流量,且对象是本地服务 → 反向代理 + Lua 脚本

四种界面,按习惯选用

无论选哪种模式,捕获到的流量都可以通过 4 种界面查看:

proxelar -i tui       # 终端 TUI(默认)
proxelar -i terminal  # 纯终端输出
proxelar -i gui       # 浏览器 Web GUI(http://localhost:8081)
proxelar -i api       # 无头 REST API,适合自动化

Proxelar终端TUI界面演示

Proxelar Web GUI界面演示

进阶:不止两种模式

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 中的模式实现源码,把本地调试效率再提一档。

登录后查看全文
proxelar