注:本文翻譯自Orchid Github using-orchid文檔中“Gathering Logs”與“Android Prerequistites”內容。

如果您在使用Orchid客戶端時遇到了問題,不論是iOS、安卓或者MacOS系統,我們希望您能通過本文了解到如何收集您的Orchid客戶端日誌並分享給Orchid團隊,以便我們能在未來的更新中解決這些問題。您也可以將您的日誌分享給小助手,文章末尾有Orchid小助手的微信二維碼~

收集日誌

當我們調試客戶端的各種問題時,您可能會被要求共享相關日誌。這些日誌提供了關於Orchid客戶端在為您提供隱私的瀏覽體驗時,後台所記錄的詳細信息。該頁面旨在協助您收集和共享這些日誌。

安卓端的前期工作

首先在手機上打開開發人員模式和調試模式,進入 設置→

關於手機→關於軟件,重複點擊版本號直到手機提示您開啟了開發人員模式。之後進入 設置→開發人員模式→開啟USB調試。最後您可以通過使用USB將手機同電腦相連接來查看相關日誌。

安卓端和iOS端的前期工作

當您將您的設備連接至電腦時,他將提示您是否信任該計算機,請點擊是。這很重要,否則您將無法正常收集日誌。

Cydia Impactor

從iOS和安卓端收集日誌最簡單的方法是使用Cydia Impactor。

Cydia Impactor: http://www.cydiaimpactor.com/

在主窗口中,使用選擇框選中正確的設備(如果您只有一個移動設備連接到了您的電腦,那麼它將自動選擇)。之後,進入 設備(Device)→查閱日誌(Watch Log),一個終端窗口將會出現,它將為您展示來自您移動設備的streaming syslog。

adb logcat(安卓端)

如果您使用的是安卓設備,您也可以選擇通過ADB(Android Debug Bridge)來收集日誌。您可以按照以下指南在Windows、MacOS或者Linux上安裝ADB。

ADB安裝指南:https://www.xda-developers.com/install-adb-windows-macos-linux/

安裝完成後,您可以在終端上運行以下命令來查閱日誌:

adb logcat

日誌過濾

您所收集的日誌將會包含收集期間所有在您的移動設備上運行的應用與操作的信息。這些信息不是調試所必要的,您可以選擇過濾掉所有不包含字符串 orchid 的信息行來快速過濾輸出。您可以輸入以下指令:

grep -i 'orchid' client.log

其中 client.log 是包含了移動設備syslog輸出的文件。您還應該小心的從這些日誌中剔除您的各種私鑰/密鑰:

grep -vi 'secret' client.log


分享日誌

您收集的日誌將會非常長。你肯定不會想把他們全部粘貼到其他地方,例如Telegram中。相對的,我們鼓勵您通過您喜歡的交流方式分享給我們。或者,如果您常用的通訊平台不支持附件形式,您可以使用私有的代碼(pastebin)服務來上傳文件,例如Github Gists。 Github Gists將為您提供一個私有的URL,您可以通過共享它,授權他人來訪問您的日誌。

Github Gists鏈接:https://gist.github.com/