OFFICIAL MANUAL / QUESTIONS

Shadowrocket
疑難排解

依序檢查取得、安裝、匯入與連線步驟。先確認問題發生在哪個階段,再一次調整一個條件;記下具體提示,比反覆重新安裝更容易找出原因。

ACQUIRE / PURCHASE

正版與購買

先確認裝置的取得方式,再核對商店項目、購買帳戶與相容性。

電腦和 Android 能使用 Shadowrocket 嗎?各平台如何收費?

可以。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片版與 Intel 版;電腦和 Android 請前往本站下載頁選擇裝置,安裝檔由本站 /dl/shadowrocket/ 路徑取得。一次買斷客戶端不等於購買線路方案;使用前須備妥自己的訂閱或伺服器資訊,訂閱需向服務商取得。購買客戶端不會自動建立可供連線的伺服器。

如何確認 App Store 上的 Shadowrocket 是正版?

不要只憑搜尋結果中的名稱判斷。開啟產品詳細資訊,依序確認開發者 Shadow Launch Technology Limited、官方圖示,以及產品連結中的 App ID 932747118;圖示可與本站頁首的官方圖示比對。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。商店中免費的同名項目並非本文所述的 iPhone / iPad 版本;電腦和 Android 請從本站下載頁取得對應安裝檔。

在 App Store 搜尋不到 Shadowrocket,應先檢查什麼?

先確認 App Store 帳戶所屬的商店地區,不要只修改裝置的語言或地區。中國大陸商店目前沒有此 App;可在 Settings 的 Apple Account 中開啟 Media & Purchases,再前往 View Account 查看 Country/Region。若確實需要變更,請依照 Apple 官方帳戶設定流程處理,並先確認餘額、現有訂閱與付款方式要求,不要反覆切換嘗試。也可開啟本頁提供的產品詳細資訊連結,查看目前商店顯示的提示。

更換裝置或重新安裝後,需要再次購買嗎?

更換 iPhone / iPad 後,先在 App Store 登入原購買帳戶,再從帳戶的已購項目中找到 Shadowrocket 並重新下載;清單名稱可能因系統版本而異。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費,重新從本站下載頁取得即可。若商店仍顯示購買按鈕,請先確認購買紀錄與目前登入的帳戶,不要急著再次付款。重新安裝 App 不會還原設定,請事先備份原有設定與訂閱。

iPad 可以安裝嗎?系統需求和 iPhone 一樣嗎?

可以在 iPad 上安裝 Shadowrocket。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。使用原購買帳戶時,可在另一部相容的 iPhone 或 iPad 上從已購項目重新下載。系統需求請以 App Store 頁面標示為準,不要只根據舊教學中的系統版本判斷。兩部裝置的本機設定、VPN 授權與連線狀態都須分別檢查;線路能否同時使用,請確認服務商提供的使用條件。

INSTALL / FIRST OPEN

安裝與首次開啟

先確認安裝檔來源與裝置架構。只應為已確認來源的 App 允許系統通過,不代表可以忽略具體的風險提示。

Mac 應選 Apple 晶片版還是 Intel 版?

先開啟 Apple 選單中的「關於這台 Mac」。若顯示「晶片」且名稱為 Apple M 系列,請選 Mac Apple 晶片版;若顯示 Intel 處理器,請選 Mac Intel 版。不要只憑電腦外觀或購買年份判斷。兩個版本都可在本站下載頁取得,選擇對應的 dmg 後安裝。首次開啟若遭系統封鎖,請確認檔案來自本站 /dl/shadowrocket/ 路徑,再前往「系統設定 → 隱私權與安全性」查看提示,視需要選擇「仍要打開」;不必因此改下載另一種晶片版本。

Mac 顯示無法驗證開發者或 App 已損壞,該怎麼辦?

先確認安裝檔來自本站下載頁,且已將 App 移至 Applications。若提示無法驗證開發者,先嘗試開啟一次,再前往「系統設定 → 隱私權與安全性」選擇「仍要打開」並確認。若提示 App 已損壞,請先重新下載並安裝;確認來源後,可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再重新開啟。此操作只針對該 App 的隔離屬性,不應延伸為全面關閉系統保護;受管理的裝置請先聯絡管理員。

