官方手冊 · 依問題查找

Shadowrocket 疑難排解

從取得應用程式到連線驗證,依目前遇到的問題查找。先確認裝置、資料類型與錯誤訊息,再調整設定;每次只改一個有依據的項目,方便比對結果。

4 類問題 20 項操作解答 介面用語保留英文原名
購買前核對

正版核對與購買

分清用戶端費用、商店帳號與連線資料。Shadowrocket(小火箭)的產品資訊請在指定產品頁逐項核對。

Shadowrocket 多少錢?一次買斷是否包含連線服務?

取得方式分兩種:iPhone/iPad 版在 App Store 一次性付費 $2.99,各地商店以當地貨幣標價,請以商店頁面為準;Mac/Windows/Android/Linux 版免費。買斷的是用戶端,不包含連線服務。購買 App 只取得用戶端的使用資格。連線前仍須備妥自己已有的訂閱或伺服器資料;本站不提供節點服務,也不販售或推薦訂閱。

如何在 App Store 核對 Shadowrocket?

開啟本頁列出的 App Store 產品頁,逐項核對產品名稱 Shadowrocket、開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118。請勿只憑中文別稱或搜尋結果中的相似圖示判斷。iPhone/iPad 版一次性付費 $2.99,Mac/Windows/Android/Linux 版免費;商店中標示免費的同名項目並非此處所指的 iPhone/iPad 版。

在 App Store 搜尋不到 Shadowrocket,該檢查哪些項目?

先開啟指定的產品頁,分辨搜尋不到結果與目前商店未提供此 App。中國大陸 App Store 目前沒有此 App,請確認「媒體與購買項目」所使用的 Apple 帳號地區,而非只更改裝置的語言或地區。若需調整,請在 Settings 中依序前往 Apple 帳號、「媒體與購買項目」、「檢視帳號」、「國家或地區」,並依 Apple 提示處理餘額、有效訂閱及付款資料;若不符合條件,請先保留現有設定。

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

iPhone/iPad 版在 App Store 一次性付費 $2.99,Mac/Windows/Android/Linux 版免費。更換裝置後,使用當初購買時的 Apple 帳號登入「媒體與購買項目」,在 App Store 帳號頁面前往 App 或已購項目,找到 Shadowrocket 後重新下載。若仍顯示價格,請先核對購買帳號、商店地區及購買紀錄,別急著再次付款。還原 App 不等於還原設定,原有訂閱與規則資料須另外備份。

iPad 可以安裝嗎?iPhone 和 iPad 需要分別購買嗎?

可以。iPhone/iPad 版在 App Store 一次性付費 $2.99;兩種裝置使用同一個購買帳號時,可從已購項目重新下載。Mac/Windows/Android/Linux 版免費。iPad 的系統需求請以 App Store 頁面標示為準。裝置上的 iCloud 帳號可能與商店購買帳號不同,請確認「媒體與購買項目」使用的帳號。安裝後仍須檢查本機設定與連線授權,下載完成不代表設定已同步。

依裝置處理

下載安裝與初次開啟

先選對作業系統與晶片,再處理首次啟動提示。完整的安裝入口與放行步驟請見取得應用程式頁。

電腦和 Android 能用 Shadowrocket 嗎?Linux 版要去哪裡取得?

可以。iPhone/iPad 版在 App Store 一次性付費 $2.99,Mac/Windows/Android/Linux 版免費。請前往本站「取得應用程式」頁選擇裝置,電腦與 Android 安裝檔皆透過本站 /dl/shadowrocket/ 路徑取得。Windows 提供 64 位元安裝程式,Android 提供 arm64 安裝檔,Linux 可選 deb、rpm 或 AppImage。首次安裝若遭系統攔截,請依下載頁的安裝放行說明逐項確認後再操作,勿略過來源確認。

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

在 Mac 的 Apple 選單中開啟「關於這台 Mac」。若顯示「晶片」並列出 Apple 晶片名稱,請選擇 Apple 晶片版;若顯示「處理器」並列出 Intel,請選擇 Intel 版。不要依瀏覽器名稱或電腦外觀判斷。下載頁提供兩個對應的 dmg 按鈕,安裝前請先結束正在執行的 Shadowrocket。首次開啟若出現無法驗證開發者的提示,確認來源後前往「系統設定 → 隱私權與安全性」選擇「仍要打開」。

