黃鳥抓包，Reqable是一款適用于多平臺的專業HTTP開發與調試工具，全面支持HTTP1、HTTP2及HTTP3(QUIC)協議，兼具簡潔的操作體驗、豐富的功能特性與高效的運行性能，能夠有效提升程序開發及測試人員的工作效率。該工具的使用需要具備一定的網絡基礎，因此更適合開發、測試、網絡、安全、爬蟲等領域的專業技術人員，或在相關專業人士的指導下進行操作。

Reqable介紹

這款全平臺覆蓋的API工具，無需登錄即可使用，以輕量、高效、的特性，為開發者打造從調試到測試的一體化解決方案，讓API相關工作更便捷流暢。它支持捕獲各類應用的HTTP網絡流量，助力技術人員快速精準排查網絡異常；同時具備完善的API測試與管理功能，還能實現多設備協同操作，有效提升開發與測試環節的工作效率。

Reqable的前身是HttpCanary，我們對UI及所有功能進行了重新設計，以此來實現與桌面端功能的一致性。

Reqable黃鳥抓包如何安裝證書

若您需要對移動端應用的流量數據進行分析，需先在移動設備上完成CA根證書的安裝操作，相關的Android與iOS系統證書安裝步驟指引，我們已整合至Reqable工具中。

重要須知

若您通過電腦端App開展流量分析，需將電腦端的CA根證書安裝至移動端設備；若您直接使用移動端App進行流量分析，則要把移動端的CA根證書安裝到移動端設備上。

Reqable為不同設備生成的CA根證書是各自獨立的。若想讓多臺設備使用同一份CA根證書，可先導出.p12格式的證書文件，再將其導入到其他需要的設備中。

信息

在移動應用的初始設置階段，若選擇協作模式并通過掃碼完成與電腦的配對連接，系統會自動將電腦端的CA根證書同步至移動設備，使兩者的CA根證書保持一致。

Android

Android系統中的證書主要有兩類，一類是供普通用戶使用的證書，另一類是屬于系統層面的證書。普通用戶使用的證書所在的目錄，用戶無需特殊權限就能完成證書的添加與移除操作；而系統層面的證書所在的目錄，只有在獲取Root權限后，才能夠對其中的證書進行添加或刪除操作。

Reqable需要用戶預先在電腦上安裝好ADB工具，它會借助ADB工具來檢測連接到電腦的Android設備的證書安裝情況，涵蓋系統證書和用戶證書的安裝狀態。

關于ADB工具

Google推出的Android設備連接工具ADB，開發者可通過官方渠道獲取安裝包，完成安裝后需正確配置ANDROID_HOME與PATH這兩個環境變量，隨后重啟Reqable應用即可正常使用該工具。

系統證書

Reqable能夠檢測系統證書的安裝狀態，無論設備是否經過Root操作。不過，一鍵安裝證書的功能僅對已Root的設備開放，該功能支持Android 5.0至15的系統版本。

若系統證書已完成安裝，那么用戶證書的安裝步驟即可略過。

用戶證書

用戶證書需由用戶手動安裝，在手機端打開設置后，可按以下步驟操作：

進入系統配置界面，依次找到安全相關選項、加密與憑據管理入口，點擊安裝證書功能，選擇CA證書類型，然后選中已導出的證書文件進行安裝操作，此過程需要通過用戶身份驗證環節。

請注意，對于未獲取Root權限的設備，Reqable無法對用戶證書的安裝情況進行檢測，因此會持續顯示證書安裝狀態為未知。

當設備運行的系統版本為Android 7.0或更高時，即便已完成用戶證書的安裝步驟，開發人員仍需在項目內添加特定的配置項，以此確保應用能夠正常信任該用戶證書。

警告

這種方法僅適用于Android原生應用，對基于Flutter開發的應用不起作用。

推薦采用的第一種方法是在build.gradle文件里完成依賴項的相關配置。

采用上述設定后，Debug版本會自動整合網絡安全相關的配置文件；若遇到無法訪問Maven中央倉庫的情況，可參照第二種方法的說明，自行新建并完成網絡安全文件的配置工作。

方式二：手動創建網絡安全文件

新建文件 res/xml/network_security_config.xml

配置到 AndroidManifest.xml

請在正式發布的版本里把這個配置項移除掉，若想了解更多關于網絡安全配置文件的相關信息，可以查閱Android的官方開發文檔。

瀏覽器

在安卓設備上，證書安裝完成后，即便已放置到系統證書目錄下，瀏覽器也未必會認可該證書的可信度。

Chrome瀏覽器

Chrome瀏覽器的證書信任規則持續調整，像其最新版本就不再認可安裝在Android系統證書文件夾里的自行簽發CA證書，若要對Chrome瀏覽器開展抓包操作，可參照以下步驟處理：