Windows SmartScreen 提示有風險,如何繼續?

先確認檔案是否從本站下載頁取得,下載網址應為本站 /dl/shadowrocket/ 路徑。若 SmartScreen 顯示「Windows 已保護您的電腦」,確認來源後可點選「更多資訊 → 仍要執行」,再處理系統權限確認。不要混淆不同類型的封鎖:若是組織政策、裝置管理規則或安全軟體指出具體威脅,請先閱讀詳細資訊並向管理員確認,不要直接關閉所有防護。下載不完整時請重新下載,不要反覆啟動同一個檔案。

Android 和 Linux 首次安裝時,需要允許哪些權限?

Android 從本站下載頁取得 arm64 安裝檔後,若系統阻止安裝,可暫時允許實際開啟檔案的瀏覽器或檔案管理員「安裝未知應用」,完成後關閉該來源的安裝權限。Linux 請依發行版選擇 deb、rpm 或 AppImage;AppImage 須先執行 chmod +x Shadowrocket.AppImage 再執行檔案,命令中的檔名請換成實際下載的名稱。遇到裝置管理政策或相依性錯誤時,請先依照具體提示處理,不要把所有安裝失敗都歸因於權限不足。

介面是英文,和教學對不上,該如何找到操作位置?

官方手冊保留介面英文原文:Home 用來查看伺服器與連線狀態,Add Server 用來新增伺服器,Config 用來管理設定檔,Settings 用來調整 App 設定。請先找到這些入口,再對照各欄位,不要只根據按鈕顏色或舊截圖的位置操作。系統版本、裝置尺寸與 App 更新都可能改變介面配置;若入口位置不同,請依目前介面顯示的名稱尋找。Global Routing 中的 Config、Proxy、Direct 是不同的路由模式,不是三種伺服器類型,也不是三種安裝版本。

SUBSCRIBE / ADD SERVER

訂閱與伺服器匯入

分別確認連結無法存取、內容解析失敗或清單顯示異常。修改前請保留現有群組與設定。

Subscribe 訂閱匯入失敗,先檢查哪些項目?

前提是已向服務商取得訂閱連結。先檢查複製時是否包含空格、換行、引號或說明文字,再確認連結仍有效、存取權限正常,且目前網路可以連上訂閱網址。在 Add Server 中依服務商說明選擇 Subscribe 並填入 URL,不要把帳戶管理網頁當成訂閱網址。若提示解析失敗,請保留錯誤訊息並向服務商確認回傳內容是否為 Shadowrocket 可識別的資料;若提示連線逾時,則先檢查網路與訂閱網址是否可連線。兩種情況的排查方向不同。

只有一組伺服器參數,如何透過 Add Server 新增?

開啟 Add Server 後,先依現有資料選擇協定,再逐項填入伺服器位址、連接埠與驗證資訊;協定選錯,即使位址正確也無法連線。Trojan 的 TLS 與 SNI、WireGuard 的金鑰與 Peer 等附加欄位,請以服務商提供的資訊為準,不要套用其他協定的填寫方式。儲存後回到 Home,選取該伺服器並驗證連線。若資料來自 QR Code,可使用 Scan QR Code 匯入;儲存後仍應確認協定與位址,避免誤將展示頁上的其他 QR Code 當成伺服器資訊。

如何更新訂閱?更新會覆蓋手動修改的內容嗎?

在 Home 找到對應的訂閱群組,進入該群組的管理入口執行更新。完成後檢查伺服器清單與錯誤提示;實際入口請以目前介面為準。更新會重新讀取訂閱來源,來源中已移除的項目可能也會消失,對訂閱項目的本機修改也可能被新內容取代。需要長期保留的手動新增伺服器請另外管理,重要參數與設定應先備份。更新失敗時,先保留現有內容並記錄錯誤,再檢查連結是否有效及目前網路狀況,不要先刪除仍可使用的群組。

匯入顯示成功,卻找不到伺服器,可能是什麼原因?

