Description
关于spy-debugger
一站式页面调试、抓包工具。远程调试任何手机浏览器页面，任何手机移动端webview（如：微信，HybridApp等）。支持HTTP/HTTPS，无需USB连接设备。
Language: English
特性
1、页面调试＋抓包
2、操作简单，无需USB连接设备
3、支持HTTPS。
4、spy-debugger内部集成了weinre、node-mitmproxy、AnyProxy。
5、自动忽略原生App发起的https请求，只拦截webview发起的https请求。对使用了SSL pinning技术的原生App不造成任何影响。
6、可以配合其它代理工具一起使用(默认使用AnyProxy) (设置外部代理)
使用案例
页面编辑模式
启动命令：
spy-debugger -w true
weiner页面调试界面
anyproxy抓包界面
安装
Windows 下
npm install spy-debugger -g
Mac 下
sudo npm install spy-debugger -g
三分钟上手
第一步：手机和PC保持在同一网络下（比如同时连到一个Wi-Fi下）
第二步：命令行输入spy-debugger，按命令行提示用浏览器打开相应地址。
第三步：设置手机的HTTP代理，代理IP地址设置为PC的IP地址，端口为spy-debugger的启动端口(默认端口：9888)。
- Android设置代理步骤：
设置 - WLAN - 长按选中网络 - 修改网络 - 高级 - 代理设置 - 手动 - iOS设置代理步骤：
设置 - 无线局域网 - 选中网络 - HTTP代理手动
第四步：手机安装证书。注：手机必须先设置完代理后再通过(非微信)手机浏览器访问http://s.xxx(地址二维码)安装证书（手机首次调试需要安装证书，已安装了证书的手机无需重复安装)。iOS新安装的证书需要手动打开证书信任
第五步：用手机浏览器访问你要调试的页面即可。
自定义选项
端口
(默认端口：9888)
spy-debugger -p 8888
设置外部代理（默认使用AnyProxy）
spy-debugger -e http://127.0.0.1:8888
spy-debugger内置AnyProxy提供抓包功能，但是也可通过设置外部代理和其它抓包代理工具一起使用，如：Charles、Fiddler。
设置页面内容为可编辑模式
该功能使页面内容修改更加直观方便。
(默认： false)
spy-debugger -w true
内部实现原理：在需要调试的页面内注入代码：document.body.contentEditable=true。暂不支持使用了iscroll框架的页面。
是否允许weinre监控iframe加载的页面
(默认： false)
spy-debugger -i true
是否只拦截浏览器发起的https请求
(默认： true)
spy-debugger -b false
有些浏览器发出的connect请求没有正确的携带userAgent，这个判断有时候会出错，如UC浏览器。这个时候需要设置为false。大多数情况建议启用默认配置：true，由于目前大量App应用自身（非WebView）发出的请求会使用到SSL pinning技术，自定义的证书将不能通过app的证书校验。
是否允许HTTP缓存
(默认： false)
spy-debugger -c true
调试HTTPS
运行代码
spy-debugger initCA启动后会在 C:\Users\Administrator\node-mitmproxy 下生成一个证书文件，把证书文件导入手机安装
手机安装完后执行命令
spy-debugger在打开 HTTPS 的页面就好了；
其他问题
踩坑1（针对ios）
如果按照官方教程来，第四步死活打不开官方所给的链接。
解决方法
- 先打开 跑完 spy-debugger命令后的网页，用相机扫描所给的二维码，并用safari浏览器打开；
- 修改safari打开后的url链接，把127.0.0.1改成本机的ip；
- 可以正常显示证书下载页面；
- 然后下载安装；
踩坑2（针对ios）
如果按官方教程来，进行到最后，仍会有如下的提示：
这是因为没有下载的证书完全信任导致。
解决方法：
通用 => 关于本机 => 证书信任设置 ，然后选择对应的证书信任即可。
即可愉快的调试了~
补充：
由于新版ios系统所致，证书需要在通用=>描述里面手动点击安装=>安装完后再进入关于本机的证书信任里点击信任才行
更多
-
修复
weinre在node.jsV7版本会崩溃的bug -
对
weinre在页面document ready事件前，无法打印console.log日志进行了增强修复。 -
增强
weinre打印未捕获异常(Uncaught Exceptions)功能。 -
spy-debugger原理是集成了weinre，简化了weinre需要给每个调试的页面添加js代码。spy-debugger原理是拦截所有html页面请求注入weinre所需要的js代码。让页面调试更加方便。