Transparent proxy, visible.
把本地发出的请求
看得清清楚楚
面向本地开发联调的代理与观测工具。把前端、SDK、脚本的请求统一指向它, 再用面板实时查看请求、响应、耗时与错误。
npx proxira╭─────────────────── 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 │ ╰─────────────────────────────────────────────────╯
核心能力
它只做三件事,做完就退到一边
透明转发
Method / Path / Query / Headers / Body 原样送达上游。默认不改任何东西——观测是加分项,不是副作用。
实时观测
SSE 推送,面板实时更新。时间精确到毫秒,支持状态、方法筛选与耗时排序,慢在哪一眼看到。
拦截与改写
请求头分组、Mock 分组、故障注入都在面板里配。命中即生效,业务代码一行不用改。

左栏
请求列表按时间倒序,支持状态、方法筛选与耗时排序。
右栏
详情按「时间 → 请求 → 响应 → 来源」的阅读顺序铺开,时间给到毫秒。
新请求提示
来了新请求只在底部浮出一条提示,点了才跳,不抢你正在看的那条。
三步上手
30 秒跑起来
装
不需要安装,也不需要配置文件。
npx proxira指
把联调的请求地址指到代理入口。
http://localhost:3000/proxira看
打开面板,请求会实时进来。
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