先回到 Home,確認訂閱群組是否收合,以及是否啟用了搜尋或篩選條件,再檢查是否誤匯入另一個同名群組。匯入流程完成只代表處理程序結束,不一定表示訂閱來源提供了可用的伺服器項目;來源內容空白、格式不符或存取權限變更,都可能讓清單沒有預期項目。查看該群組的更新提示,並確認服務商提供的連結。不要連續重複匯入,建立多個相同群組;排查時保留一個清楚的訂閱入口,較容易判斷更新結果。

Subscribe 和 Config 有什麼不同?兩者都要匯入嗎?

Subscribe 通常用來取得並更新伺服器清單;Config 用來管理規則、策略引用及其他設定項目,兩者用途不同。有伺服器不代表已具備適合目前用途的分流規則;匯入 Config 也不保證其中引用的策略名稱能對應現有伺服器。是否需要兩者,應依現有資料決定,不要為了補齊入口而匯入不理解的檔案。切換 Config 前先備份目前設定,並檢查規則使用的策略名稱;若只是要測試新伺服器,先使用明確的測試模式,排除規則影響。

GLOBAL ROUTING / DIAGNOSIS

規則分流與疑難排解

分開檢查系統授權、伺服器連線路徑、規則命中與目標存取。連線狀態只是其中一項確認。

Global Routing 的配置、代理、直連三種模式該怎麼選?

Config 是配置模式,依目前設定檔中的規則決定流量走向;Proxy 是代理模式,主要讓由客戶端處理的流量經所選伺服器轉送;Direct 是直連模式,適合用來比對本機網路。日常使用已確認過的規則時,可選 Config;首次測試伺服器時可暫用 Proxy,測試後再恢復原設定。選擇 Proxy 不代表伺服器一定可用,選擇 Config 也不代表所有請求都會使用代理;實際結果應搭配規則命中紀錄與實際連線測試確認。

連線開關無法開啟,或開啟後立刻關閉,該如何排查?

先確認 Home 中已選取伺服器且參數完整,再開啟連線開關。iPhone / iPad 首次連線時,須允許新增 VPN 設定檔,並依系統要求完成裝置驗證;若當時取消,請重新觸發並允許。若仍立即關閉,請查看系統 VPN 設定中是否有其他正在運作的 VPN、受管理的設定檔或權限限制,再檢查 App 顯示的錯誤訊息。不要同時修改伺服器、規則與 DNS;先保留目前設定並記錄失敗步驟,必要時重新啟動裝置後再試。尚未取得系統授權前,不要反覆更換訂閱。

顯示已連線卻無法上網,應依什麼順序檢查?

顯示已連線,表示本機連線流程已建立,不代表所有目標請求都能成功。先中斷 Shadowrocket,確認原本的網路是否可用;再確認所選伺服器仍有效,並使用 Connectivity Test 查看結果。接著暫時選用 Proxy 測試相同目標:若此時可用、Config 不可用,請優先檢查規則命中、策略引用與 FINAL;若兩者都失敗,再確認伺服器參數、網路與 DNS。每次只變更一個條件,並記錄 Wi-Fi 與行動網路下的結果是否一致,避免反覆切換後無法判斷是哪項設定造成差異。

Connectivity Test 成功,為什麼某個網站還是打不開?

Connectivity Test 只反映測試目標與當時連線路徑的結果,不代表所有網站、App 與協定都能存取。先確認失敗的是單一網域還是所有請求,再查看該請求實際命中的規則與策略。若規則將目標交給 DIRECT,請檢查本機直連;若交給 PROXY,請檢查所選伺服器是否能連上目標。也要留意 DNS 解析、目標服務故障與 App 自身快取。請以相同目標逐項比對;提交診斷資訊前,遮蔽訂閱連結、驗證資訊與個人瀏覽紀錄。

開啟後耗電增加,該如何檢查 On Demand?

先查看系統電池用量,區分前景使用、背景活動與實際傳輸時段,不要只看單一百分比就判定異常。連線頻繁失敗後重試、持續大量傳輸、記錄過於詳細的日誌,以及網路切換,都可能增加耗電。若已啟用 On Demand,請檢查 Wi-Fi、行動網路或網域條件是否互相觸發;排查時可先暫停 On Demand,確認手動連線穩定後再逐項恢復。請在相同使用情境下記錄調整前後的差異,不要一次關閉多項設定,也不要以固定耗電比例作為正常與否的標準。