官方手冊 · 疑難排解

Shadowrocket
安裝與連線問題

先確認問題發生在哪個步驟,再依分類逐項檢查。以下操作以 iPhone / iPad 介面為例,電腦與 Android 的安裝問題另行說明。

點選問題即可展開答案,也可以同時開啟多個項目對照。若要操作既有訂閱或伺服器,請先保留原始資訊。

STORE / ACCOUNT

正版確認與購買

先確認取得管道與購買帳號,再處理商店地區、更換裝置及裝置相容性。

查看正版確認說明 →
iPhone / iPad 與其他平台分別如何取得?

iPhone / iPad 版在 App Store 一次性付費 $2.99,Mac / Windows / Android / Linux 版免費。iPhone / iPad 請從本頁提供的 App Store 產品頁前往,系統需求以 App Store 頁面標示為準。其他平台請至本站下載頁選擇對應安裝檔,檔案位於本站 /dl/shadowrocket/ 路徑下。安裝時若遇到系統封鎖,請先參照「安裝與首次開啟」的相關說明確認,再決定是否允許。

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

先確認 Apple ID 所屬的商店地區,而非裝置語言或目前的網路位置。中國大陸商店沒有此 App;可在系統 Settings 中依序前往 Apple 帳號、Media & Purchases、View Account,再查看 Country/Region。若需更改地區,請從該頁面選擇 Change Country or Region,並依 Apple 提示處理餘額、訂閱與付款資料;不要只為了搜尋結果而反覆更改地區。

如何在商店確認是否為 Shadowrocket?

請一併確認開發者為 Shadow Launch Technology Limited、本站展示的官方圖示,以及產品連結末尾的 App ID 932747118。不要只憑搜尋結果中的名稱或相似圖示判斷。進入產品詳情頁後,再確認裝置相容性與購買資訊;若搜尋結果與這三項不符,請回到本站的產品頁入口重新確認。電腦與 Android 版本請從本站下載頁取得,不要以搜尋結果中的同名安裝檔為準。

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

iPhone / iPad 版在 App Store 一次性付費 $2.99,Mac / Windows / Android / Linux 版免費。更換裝置或重新安裝時,請先登入原先購買所用的 Apple ID,再到 App Store 的已購項目中找到 Shadowrocket 並重新下載。若頁面仍顯示價格,請先確認購買帳號與商店地區,不要重複付款。購買紀錄不等於設定備份,原裝置中的伺服器、訂閱與規則仍須另行保存或重新匯入。

iPad 可以安裝嗎?與 iPhone 的購買紀錄如何共用?

可以。iPhone / iPad 版在 App Store 一次性付費 $2.99,兩種裝置可使用同一購買帳號取得;Mac / Windows / Android / Linux 版免費。在 iPad 上登入購買時使用的 Apple ID,並從已購項目找到 Shadowrocket;裝置系統需求以 App Store 頁面標示為準。首次使用仍須匯入自己的伺服器或訂閱,並確認連線權限;iPhone 上已有的設定不會因為有購買紀錄,就自動完整同步到 iPad。

購買用戶端後,就會有可用的連線嗎?

用戶端一次買斷 ≠ 連線服務方案。iPhone / iPad 版在 App Store 一次性付費 $2.99,Mac / Windows / Android / Linux 版免費;這是用戶端的兩種取得方式。開始設定前,使用者須已有自己的訂閱或伺服器資訊。本站不提供任何節點或訂閱。匯入後若遇到驗證失敗、服務到期或連線失敗,請檢查既有服務的參數與狀態,而非重複購買用戶端。

INSTALL / PERMISSION

安裝與首次開啟

分辨安裝檔不相符、系統封鎖與尚未確認連線權限,避免混為一談。

查看允許安裝的步驟 →
電腦和 Android 可以使用 Shadowrocket 嗎?

可以。Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費;iPhone / iPad 版在 App Store 一次性付費 $2.99。請到本站下載頁選擇裝置對應版本,不要混用不同作業系統的安裝檔。桌面與 Android 安裝檔未經程式碼簽署,首次開啟時可能出現系統提示;Windows 請查看 SmartScreen,Mac 請查看「隱私權與安全性」,Android 請查看「允許安裝未知應用程式」,詳細步驟見本分類後續問答。

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

開啟 Apple 選單中的「關於這台 Mac」,查看「晶片」或「處理器」欄位。若顯示 Apple 晶片,請選 Apple 晶片版;若顯示 Intel,請選 Intel 版。不要依機身外觀或購買年份猜測。兩個下載入口都在本站下載頁的 Mac 區塊。請先將 App 移至 Applications,再開啟;若系統提示無法驗證開發者,請參照下一則 Mac 允許開啟說明確認來源,並在「隱私權與安全性」中處理。

