项目简介
这是一个基于 Node.js 的一站式页面调试、抓包工具,可远程调试任何手机浏览器页面以及手机移动端 webview(如微信、HybridApp 等)。支持 HTTP/HTTPS 协议,无需 USB 连接设备。项目内部集成了 weinre
、node-mitmproxy
、AnyProxy
,方便进行页面调试和抓包操作。
项目的主要特性和功能
- 支持页面调试与抓包。
- 操作简单,无需 USB 连接设备。
- 支持 HTTPS 协议。
- 自动忽略原生 App 发起的 HTTPS 请求,仅拦截 webview 发起的请求,不影响使用 SSL pinning 技术的原生 App。
- 可配合其他代理工具使用,默认使用 AnyProxy。
- 提供 weiner 页面调试界面和 AnyProxy 抓包界面。
- 支持设置页面内容为可编辑模式,使页面内容修改更直观方便。
安装使用步骤
安装
Windows
npm install spy-debugger -g
Mac
sudo npm install spy-debugger -g
安装证书
第一步:生成证书
spy-debugger initCA
// 证书生成在用户根目录的node-mitmproxy文件夹下
// 如: /Users/tenghuanjun/node-mitmproxy
第二步:安装证书
把node-mitmproxy文件夹下的 node-mitmproxy.ca.crt 传到手机上,点击安装即可。
使用
- 确保手机和 PC 处于同一网络(如连接到同一个 Wi-Fi)。
- 在命令行输入
spy-debugger
,按提示用浏览器打开相应地址。 - 设置手机的 HTTP 代理:
- Android:设置 - WLAN - 长按选中网络 - 修改网络 - 高级 - 代理设置 - 手动。
- iOS:设置 - 无线局域网 - 选中网络 - HTTP 代理手动。代理 IP 地址设置为 PC 的 IP 地址,端口为
spy-debugger
的启动端口(默认端口:9888)。
- 手机安装证书。注意:手机必须先设置完代理后,再通过(非微信)手机浏览器访问
http://s.xxx
(地址二维码)安装证书。手机首次调试需要安装证书,已安装的手机无需重复安装。 - 用手机浏览器访问要调试的页面。
自定义选项
端口(默认端口:9888)
spy-debugger -p 8888
设置外部代理(默认使用 AnyProxy)
spy-debugger -e http://127.0.0.1:8888
设置页面内容为可编辑模式(默认:false)
spy-debugger -w true
是否允许 weinre 监控 iframe 加载的页面(默认:false)
spy-debugger -i true
是否只拦截浏览器发起的 HTTPS 请求(默认:true)
spy-debugger -b false
是否允许 HTTP 缓存(默认:false)
spy-debugger -c true
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】