Windows 或 Mac 顯示有風險、無法開啟時,該如何處理?

先確認檔案來自本站下載頁。Windows SmartScreen 攔截時,確認檔案後選擇「其他資訊 → 仍要執行」;由單位管理的裝置應先遵循管理員要求。Mac 若提示無法驗證開發者,請前往「系統設定 → 隱私權與安全性」選擇「仍要打開」。若提示 App 已損壞,確認 App 已放入 Applications 且來源正確後,可在終端機執行 xattr -cr /Applications/Shadowrocket.app,再重試。不要為了開啟單一 App 而關閉整台裝置的安全防護。

Android 和 Linux 首次安裝遭系統攔截時怎麼辦?

Android 請先確認安裝檔來自本站,再依系統提示,為實際用來開啟檔案的瀏覽器或檔案管理員啟用「允許安裝未知應用程式」;安裝完成後可關閉此權限。Linux 請依發行版選擇 deb 或 rpm,並使用系統套件管理員處理相依套件;使用 AppImage 時,先在檔案屬性中允許以程式執行,或對實際檔案執行 chmod +x。若仍無法啟動,請從終端機查看具體錯誤,再參照下載頁處理,避免反覆更換不相容的安裝檔。

介面是英文,首次開啟應先認識哪些設定項目?

先認識各入口,不必逐項修改設定。Home 可查看伺服器與連線狀態,Add Server 用來填入已有的伺服器資料,Config 用來管理設定檔,Settings 用來查看設定。Global Routing 決定依設定、代理或直連方式處理流量,On Demand 則可依條件觸發連線。本手冊保留這些英文名稱,方便對照實際介面;不同系統與 App 版本的版面可能不同,找不到入口時可先查看概念速查,再依使用說明完成初次設定。

相關說明:系統安裝放行 · Mac 安裝檔選擇 · 概念速查

使用既有資料

訂閱與伺服器匯入

先分辨伺服器訂閱、單一分享連結與設定檔。匯入只是輸入資料,儲存後仍須核對欄位並測試連線。

已有的訂閱連結要從哪裡匯入?

先確認手上的資料是伺服器訂閱,而非單一伺服器分享連結或規則設定檔。伺服器訂閱可在 Home 的 Add Server 中選擇相應的 Subscribe 類型,並填入完整 URL;Config 中的 Subscribe 應用於設定檔,不可與伺服器清單混為一談。儲存後檢查是否新增預期項目,再選擇伺服器進行測試。連結來自你已有的服務提供者資料,包含存取憑證,請勿將完整網址張貼至公開討論區。

訂閱匯入失敗或清單空白,如何找出原因?

先檢查 URL 是否複製完整,特別留意結尾參數、換行、空格及中文標點,再確認匯入入口符合資料類型。接著確認目前網路能否連上訂閱網址,以及服務提供者帳號中的連結是否仍有效;不要將連結貼到公開的線上轉換或測試頁面。若下載成功但沒有任何項目,可能收到的是登入頁、錯誤訊息或不相容格式,請向原資料提供者確認格式。保留目前可用的項目,避免為了重試而先清空所有設定。

Scan QR Code、剪貼簿和 Add Server 該怎麼選?

已有單一分享連結時,可從剪貼簿匯入;資料以 QR Code 提供時,可使用 Scan QR Code,並只在需要掃描時授予相機權限。若手上只有分開的欄位資料,請使用 Add Server 手動填寫。使用這三種方式匯入後,都要重新核對 Type、Server、Port 與驗證欄位;掃描成功不代表設定必然正確。QR Code 也可能只是一般網頁網址,請先確認內容類型;勿公開含密碼的 QR Code 截圖或完整分享連結。

更新訂閱會改變現有伺服器嗎?

