官方手冊 · 問題索引
Shadowrocket 疑難排解
依問題發生階段查找:商店確認、安裝與首次開啟、匯入現有訂閱、連線與規則。
商店問題適用於 iPhone / iPad;安裝項目也涵蓋 Mac、Windows、Android 與 Linux。連線操作以 iPhone / iPad 的介面名稱為例。
如何確認 App Store 上的 Shadowrocket?
請在 App Store 產品頁確認三項資訊:開發者為 Shadow Launch Technology Limited、圖示與本頁頁首的官方圖示相同,且產品頁網址結尾為 id932747118。只看 App 名稱或搜尋結果中的圖示,不足以確認是同一個項目。購買前也請確認商店目前顯示的價格及裝置相容性。
電腦和 Android 可以使用嗎?購買用戶端有包含連線服務嗎?
可以。iPhone / iPad 版在美國 App Store 售價為 $2.99,採一次性付費,實際資訊以商店頁面為準;Mac(Apple 晶片版與 Intel 版)、Windows、Android、Linux 版免費。電腦與 Android 安裝檔由本站下載頁透過 /dl/shadowrocket/ 提供。用戶端一次買斷 ≠ 連線服務方案;匯入時請使用你已有的訂閱或伺服器資訊。
iPad 可以安裝嗎?如何確認系統需求?
可以。iPhone 與 iPad 共用同一個 App Store 產品項目;系統需求請以 App Store 頁面標示為準。在 iPad 上開啟產品頁查看「相容性」,再到系統「設定」的「關於本機」確認已安裝的 iPadOS 版本。若頁面顯示裝置不相容,請先確認系統是否可更新,不必重複搜尋同名 App。
在 App Store 找不到 Shadowrocket,該先檢查什麼?
請先確認購買帳號所屬的商店地區,而非裝置的語言與地區。前往系統「設定 → Apple ID → 媒體與購買項目 → 檢視帳號 → 國家或地區」。App 是否顯示取決於該商店。若確實需要更改,請從同一頁選擇更改國家或地區,並先依 Apple 提示確認餘額、現有訂閱與付款方式。
更換 iPhone 或 iPad,需要重新購買嗎?
使用原購買帳號,且 App 仍可重新下載時,就不必再次購買。在新裝置上開啟 App Store,點選個人頭像並前往已購項目搜尋 Shadowrocket;若找不到,請先確認「媒體與購買項目」使用的帳號及目前商店地區。重新下載 App 不會自動還原所有設定,換機前請另外備份要保留的 Config。
Mac 應該選 Apple 晶片版還是 Intel 版?
開啟 Apple 選單 →「關於這台 Mac」。若「晶片」顯示 Apple M 系列,請在下載頁選擇 Apple 晶片版;若「處理器」顯示 Intel,則選擇 Intel 版。兩種安裝檔都是 dmg,副檔名相同,無法藉此判斷晶片類型。若提示 App 不適用於此 Mac,請先回到這個頁面確認,不要將架構不符誤認為安全性封鎖。
Mac 或 Windows 顯示風險警告,首次開啟時該怎麼處理?
先不要開啟,確認檔案確實是從本站下載頁透過 /dl/shadowrocket/ 取得,且適用於該裝置的系統與架構。只有在來源明確、警告僅表示無法驗證開發者或發佈者,且裝置政策允許時,才考慮單次允許開啟:macOS 前往「系統設定 → 隱私權與安全性」查看「仍要打開」;Windows 在 SmartScreen 的「更多資訊」中查看「仍要執行」。若系統明確回報惡意軟體、檔案來源不明,或裝置由組織管理,請勿略過封鎖。
安裝 Android 或 Linux 版時,如何分辨權限問題與安裝檔選錯?
Android 請先確認裝置是否支援 arm64。若系統只提示安裝權限,確認檔案來源後,僅暫時允許用來開啟安裝檔的 App「安裝未知應用」,完成後再關閉。Linux 請依發行版選擇安裝檔:Debian 或 Ubuntu 使用 deb,Fedora 或 RHEL 使用 rpm;使用 AppImage 時,確認來源後再為該檔案授予執行權限。若出現架構不符或相依性錯誤,請先確認發行版與處理器,不要把提高權限當成通用解法。
iPhone 或 iPad 的連線開關無法開啟,該先檢查哪裡?
先在 Home 確認是否已選取可用的 SERVER。首次開啟連線時,系統可能會要求允許加入 VPN 設定;請確認提示中的 App 名稱後再按確認。若先前曾拒絕,可返回 Home 再試一次,留意系統是否再次顯示提示。若目前有其他 VPN 正在使用,請先確認能否暫時中斷後再試;受管理裝置上的限制應由管理員確認。
介面是英文,依照手冊操作時要找哪些名稱?
在 iPhone 或 iPad 上,依操作目的尋找對應項目:到 Home 查看連線開關與 Global Routing,到 Config 確認目前設定,到 Settings 尋找 On Demand 等選項。Add Server 用來輸入已有的伺服器資訊,Subscribe 用來匯入已有的訂閱。手冊保留這些英文名稱,查找時不必先更改系統語言。
Shadowrocket 訂閱匯入失敗,如何判斷問題出在哪個步驟?
先確認你透過 Subscribe 匯入的是服務提供者給你的完整訂閱網址,而非登入頁網址或單一伺服器分享連結。請重新從原處複製,檢查網址末尾參數是否遭截斷或混入空格,再使用目前的網路重試。若提示沒有權限或連結已過期,請確認訂閱是否仍有效;若提示無法辨識格式,請先向原服務提供者確認回傳內容的格式。不要將完整網址貼到公開頁面。
Shadowrocket 訂閱更新後,需要重新新增嗎?
若網址沒有變更,請先更新 Home 中現有的訂閱項目,不必再新增同名項目。更新後展開訂閱,確認原先選取的伺服器仍在清單中,再測試連線。若網址確實已更換,請先保留舊項目;等新網址匯入成功並確認選取項目後,再決定是否移除舊項目。
手上只有伺服器參數,應該使用 Subscribe 嗎?
不需要。若有單一伺服器的參數,請開啟 Add Server,先選擇與原始資訊相符的協定,再依照原值填入位址、連接埠及該協定要求的欄位。位址通常不包含協定前綴或路徑;需分開填寫的欄位不要併入位址。例如 VLESS 與 Trojan 所需的驗證資訊不同,不能互換。儲存後返回 Home,選取該項目再進行測試。
掃描 QR Code 後,為什麼沒有出現預期的伺服器項目?
先分辨是掃描失敗還是匯入失敗:相機無法辨識時,請檢查 Shadowrocket 的相機權限,以及 QR Code 是否完整清晰;若辨識後沒有出現預期項目,請確認 QR Code 內含的是訂閱網址還是單一伺服器資訊,因為兩者在 Home 中的顯示方式不同。若掃描結果是網頁網址,請回到原始資訊確認該網址是否供匯入使用。QR Code 可能包含認證資料,排查時請勿公開轉傳。
訂閱更新成功,先前選取的伺服器卻不見了,該怎麼辦?
更新成功僅表示用戶端讀取了這次的訂閱內容,不代表先前的所有項目都會保留。請展開同一個訂閱檢查清單,確認原項目是否已移除或改名。若目前沒有可用的選取項目,請先在自己的訂閱中重新選取並測試;若 Config 中有規則依賴特定策略或伺服器名稱,也請確認引用仍能對應,不必先刪除整個 Config。
Global Routing 的 Config、Proxy、Direct 三種模式該怎麼選?
需要依規則分流時,選擇 Config(設定),由目前的 Config 決定哪些請求經由 PROXY 或 DIRECT。若要確認選取的伺服器能否處理由用戶端接管的請求,可暫時切換至 Proxy(代理),也就是常說的全域模式。若要在保持連線開關開啟的情況下,比較不經代理伺服器的連線結果,可選擇 Direct(直連)。測試結束後,請切回原本使用的模式。
顯示連線已開啟,但網頁無法開啟,應依什麼順序排查?
先關閉連線開關,使用相同網址確認裝置目前的網路是否可用;若公共 Wi-Fi 要求登入,請先完成登入。網路正常後重新連線,在 Home 確認選取的 SERVER,並執行 Connectivity Test。若只有特定網域無法開啟,請記下目前的 Global Routing 模式,並檢查作用中的 Config 規則與 DNS。每次只修改一項,再用相同網址確認結果。
切換到 Config 後,為什麼請求沒有依預期走 DIRECT?
先確認修改的是目前正在使用的 Config,再由上往下檢查 [Rule]。同一個請求可能先符合排序較前面的規則;只有前面的規則都未符合時,FINAL 才會生效。測試網頁時,除了網址列中的網域,也要留意網頁載入資源時連線的其他網域。使用 Log 查看實際請求,確認是哪條規則誤判後再調整順序。
覺得連線後耗電變快,如何排查 On Demand?
先查看系統「設定 → 電池」中的活動紀錄,不要只依連線圖示判斷原因。記下當時使用 Wi-Fi 或行動網路,以及是否頻繁切換網路,再到 Settings 確認 On Demand 的啟用條件。不需要依需求自動連線時,可暫時關閉 On Demand,在相近的網路使用情境下比較;完成後恢復原設定,避免將其他網路使用變化歸因於同一原因。
Connectivity Test 通過了,為什麼還要測試實際網址?
Connectivity Test 通過,只表示這次測試所使用的目標可以連線,不能取代實際網址的存取結果。同一裝置上的實際請求仍可能經過不同規則、DNS 解析或伺服器。請使用發生問題的原網址再試一次,並記錄所用網路、Global Routing 模式及失敗時間;查看 Log 時依這些資訊定位,分享紀錄前請移除訂閱網址與認證資料。