Windows 出現 SmartScreen 提示時該如何處理?

先確認安裝檔是從本站下載頁取得,且位於本站 /dl/shadowrocket/ 路徑下。若 SmartScreen 顯示已封鎖執行,可展開「其他資訊」,確認 App 後選擇「仍要執行」。系統政策或組織管理設定可能不會提供此按鈕,此時請聯絡裝置管理員,不要更改整台裝置的安全性政策。若提示來自其他安全性元件,或無法確認檔案來源,請先取消操作並記下完整提示,再判斷原因。

Mac 提示無法驗證開發者或 App 已損壞,該如何允許開啟?

先確認檔案來自本站下載頁,並將 Shadowrocket 移至 Applications。若遇到「無法驗證開發者」,請先嘗試開啟一次,再前往系統設定的「隱私權與安全性」,找到相關封鎖紀錄並選擇「仍要打開」。若提示「已損壞」,只有在確認來源與 App 路徑正確後,才在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再嘗試開啟。若裝置受組織管理,請依管理員要求處理,不要關閉整台裝置的防護功能。

Android 與 Linux 首次安裝遭到封鎖時,分別要檢查什麼?

Android 請先確認安裝檔來自本站,再到系統設定中只為目前用來開啟檔案的瀏覽器或檔案管理員啟用「允許安裝未知應用程式」,完成後可關閉此權限。Linux 請選擇符合發行版的 deb、rpm 或 AppImage;AppImage 可在檔案屬性中允許執行,或使用 chmod +x 加上實際檔名設定執行權限,再啟動。若裝置政策禁止安裝,請聯絡管理員,不要繞過組織限制。

Home 的連線開關無法開啟,或介面顯示英文時該如何排查?

先在 Home 選取一筆參數完整的伺服器,再嘗試開啟連線開關,並留意系統是否跳出新增 VPN 設定的確認視窗。iPhone / iPad 請依系統提示授權;若關閉了確認視窗,請重新發起連線。仍無法連線時,請停止其他正在運作的 VPN 連線,並檢查裝置管理限制。英文介面可依 Home、Config、Data、Settings 尋找,不要只靠圖示猜測;本手冊保留這些介面詞的英文原文。

IMPORT / SUBSCRIBE

訂閱與匯入

以下步驟假設使用者已有自己的訂閱或伺服器資訊,請先辨認內容類型,再選擇匯入入口。

Add Server Subscribe Scan QR Code
查看完整操作教學 →
既有訂閱與單筆分享連結的匯入入口相同嗎?

不完全相同。先判斷內容是單筆伺服器分享資訊,還是會回傳伺服器清單的訂閱網址。單筆資訊可使用 Scan QR Code,或依 Add Server 中實際提供的入口填寫;訂閱則在 Add Server 選擇 Subscribe,填入自己已有的訂閱網址。不要把訂閱網址當成伺服器網址填入協定參數,也不要把多個分享連結直接串成一個網址。匯入後回到 Home,確認分組與項目是否出現。

Subscribe 匯入失敗,應依什麼順序檢查?

先檢查複製的網址是否完整,前後有沒有空格、換行或通訊軟體附加文字;再確認它是訂閱網址,而非登入頁面或帳號管理頁面。接著確認既有服務是否到期、網址是否已重設,以及目前網路能否完成連線要求。若出現錯誤,請分別記錄並處理要求失敗、驗證失敗或內容解析失敗等提示。不要將含有存取憑證的完整訂閱網址公開在截圖或討論中。

如何更新既有訂閱?更新前要備份什麼?

在 Home 找到對應的訂閱分組,進入該分組的編輯或操作入口,使用目前版本提供的更新功能;不要只更新個別伺服器的備註。更新前請記下目前選用的伺服器,並備份手動修改過的參數,因為訂閱回傳的新內容可能會覆寫項目或移除舊項目。更新後確認分組中的伺服器名稱、數量變化與目前選用項目,再進行連線測試。若更新失敗,先保留現有項目,不必立刻刪除整個分組。

掃描後沒有出現伺服器,可以直接再掃一次嗎?

先確認 QR Code 是否包含完整的伺服器分享資訊或可辨識的訂閱內容,而不是帳號網頁入口。使用 Scan QR Code 時請允許相機存取,並確保 QR Code 完整清晰。若內容來自相簿,請使用目前介面提供的圖片辨識入口。出現失敗提示後先查看原因,再試一次;連續掃描可能新增重複項目。成功後回到 Home,確認實際新增的內容,並逐項比對自己已有的參數。

