spy debugger

關於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程式碼。讓頁面調試更加方便。