ProxyPin：覆盖五大操作系统的 HTTP 抓包工具，从构建到抓到第一个请求只要5分钟
【免费下载链接】network_proxy_flutterOpen source free capture HTTP(S) traffic software ProxyPin, supporting full platform systems项目地址: https://gitcode.com/GitHub_Trending/ne/network_proxy_flutter
ProxyPin 是一款开源免费的抓包工具，基于 Flutter 开发，Windows、macOS、Linux、Android、iOS 五个平台通用，核心能力是拦截、查看和重写 HTTP(S) 流量。本文按一次完整调试任务的顺序，演示如何启动服务、在请求列表里定位问题、对流量做修改，以及把手机流量接入桌面端列表。
🚀 第一步：启动服务，抓到第一个请求
获取一个可运行的版本
已有 Flutter 环境的话，3 条命令启动：
git clone https://gitcode.com/GitHub_Trending/ne/network_proxy_flutter cd network_proxy_flutter && flutter pub get flutter run -d windows没有 Flutter 环境可以直接下载对应平台的安装包，跳过构建这一步。macOS、Linux、Android 只需替换-d windows为对应设备标识。
开代理、装证书
启动后点击顶部的开始按钮，代理服务默认监听 9099 端口，并自动写入系统代理，本机 HTTP 流量会直接转发过来。要看 HTTPS 内容，再进设置里的证书页面安装 ProxyPin 自带的 CA 证书，之后 HTTPS 请求在列表里以明文展示。启动完成后随便打开一个网页，10 秒内列表就会出现第一条请求，点进去可以看到原始请求头、请求体和响应内容。
🔍 第二步：在几十条请求里定位到目标
域名过滤：只抓你要调试的接口
机器上其他应用的流量会污染列表。在设置里把目标域名加进域名过滤器后，其他域名的请求根本不会进列表，相当于只抓当前要调试的那几个接口，其余流量不受任何影响。
按条件搜索：500 错误一眼可见
列表上方支持按关键词、HTTP 方法、响应类型、状态码组合搜索。比如勾选"状态码含 500"，失败的请求立即浮现，点开直接读原始响应，不用重新发请求、不用翻服务端日志，接口 HTTP 调试中最常见的"返回不对"问题基本都能在这一步定位。
收藏与历史记录
重要请求点一下收藏，下次不会被淹没在新批次里。抓包数据自动保存进历史记录，支持导出 HAR 格式存档、发给同事，也能再导入回来继续分析。
✏️ 第三步：不改业务代码，直接修改流量
重写与屏蔽
想固定某个请求头或替换响应体，在"请求重写"里加规则即可：支持重定向到另一个地址、替换请求或响应报文。"请求屏蔽"则按 URL 拦截请求，匹配到的请求根本不会发往服务器，调试时用来关掉统计、广告等无关请求很方便。
请求映射：本地直接返回响应
"请求映射"解决"远程接口还不存在"的问题：配置映射规则后，匹配的请求直接用本地配置或脚本输出来响应，不走真实网络。后端接口没联调完时，前端可以拿本地映射继续开发页面。
脚本处理与 AES 解密
内置 JS 脚本引擎（实现见 lib/network/components/js/）可以编写脚本拦截并修改请求、响应，覆盖重写规则表达不了的场景。业务侧如果用了 AES 加密消息体，在"请求解密"里填上密钥，工具会自动把加密切片的正文解出来展示。
📱 第四步：把手机流量接到桌面端
扫码连接，不手配 WiFi 代理
调试 App 网络问题，通常要手动给手机配代理。ProxyPin 的"手机连接"面板会生成一个二维码，手机端的 ProxyPin 扫码后自动把代理指到桌面端的局域网 IP 和端口，域名过滤等配置也一并同步过去，不用手敲 IP。
手机代理连不上怎么排查
- 手机和电脑必须在同一局域网，面板上的"本地 IP"下拉框可以切换电脑网卡，确认不是 127.0.0.1
- 部分 App 强制证书或只走系统代理，先换浏览器验证链路是否通
- 浏览器出现证书告警，说明 CA 证书没装好，回证书页面重装一次
🖥️ 平台差异与常见坑
macOS 首次打开授权设置
第一次启动会提示"不受信任的开发者"。进入"系统设置 → 隐私与安全性"，点击"仍要打开"完成授权，之后正常启动。
Windows 与 Linux
Windows 直接运行即可开始抓包，若防火墙弹窗拦截，给应用放行；Linux 同样用flutter run -d linux启动，无额外配置。
Android 与 iOS
手机端主要作为"连接端"，安装 ProxyPin 手机 App 后扫码接入。移动端自己也能抓本设备流量，底层走系统网络扩展，iOS 实现 与桌面端共享同一套抓包核心 lib/network/。
ProxyPin 是一个覆盖五个平台的开源免费抓包工具，功能清单与下载入口见中文 README。从下一个要调试的接口开始，按启动、定位、修改三步走完一遍流程，你就能掌握它的核心用法。
【免费下载链接】network_proxy_flutterOpen source free capture HTTP(S) traffic software ProxyPin, supporting full platform systems项目地址: https://gitcode.com/GitHub_Trending/ne/network_proxy_flutter
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