如果使用的是高版本Chrome瀏覽器，需將CA證書安裝至用戶證書目錄。

若使用的是低版本Chrome瀏覽器，則需把CA證書安裝至系統證書目錄。

如果不確定選用那種方式，可以分別嘗試下。

Firefox瀏覽器

Firefox瀏覽器的CA證書驗證機制比較特殊，不管Reqable的CA證書安裝在系統目錄還是用戶目錄，都無法自動獲得信任，得由用戶手動進行額外的設置操作才行。

在火狐瀏覽器中，依次進入設置頁面、關于頁面，連續點擊頁面頂部的標志五次，即可開啟調試菜單功能。

在Firefox瀏覽器的設置界面中找到“秘密設置”選項，然后開啟“允許使用第三方CA證書”的功能。

完成上述步驟的操作后，把CA證書安裝到用戶目錄就能生效了。

iOS

在蘋果移動設備上配置安全證書的步驟十分便捷，遵循以下指引操作就能完成。

首先，需要安裝描述文件（證書）。該描述文件既可以手動保存，也能通過瀏覽器獲取。

手動保存操作步驟如下：點擊界面右上角的“導出CA證書”選項，隨后打開文件應用，在Reqable文檔目錄中找到剛才導出的CA證書文件。接著，手動將該證書復制或移動到Reqable文檔目錄的上一級目錄，完成移動后點擊證書文件，此時會出現已描述文件的提示信息。

在瀏覽器中操作時，點擊相關證書會自動啟動瀏覽器程序，待流程結束后，系統將自動彈出提示，告知描述文件已成功生成。

接下來，進入設置界面，找到描述文件相關選項，選中剛才獲取的那個描述文件，然后執行安裝操作。

接下來需要完成的是信任證書的操作，具體步驟為：進入設置界面，依次找到通用選項、關于選項、證書信任設置選項，最后開啟對應的開關即可。

特殊問題

在某些特殊情形下，即便已經安裝了證書，也有可能無法對HTTPS流量進行正常解析，常見的情況主要有以下這些。

網絡請求配置了證書固定機制，僅接受由特定機構簽發的服務器證書。

網絡請求已開啟雙向驗證機制，這意味著客戶端也需要向服務器上傳證書以完成身份驗證流程。

應用采用的是自身的CA證書驗證方式，而非調用系統自帶的CA證書。

Android黃鳥抓包常見問題

證書問題

若需完成證書相關的部署操作，可通過訪問指定鏈接獲取詳細指引，該鏈接為：https://reqable.com/zh-CN/docs/getting-started/installation/

若遇到相關疑問需要排查解決，可訪問該鏈接獲取指引：https://reqable.com/zh-CN/docs/faq/ssl/

查看日志

先展開側邊欄，再長按頂部的標識，就能挑選日志文件來瀏覽了。

獲取不到應用程序的流量

請先確保下面的操作已經處理。

已經開啟了調試開關。

已經設置記錄模式為VPN而不是代理。

已經啟用增強模式。

已關閉全部篩選和搜索條件。

已移除全部指定應用程序。

在Reqable里開啟調試功能后，用手機瀏覽器打開百度的主頁。

警告

瀏覽器或許會提示連接不安全，這類情況屬于證書問題，請查看以下內容。

Chrome→ https://reqable.com/zh-CN/docs/faq/android/#chrome

Firefox→ https://reqable.com/zh-CN/docs/faq/android/#firefox

當遇到百度主頁無法正常打開的情況時，同時在Reqable的調試記錄里也完全找不到任何網絡流量的蹤跡，就連CONNECT類型的請求也沒有顯示。

或許是代理服務的端口出現了異常情況，比如被其他正在運行的程序占用了，這時候可以試著換一個端口再重新嘗試。

若更換端口后瀏覽器依舊無法訪問百度首頁，煩請通過Github或微信向我們反饋。

情況二：百度首頁能夠正常訪問，但在Reqable的調試列表里看不到任何流量數據，就連CONNECT請求也沒有顯示。

請確認記錄模式是否處于VPN狀態，若該模式下問題依舊存在，可通過Github或微信渠道向我們反饋。

情況三：百度首頁能夠正常訪問，且在Reqable的調試列表里也能看到瀏覽器的訪問流量（其中包含CONNECT請求）。

當前瀏覽器運行狀態正常，推測是目標應用程序本身限制了VPN環境下的使用權限。若需解決此問題，建議直接與該應用程序的開發團隊取得聯系，以獲取針對性的技術支持或解決方案。

無法連接電腦

檢查手機和電腦是否在同一個局域網下。

請確認手機與電腦是否處于同一局域網段，部分局域網在組網時可能會限制跨段通信。