Add Server 中有許多參數,哪些不能憑猜測填寫?

Type、伺服器位址、連接埠與驗證資訊必須符合既有伺服器資料;若涉及 TLS、SNI 或傳輸方式,也應依據相關資料填寫。尤其不要把 SNI 當成任意備註,也不要在沒有依據時關閉 TLS 相關檢查。Shadowsocks、VMess、VLESS、Trojan 等協定的欄位意義並不相同。儲存後先測試單一伺服器,再加入日常使用的設定;若缺少參數,請回頭查閱既有服務的說明。

更換裝置或重新安裝前,如何整理訂閱與設定?

請分開整理伺服器資訊、訂閱網址,以及 Config 使用的設定檔,並記錄目前的 Global Routing 選項與必要的手動修改。購買紀錄只能用來重新取得 App,不能取代這些內容的備份。匯出或複製時,請使用自己掌控的儲存位置,避免公開分享含有密碼或存取憑證的檔案。在新裝置匯入後,先檢查參數與規則,再建立連線;不要只因檔名相同,就認定內容已完整還原。

ROUTING / DIAGNOSIS

規則分流與疑難排解

每次只變更一個條件。連線開關、伺服器連線狀態、DNS 與目標要求是不同的檢查層次。

PROXY DIRECT REJECT
查看完整使用手冊 →
Global Routing 的配置、代理、直連三種模式該如何選擇?

日常依規則使用時選擇配置,對應 Config,由目前設定檔中的規則決定流量策略;代理對應 Proxy,讓適用流量經由目前的代理路徑;直連對應 Direct,用來確認流量是否不經代理。Proxy 不會自動修復伺服器驗證或 DNS 問題,Direct 也不代表刪除設定。排查時一次只切換一種模式,記錄同一目標的結果;測試結束後,請切回原本預定使用的模式。

開關顯示已連線,但網頁無法開啟,該先檢查什麼?

先暫時中斷連線,確認裝置本身的網路正常;再檢查目前伺服器是否仍有效、驗證參數是否變更,並使用 Connectivity Test 取得初步結果。接著確認 Global Routing 與 Config 中實際啟用的檔案,避免把規則未匹配誤認為伺服器故障。最後檢查 DNS 是否能正常解析目標。每次只更改一項設定,並分別記錄網頁、App 與測試結果;連線開關的狀態本身不代表目標要求已成功。

Config 中有規則,為什麼目標仍未依預期分流?

先確認 Global Routing 已選擇 Config,再確認 Config 啟用的是剛才編輯的檔案。規則通常依序比對,前面的寬泛規則可能先於後面的特定規則生效;請檢查 DOMAIN、DOMAIN-SUFFIX、IP-CIDR 等條件是否符合實際要求,並確認 FINAL 的最終策略。規則中的 PROXY、DIRECT、REJECT 與具體策略參照也必須有效。排查時先鎖定單一目標,不要一次重寫整份規則。

調整 DNS 後仍有異常,還要繼續更換位址嗎?

不要連續疊加修改。先記錄修改前的 DNS 設定,確認目前設定確實使用新設定,再判斷是所有網域、部分網域,還是只有特定 App 失敗。若只有網域存取異常,請檢查解析結果與要求路徑;若伺服器本身也無法連線,應先處理伺服器連線問題。還原到可理解的基本設定後逐項測試,比同時更換 DNS、伺服器和規則更容易找出原因。

使用時耗電增加,應該關閉 On Demand 嗎?

先在系統電池頁面比較使用時間和網路條件相近時的耗電量,再參考 Data 查看實際流量。訊號微弱、頻繁重新連線、持續傳輸或過於密集的測試都可能增加耗電,不宜只憑單次電量變化判斷。On Demand 用於依條件觸發連線,是否關閉應視使用需求而定;排查時可暫時關閉,觀察手動連線是否穩定,再逐項恢復條件。測試期間避免同時更改伺服器、規則與連線觸發設定。

排查後仍有問題,應保留哪些資訊?

記錄裝置系統、問題發生時使用的網路類型、Global Routing 模式、目前設定檔名稱,以及完整錯誤提示。補充說明問題是否影響所有目標、能否在另一個網路重現,以及最近是否更新過訂閱或設定。可用 Connectivity Test 與 Data 協助確認狀況,但測試結果不能取代實際目標存取。分享紀錄前請遮蔽伺服器位址、密碼與完整訂閱網址,只保留排查問題所需的介面詞與錯誤內容。

Shadowrocket 官方下載