wuchangming/spy-debugger

微信调试，各种WebView样式调试、手机浏览器的页面真机调试。便捷的远程调试手机页面、抓包工具，支持：HTTP/HTTPS，无需USB连接设备。

关于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不造成任何影响。【PS：由于 iOS 15 调整代理协议，iOS 15 已无法检测请求是否浏览器发起】
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请求 【PS：由于 iOS 15 调整代理协议，已无法检测请求是否浏览器发起】

(默认： false)

spy-debugger -b true

有些浏览器发出的connect请求没有正确的携带userAgent，这个判断有时候会出错，如UC浏览器。这个时候需要设置为false。大多数情况建议启用默认配置：true，由于目前大量App应用自身（非WebView）发出的请求会使用到SSL pinning技术，自定义的证书将不能通过app的证书校验。

是否允许HTTP缓存

(默认： false)

spy-debugger -c true

更多

• 修复weinre在node.js V7版本会崩溃的bug

• 对weinre在页面document ready事件前，无法打印console.log日志进行了增强修复。

• 增强weinre打印未捕获异常(Uncaught Exceptions)功能。

• spy-debugger原理是集成了weinre，简化了weinre需要给每个调试的页面添加js代码。spy-debugger原理是拦截所有html页面请求注入weinre所需要的js代码。让页面调试更加方便。

spy-debugger's Issues

Cookie和缓存都无法修改或删除？

调试的时候这功能很重要

如果能实现断点调试功能就更好了！

如上，期待！

我又来了,在适用自定义请求头时,请求头信息为null?

一下午的时间都在找这个问题,开始以为是axios的问题,后来从代理ip环境切换的真实环境中,请求头信息可以带到后台,就是使用代理的时候请求头信息带不过去.

是否支持axios发起请求?

刚开始看到这个调试神器,一下子激动了一把,按照步骤一切正常,但是我的前端页面用是用axios发起的http请求,感觉所有的请求是发生了错误

这个是请求拦截的log,请大神过目!

访问线上无法抓包，只有加了host才可以，不知道为什么

必须有host，且在host 内的域名才能抓到，其他的都不行

证书链接都打不开。

证书链接都打不开。。更别说调试了。。

node 版本6.10.0 异常退出

node版本：6.10.0

2017-03-02T11:13:01.861Z spy-debugger: target t-2: weinre: target t-2 connected to client c-1
2017-03-02T11:13:02.562Z spy-debugger: client c-1: weinre: invocation exception on Object.childNodeCountUpdated(): TypeError: Cannot set property '_childNodeCount' of undefined
2017-03-02T11:13:02.578Z spy-debugger: client c-1: weinre: invocation exception on Object.childNodeInserted(): TypeError: Cannot read property '_insertChild' of undefined
internal/process/promises.js:72
            warning.stack = reason.stack;
                                  ^

TypeError: Cannot read property 'displayName' of undefined

iOS新安装的证书需要手动打开证书信任

iOS10.3.1 新安装的证书需要手动选择信任证书。

解决方式：

设置->通用->关于本机->证书信任设置-> 找到node-mitmproxy CA（打开）

你好，请问有类似 Charles 的 Map Remote 功能吗？在文档里没找到这方面的说明

我的手机浏览器打不开安装证书的网址？

连了同一个wifi，代理也设置了。就是打不开

map local功能

新增的替换内容不能直接修改，没有选择本地路径时需要重新从根目录开始，不太方便，可以优化下。
其他很棒

anyproxy不支持微信mmtls协议

微信mmtls协议

这个可以用手机调试我在pc上写的网页不

如果能的话具体怎么操作啊 不胜感激..

如何编译代码，想修改一下代码再运行

有没必要加一个选项，所有页面都注入vConsole？

如题

用yarn安装问题：npm postinstall的bug修复方式无效

扫码安装不了证书，报错 404

用手机扫码无法打开网址，报错404，spy-debugger 安装正常已打开，手机和电脑是同一网络，已打开VPN

希望添加NETWORK 中添加静态资源的请求

最近想看静态文件缓存的问题,所以发现spy-debugger中不想chrome中显示的那个详细.

微信开发新手请教

那怎么在微信里打开我的页面呀？要分享给自己微信帐号吗？谢谢

http://spydebugger.com/cert和二维码的地址都无效了。

http://spydebugger.com/cert和二维码的地址都无效了。

不显示外联的CSS样式

在使用weinre调试样式的时候，外联css文件中的样式没有在右侧显示出来，能帮忙看下什么问题吗

http://spydebugger.com/cert 失败

ping spydebugger.com
ping: cannot resolve spydebugger.com: Unknown host

为什么只能在电脑上调试，手机上面看啊，是不是我弄错了

为什么只能在电脑上调试，手机上面看啊，是不是我弄错了，还是就是这样的？求解答

电脑存在多网卡时，不能选择网卡

我的解决办法是禁用其他暂时不用的网卡，然后重新启动spy-debugger即可。
但是希望可以支持选择局域网网卡。

调试报错,也无法开发open.weixin.qq.com/类似的链接

不知道是不是升级的原因,现在已经无法调试了,报错如图,
环境:
node: 7.2
macOs

证书下载地址访问不到

证书下载地址访问不到 http://spydebugger.com/cert
希望可以提供个稳定的网盘地址之类的下载连接

https域代理在ios上安装了证书依旧无法使用

如何查看Timeline？

如题。

请问支持 ios 模拟器吗?

我看到快速上手的第三步, 但是模拟器设置里面没有无线这个选项

使用本地自定义域名时，代理请求失败

使用本地自定义域名时，代理请求失败，但我试了下charles是可以代理本地域名的