嘗試電腦連接手機熱點，然后手機再掃碼連接電腦。

可以查看一下電腦防火墻的設置，確認Reqable代理所使用的端口號對應的網絡流量是否被限制了進出。

協同模式下獲取不到應用程序的流量

您可以按照下面的步驟進行排查：

切換至獨立模式（操作方式為在側邊欄中選擇調試Tab），并依照上述第3點開展排查工作。

你可以在手機版Reqable里調整增強模式的開關狀態后重新操作試試。

調整電腦上Reqable應用的端口設置后，再通過掃碼方式重新建立連接。

Chrome訪問提示不安全的網站

Chrome瀏覽器的證書信任規則持續調整，像其最新版本就不再認可安裝在Android系統證書文件夾里的自行簽發CA證書，若要對Chrome瀏覽器開展抓包操作，可參照以下步驟處理：

如果使用的是高版本Chrome瀏覽器，需將CA證書安裝至用戶證書目錄。

若使用的是低版本Chrome瀏覽器，則需把CA證書安裝至系統證書目錄。

如果不確定選用那種方式，可以分別嘗試下。

Firefox訪問提示不安全的網站

Firefox瀏覽器自身維護著獨立的證書存儲機制，系統層面已安裝的CA證書無法直接在該瀏覽器中發揮作用，需通過其的調試功能菜單手動開啟對相關證書的信任權限。

在火狐瀏覽器中，依次進入設置頁面、關于頁面，連續點擊頁面頂部的標志五次，即可開啟調試菜單功能。

在Firefox瀏覽器的設置界面中找到“秘密設置”選項，然后開啟“允許使用第三方CA證書”的功能。

無法訪問境外受限網站

Reqable本身不具備訪問受限網站的能力，您可在已取得境外訪問許可的前提下，依照以下步驟進行操作。

電腦端安裝并啟動科學上網工具。

在電腦上通過Reqable軟件設置二級代理，使其指向之前配置好的工具。

手機端Reqable掃碼連接電腦（協同模式）。

軟件特色

#1 獨立模式

Reqable具備獨立監聽流量的能力，無需依賴桌面端應用程序。用戶能夠直接在手機上對應用進行抓包，查看HTTP報文并分析網絡請求，從而便捷高效地定位問題。Reqable手機端提供了豐富多樣的視圖，像Json視圖、Hex視圖、圖片預覽等，便于開發者查看和分析數據。除此之外，用戶還可以對捕獲到的請求執行重放、編輯、分析以及保存等操作。

#2 協同模式

要是覺得手機操作不太方便，你可以借助App把流量轉發到Reqable桌面端。不需要手動設置Wifi代理，只要掃描二維碼，就能將手機上的流量轉發到桌面端。而且在協同模式下，還能開啟增強抓包功能，這樣可以攔截那些不走系統代理的應用程序流量，像Flutter應用程序就屬于這類。處于協同模式時，用戶能夠在電腦端直接對請求進行重放、斷點、重寫以及腳本等操作。

#3 流量抓包

Rehable默認借助VPN技術捕獲應用程序的流量數據，當前具備以下特性：

- HTTP/1.x, HTTP2協議版本。

支持HTTP、HTTPS以及Socks4、Socks4a、Socks5等多種代理協議類型。

采用安全超文本傳輸協議，并支持TLSv1.1、TLSv1.2與TLSv1.3這三種加密協議。

基于HTTP/1協議升級而來的WebSocket協議。

- IPv4 and IPv6.

- SSL代理。

- HTTP/HTTPS二級代理。

- 篩選、搜索和排序。

- 編輯API。

- 歷史記錄。

- 重發回放。

- 顏色高亮。

- HAR支持。

- 生成代碼。

#4 API測試

Reqable還提供了API測試和管理能力：

- HTTP/1.1、HTTP2與HTTP3（QUIC）請求測試。

- API集合。

- 環境變量。

- 參數批量編輯。

- 授權設置。

- 代理設置。

- 性能數據查看。

- Cookie管理。

- 歷史記錄。

- cURL支持。

- 生成代碼。

更新日志

v2.33.12版本

- 【優化】部分場景中存在的內存占用過高及卡頓現象。

為防止性能受影響，當原始Tab頁中存在超大體積數據時，會以`<...>`的形式呈現這些內容。

已對Python-Requests代碼生成邏輯進行調整，現在采用URL拼接方式而非params字典來構建請求地址。

已對API請求測試功能進行優化，現在URL參數值里的等號不會被自動轉換成編碼形式的%3D了。

對協同二維碼關聯的IP地址列表進行了調整，移除了其中包含的VPN虛擬地址。

已解決API請求測試中URL參數名與參數值均為空時參數丟失的問題。

- 【修復】修復了切換網絡后遠程訪問設備時出現請求回路的問題。