有可能。更新會重新讀取原訂閱網址回傳的內容,伺服器名稱、位址、數量或驗證資料都可能變更,也不保證保留手動修改過的欄位。更新前先記下目前選取項目與重要的自訂設定,再更新目標訂閱;完成後檢查項目與選取狀態,並重新測試。訂閱更新與 Config 中的規則設定更新是兩回事;若只是想更新規則,請先確認操作的是設定檔,而非伺服器訂閱。

手動新增時,如何核對 Trojan、VLESS 等類型與欄位?

Type 必須符合已有的伺服器資料,不能因欄位看起來相似,就把 Trojan、VLESS、VMess 或 Shadowsocks 互相替換。逐項核對 Server、Port、Password 或 UUID,以及資料要求的 TLS、SNI、傳輸方式等參數;不同類型顯示的欄位不一定相同。Server 與 SNI 也不一定相同,請依原始資料填寫。儲存前檢查是否有多餘空格;連線失敗時,一次只修改一個有依據的欄位。各項意義可參閱協定詳解。

相關說明:匯入與首次連線步驟 · 協定與參數詳解

從基礎網路開始排查

規則分流與連線排查

連線狀態、伺服器是否可用與規則是否命中,是不同層面的問題。記下單次失敗請求的時間與錯誤訊息,比同時修改多個開關更容易找出原因。

Global Routing 的 Config、Proxy、Direct 三種模式該怎麼選?

Config 會依目前設定檔中的規則決定流量去向,日常使用前應確認規則與策略名稱有效。Proxy 會讓由用戶端處理的連線使用所選代理,適合暫時用於對照排查;Direct 則直接連線,也可作為基礎網路的對照。這些是路由模式,不是三組伺服器資料。修改後以同一目標重新測試,並檢查記錄中的策略結果;確認完畢後恢復原本使用的模式,避免長期保留臨時測試設定。

連線開關無法開啟,或一開啟就關閉,該先檢查什麼?

先確認已選取完整且有效的伺服器項目;系統出現提示時,允許新增 VPN 設定,並依裝置要求完成驗證。若先前拒絕授權,可再次嘗試連線,並檢查系統 VPN 設定是否有衝突或受管理的設定。接著暫停其他正在使用 VPN 的工作,結束 App 後重新開啟。若仍立即關閉,查看此次連線記錄中的第一個錯誤,判斷是授權、設定解析還是伺服器參數問題;受組織管理的裝置請勿自行移除管理設定。

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

先中斷 Shadowrocket,確認目前的 Wi-Fi 或行動網路本身能否瀏覽一般網站;基礎網路不通時,先處理網路登入或訊號問題。網路恢復後,核對選取的伺服器、Global Routing 與目前的 Config,使用 Connectivity Test 初步檢查,再查看實際請求記錄。若以 IP 位址和網域存取的結果不同,優先檢查 DNS;若只有部分目標失敗,檢查規則比對結果與策略引用。系統顯示 VPN 已連線,只代表通道已建立,不能取代端對端連線測試。

規則未如預期生效,需要調整 DOMAIN-SUFFIX 或 FINAL 嗎?

先確認 Global Routing 設為 Config,並確認目前使用的設定檔就是剛修改的那份。規則通常依序比對,前面較寬泛的規則可能使後面的 DOMAIN-SUFFIX 沒有機會命中;FINAL 用來處理先前未命中的請求,應搭配整份規則一起檢查。再確認目標策略是否存在,以及 PROXY、DIRECT 或自訂策略名稱是否正確。先從請求記錄確認實際命中項目,再進行修改;儲存後重新發出請求,既有長連線可能不會立即套用新規則。

開啟後覺得耗電,On Demand 該如何調整?

先在系統電池用量中觀察同一時段的實際使用情況,分辨持續下載、訊號微弱、頻繁重新連線與用戶端背景活動。檢查記錄是否不斷出現連線失敗,並減少不必要的高頻測試或長時間記錄詳細資訊。On Demand 是依網路條件觸發連線的功能,不是固定的省電開關;請確認觸發條件是否造成反覆連線。測試時保持網路、協定與存取工作一致,一次只調整一項;單看狀態列的 VPN 圖示無法判斷實際耗電來源。

繼續閱讀:Global Routing 概念 · On Demand 概念 · 返回購買與核對問題