proxira

Transparent proxy, visible.

把本地发出的请求
看得清清楚楚

面向本地开发联调的代理与观测工具。把前端、SDK、脚本的请求统一指向它, 再用面板实时查看请求、响应、耗时与错误。

npx proxira
GitHub
terminal
╭───────────────────  Proxira  ───────────────────╮
│ Proxy: http://localhost:3000/proxira            │
│ Host: 127.0.0.1                                 │
│ Dashboard: http://localhost:3000/_proxira/ui    │
│ Target: http://localhost:8080                   │
│ Data Dir: ~/Library/Application Support/Proxira │
╰─────────────────────────────────────────────────╯
MIT 开源Node ≥ 20一条命令启动面板零配置

核心能力

它只做三件事,做完就退到一边

透明转发

Method / Path / Query / Headers / Body 原样送达上游。默认不改任何东西——观测是加分项,不是副作用。

实时观测

SSE 推送,面板实时更新。时间精确到毫秒,支持状态、方法筛选与耗时排序,慢在哪一眼看到。

拦截与改写

请求头分组、Mock 分组、故障注入都在面板里配。命中即生效,业务代码一行不用改。

Proxira 面板:左侧请求列表,右侧请求详情

左栏

请求列表按时间倒序,支持状态、方法筛选与耗时排序。

右栏

详情按「时间 → 请求 → 响应 → 来源」的阅读顺序铺开,时间给到毫秒。

新请求提示

来了新请求只在底部浮出一条提示,点了才跳,不抢你正在看的那条。

三步上手

30 秒跑起来

01

不需要安装,也不需要配置文件。

npx proxira
02

把联调的请求地址指到代理入口。

http://localhost:3000/proxira
03

打开面板,请求会实时进来。

http://localhost:3000/_proxira/ui

先说清楚

它不是什么

把这些写在前面,是因为「为什么抓不到」比「怎么用」更容易浪费时间。

不支持 WebSocket

HTTP Upgrade 类协议握手返回 501,不静默降级成普通请求。要调试 WebSocket 请直连上游。

不接管系统代理

只监听自己的端口,不会改写系统网络设置——需要你手动把请求地址指过来。

不解密 HTTPS 上游

--https 只作用于「客户端到代理」这一段,转发给上游的请求仍是你原来的请求。

不要暴露到公网

面板能查看完整请求与响应正文,也能改上游地址。它定位是本地开发调试工具。

进阶

用顺手之后,还有这些

HTTPS 调试

一键生成自签名证书并启用 HTTPS。

局域网共享

--host 开放到局域网,横幅直接给出可发给同事的地址。

访问令牌

--token 保护内部 API 与 SSE,未授权一律 401。

重放与差异对比

改完参数直接重发上游,与原响应逐行 diff。

敏感信息脱敏

authorization / cookie 等默认打码,可一键切回原文。

导出与复制

历史记录导出 JSON,详情一键复制 URL、Headers、Body、cURL。

现在就装上看看

不需要注册,不需要配置文件。一条命令,面板就在浏览器里了。

npx proxira
读用法