初步使用 反馈

环境： win7 + Android
能正常使用， 微信-- QQ浏览器 切换使用， 有些 报错 日志：
WiInspectorImpl.hideDOMNodeHighlight() : TypeError : 'off' undefined
Object().childNodeInserted() : TypeError : '_insertChild' undefined

欠缺功能：
1： 不能看 css js 源文件 (微信的weinre工具修改源文件会断开)
2：console -- jQuery document.querySelector() 查找DOM， 不能返回DOM结构

访问某个页面时,spy-debugger会自动断开

在有的页面是正常调试的,但是跳转到我的某一个页面 会出现这个问题,然后调试会自动断开.

问一下，我想抓包把本地的文件替换线上的文件能做到吗？

问一下，我想抓包把本地的文件替换线上的文件能做到吗？

document ready前执行的console.log无法输出日志

证书安装成功，页面调试没有页面

证书已经安装成功了。代理也都设置了
百度、京东的页面可以抓取到页面。

我们的网站抓包正常，但是页面调试不行，targets 是 none 报这个错误

node.js v8.1.3 浏览器是safari

{ ---------------------------------------------------------
error: Error: socket hang up
---------------------------------------------------------
stack:
   _http_client.js:344 - undefined()
   _http_client.js:376 - undefined()
         events.js:120 - undefined()
         events.js:210 - undefined()
            net.js:549 - undefined()
      _tls_wrap.js:350 - undefined()
         events.js:316 - undefined()
         events.js:115 - undefined()
         events.js:210 - undefined()
            net.js:549 - undefined() code: 'ECONNRESET' }

Can not find `CA certificate` or `CA key`. [TypeError: Object [object Object] has no method 'accessSync']

starting server at http://localhost:52381
CA Cert saved in: /Users/xuzhipeng/node-mitmproxy/node-mitmproxy.ca.crt
CA private key saved in: /Users/xuzhipeng/node-mitmproxy/node-mitmproxy.ca.key.pem
Can not find CA certificate or CA key. [TypeError: Object [object Object] has no method 'accessSync']

能设置一个开关调试原生APP的请求吗

如果能显示log打印时,所在的当前文件名称和行数就更棒了.

不知道实现起来困难不苦难,如果有这个显示,定位起来就更友好了.

weinre不能打印Error报错信息。

weinre不能打印Error报错信息。

苹果手机浏览器无法安装证书

用的的iphone6 plus，UC浏览器扫证书地址二维码，UC浏览器显示无法打开文件。同样操作步骤，安卓手机是正常的

[nodejs V7版本崩溃问题]我输入spy-debugger进入某一个页面就报错。然后自动退出当前spy-debugger的执行命令。

λ spy-debugger
(node:17776) DeprecationWarning: 'GLOBAL' is deprecated, use 'global'
正在启动代理
2016-11-03T09:48:35.681Z index.js: starting server at http://localhost:51610
node-mitmproxy启动端口: 9888
浏览器打开 ---> http://127.0.0.1:51615
2016-11-03T09:48:49.156Z index.js: target t-2: weinre: target t-2 connected to client c-1
2016-11-03T09:48:51.130Z index.js: target t-3: weinre: target t-3 connected to client c-1
2016-11-03T09:48:51.192Z index.js: target t-2: weinre: target t-2 disconnected from client c-1
D:\Program Files\nodejs\node_modules.spy-debugger_npminstall\node_modules.3.10.2@anyproxy\proxy.js:208
logUtil.printLog('Caught exception: ' + (err.stack || err), logUtil.T_ERR);
^

TypeError: Cannot read property 'displayName' of undefined

安装一直失败

C:\Users\Administrator>npm install spy-debugger -g
npm ERR! Windows_NT 6.1.7601
npm ERR! argv "D:\yangjing\nodejs\node.exe" "D:\yangjing\nodejs\node_modu
es\npm\bin\npm-cli.js" "install" "spy-debugger" "-g"
npm ERR! node v4.4.7
npm ERR! npm v2.15.8

npm ERR! shasum check failed for C:\Users\ADMINI~1\AppData\Local\Temp\npm-2488-
ff694c0\registry.npmjs.org\spy-debugger-\spy-debugger-3.5.0.tgz
npm ERR! Expected: 700a7a053a1f15f5a1cca84e8279f23e672b752d
npm ERR! Actual: 64bc811c3b6996a3eb7d8cdfca89fa7be3653e3d
npm ERR! From: https://registry.npmjs.org/spy-debugger/-/spy-debugger-3.5.0
tgz
npm ERR!
npm ERR! If you need help, you may report this error at:
npm ERR! https://github.com/npm/npm/issues

请教：如何把微信页面抓取后存入数据库

请教：如何把微信页面抓取后存入数据库

您好 https有时可以访问，有时访问不了 但http是可以的

不支持Linux？

Linux暂时不可用，debian8.5 jessie

为什么我手机安卓证书的地址 跳转另外1个网址，再就是手机修改网络后，上不了网 打不开网址，是对的吗

就现在的情况命令行 打完，跳转出1个网页，然后就不知道干什么了，手机打不开任何东西，请问是什么问题。

console.log(null) 或者console.log(undefined)会导致weinre的targe-script-min.js 报错

请问, xcode 自带的 IOS 模拟器的 WIFI 代理怎么设置?

找不到网络管理

webview内AnyProxy 抓不到https,weinre 无targets

如题,使用浏览器打开可以,
webview内AnyProxy 抓不到https,weinre 无targets

一直报deprecated，受不了

(node:55699) [DEP0013] DeprecationWarning: Calling an asynchronous function without callback is deprecated.
满屏都是这个，工具挺好用的。