[FAQ]官方手冊

Shadowrocket 常見問題

從取得與安裝開始,依序檢查訂閱、設定與連線問題。先確認目前使用的裝置與錯誤訊息,再展開對應問答;操作前請保留現有可用設定。

全平台取得 既有訂閱匯入 規則與連線排解

尚未安裝?請先查看全平台下載與安裝說明。首次使用可依照快速上手逐步操作。

[Verify]

正版與購買

先確認平台、商店產品頁與購買帳號,再處理地區或還原問題。

電腦和 Android 能用嗎?各平台如何取得?

可以。Shadowrocket 提供 iPhone、iPad、Mac、Windows、Android 與 Linux 版本。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。前往全平台下載頁選擇裝置;電腦與 Android 安裝檔由本站 /dl/shadowrocket/ 路徑提供。用戶端一次買斷 ≠ 連線服務方案,安裝後仍須匯入自己已有的訂閱或伺服器資訊。本站不提供、不販售、不推薦節點或訂閱。

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

開啟本頁提供的 App Store 產品頁,確認名稱為 Shadowrocket、開發者為 Shadow Launch Technology Limited,且連結中的 App ID 為 932747118;圖示應為白底、藍紫色描邊的火箭。不要只憑搜尋結果中的相似名稱判斷。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。電腦與 Android 請使用本站下載頁提供的安裝檔,不需先有行動版商店購買紀錄才能安裝其他平台版本。

App Store 搜尋不到時,該確認哪些項目?

中國大陸 App Store 目前不提供此 App 的搜尋與下載。請先在系統 Settings 依序前往 Apple Account → Media & Purchases → View Account → Country/Region,確認實際用於購買項目的帳號所屬地區,不要只看裝置語言或系統地區。再開啟指定產品頁,確認目前商店是否提供此 App。如需更改地區,請使用該頁面的 Change Country or Region,並先閱讀 Apple 對帳戶餘額、現有訂閱與付款方式的要求;更改裝置語言不會改變商店地區。

換機或重新安裝後,需要重新購買嗎?

iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。iPhone 或 iPad 使用原購買帳號登入 Media & Purchases 後,可在 App Store 的已購項目中尋找並重新下載,通常不必再次付費;若仍顯示購買按鈕,請先確認購買帳號與購買紀錄。還原 App 不代表設定也會還原,訂閱、Config 檔案與本機參數仍須個別確認。電腦與 Android 換機後,可重新從本站下載頁取得對應安裝檔。

iPad 可以安裝嗎?iPhone 的購買項目也通用嗎?

可以。iPhone / iPad 版在 App Store 一次性付費 $2.99,使用同一個購買帳號即可在這兩類裝置下載;Mac / Windows / Android / Linux 版免費。iPhone 與 iPad 的系統需求以 App Store 頁面標示為準,安裝前請查看產品頁的相容性資訊。兩部裝置上的連線開關、選取的伺服器與目前設定都需分別確認;購買項目通用不代表連線狀態會自動同步,也不代表既有服務允許兩部裝置同時連線。

[Install]

安裝與首次開啟

確認安裝檔來源與系統架構,依系統提示允許開啟,再檢查連線權限。

Mac 應下載 Apple 晶片版還是 Intel 版?

在 Mac 的 Apple 選單中開啟「關於這台 Mac」:若看到「晶片」及 Apple 晶片名稱,請選擇 Apple 晶片版;若看到 Intel 處理器,則選擇 Intel 版。下載頁提供兩種對應的 dmg,請勿依機身外觀或購買年份判斷。開啟 dmg 後,將 Shadowrocket 移至 Applications。首次開啟若提示無法驗證開發者,請確認安裝檔來自本站,再到系統設定的「隱私權與安全性」選擇「仍要打開」;不要為了開啟單一 App 關閉整部 Mac 的安全防護。

Windows 或 Mac 顯示安全性警告時,該如何處理?

先確認檔案是從本站下載頁取得。Windows 出現 SmartScreen 提示時,確認來源後可選擇「更多資訊 → 仍要執行」;受組織管理的電腦可能需要管理員核准。Mac 若提示無法驗證開發者,請在「隱私權與安全性」中選擇「仍要打開」。若明確提示 App「已損壞」,請先重新下載並移至 Applications,確認來源後再執行 xattr -cr /Applications/Shadowrocket.app。若來源不明,或安全軟體指出具體威脅,請停止操作,不要直接忽略警告。

Android 與 Linux 首次安裝時要注意什麼?

Android 安裝檔請從本站下載頁取得;若無法在微信中下載,請改用系統瀏覽器開啟。在系統設定中,只為實際用來安裝的瀏覽器或檔案管理員開啟「允許安裝未知應用」,安裝完成後可關閉此權限。Linux 請依發行版選擇 deb、rpm 或 AppImage;AppImage 須先在檔案屬性中允許作為程式執行,或使用 chmod +x 後執行。安裝前確認系統架構;若遭組織政策阻擋,請聯絡管理員。具體指令與各平台解除阻擋步驟請參閱下載頁的安裝說明。

Home 的連線開關無法開啟或一開就關閉,怎麼辦?

先確認 Home 中已選取有效伺服器;匯入伺服器清單不代表已選取伺服器。首次連線時,請允許系統建立 VPN 設定;若先前拒絕過權限,可再次嘗試連線並檢查系統的 VPN 設定。接著暫停其他正在使用 VPN 通道的 App,確認是否有通道衝突。若開關立即關閉,請查看 Log 中最早出現的錯誤,優先檢查設定語法、憑證、連接埠與權限。不要連續重新安裝;先備份現有 Config 與訂閱資訊,再依具體錯誤處理。

介面是英文,建議先認識哪些項目?

先用 Home 找到伺服器清單與連線開關,用 Add Server 新增伺服器或 Subscribe,用 Config 管理規則檔案,用 Settings 查找 App 設定。Global Routing 中的 Config、Proxy、Direct 分別代表設定、代理與直連三種模式。本手冊保留這些英文介面用語,方便逐項核對;若裝置提供 App 語言選項,可到系統 Settings 查看 Shadowrocket 的語言設定。選單位置可能因系統與平台而異,請以裝置目前顯示為準。

相關參考:安裝允許設定步驟 · 介面用語與術語表

[Subscribe]

訂閱匯入

以下操作以你已有自己的訂閱或伺服器資訊為前提。

既有訂閱匯入失敗,應先檢查什麼?

先確認取得的是既有服務的訂閱連結,而非帳號登入頁、網頁分享頁或單一伺服器連結。在 Add Server 中選擇 Subscribe 後貼上完整網址,檢查前後空格、換行,以及複製時是否漏掉查詢參數。若回傳空清單,請確認服務狀態、連結有效期限與訂閱格式;若回傳網頁內容,通常是網址類型不符或存取驗證未通過。請勿將完整訂閱網址貼到公開留言或截圖中,其中的 token 可能讓他人讀取你的服務設定。

手動輸入伺服器或掃描 QR Code 後仍無法使用?

在 Add Server 中確認 Type 與既有伺服器使用的協定一致,再逐項檢查 SERVER、Port、Password 或 UUID,以及 TLS、SNI、傳輸方式等其他參數。Scan QR Code 只會將 QR Code 內容讀入用戶端,無法保證內容完整或伺服器可用。匯入後重新開啟項目,與原始資訊逐項比對,尤其留意密碼中的符號及伺服器網址前後的空格。不要為了連線成功而隨意關閉 TLS 驗證,應先修正憑證名稱、SNI 或伺服器端設定。

如何更新訂閱?更新失敗會有什麼影響?

在 Home 找到對應的訂閱群組,使用其中的更新功能;更新後檢查伺服器清單與目前選取的項目。更新失敗時,先保留現有可用設定,確認裝置能連上訂閱網址,再檢查網址是否變更、服務是否到期,以及回傳內容是否為有效訂閱。不要反覆刪除再重建,以免遺失手動修改的內容。更新訂閱主要是更新訂閱內的伺服器資訊,不會同時更新 Config 中的規則檔案,兩者應分別檢查。

訂閱與 Config 設定檔有什麼不同?

訂閱通常用來維護伺服器清單,Config 檔案則用來整理 DNS、規則與策略等設定。訂閱可用不代表已啟用正確規則;有規則檔案也不代表已有可連線的伺服器。先在 Home 選擇伺服器,再到 Config 確認要使用的檔案,最後將 Global Routing 設為 Config。編輯前保留原始檔案副本,每次只修改一類設定,遇到問題時才能判斷原因是伺服器參數、規則順序還是 DNS 設定。

更換裝置前應備份哪些內容?

分別記下訂閱來源、手動設定的伺服器參數、目前啟用的 Config 檔案,以及 DNS、On Demand 等自行修改的設定。使用 iCloud 同步時,先確認系統 iCloud 權限與 App 內的同步狀態,不要把開啟同步開關視為備份已完成。匯出的設定檔可能包含網址與登入憑證,請儲存在自己掌控的位置。新裝置還原後,先確認檔案與伺服器是否齊全,再選擇伺服器、設定 Global Routing 並測試連線;確認還原成功後再清除舊裝置資料。

相關參考:首次匯入與連線流程 · Settings 設定項目參考

[Rule]

規則分流與故障排解

每次只變更一個條件,區分基本網路、伺服器連線與規則比對問題。

Global Routing 的三種模式該怎麼選?

Config 會依目前設定檔中的規則決定請求策略,適合需要規則分流的情境;Proxy 通常會將請求交由選取的代理處理,可用來短暫確認伺服器是否可用;Direct 則讓請求直接連線,可與代理連線路徑互相比較。日常依規則使用時請選擇 Config,並確認規則中設定的策略存在。切換模式只會改變請求處理方式,無法修正伺服器參數錯誤。測試後請恢復原本模式,避免長期保留暫時用於排查的設定。

顯示已連線,但網頁無法開啟,怎麼辦?

先中斷連線,確認目前的 Wi-Fi 或行動網路本身能正常瀏覽網頁,再重新連線並查看 Log。可暫時切換到 Proxy 測試:若 Proxy 可用但 Config 不行,請優先檢查規則順序、策略名稱與 DNS;若兩者都無法使用,請確認目前的伺服器參數與服務狀態。Connectivity Test 只反映指定測試目標與方式的結果,不能證明所有網站都能連線。每次只變更一個條件,並記錄測試模式、網路類型與無法連線的網域。

Shadowrocket 無法連線,應依什麼順序排查?

依序檢查本機網路、系統權限、伺服器參數、服務狀態與規則設定。先確認基本網路正常,再確認 VPN 權限與已選取的伺服器;接著檢查 SERVER、Port、身分驗證資訊、TLS 與裝置時間,最後查看 Log 中首次失敗的紀錄。連線逾時、驗證失敗與憑證錯誤的原因各不相同,不要一概歸咎於規則。向既有服務的維護人員回報時,提供已移除敏感資訊的錯誤摘要與發生條件,不要傳送完整訂閱網址、密碼或含有憑證的設定檔。

規則看起來正確,為什麼仍套用錯誤的策略?

先確認 Global Routing 目前設為 Config,且啟用的是剛編輯的檔案。規則通常依序比對;若較寬泛的 DOMAIN-KEYWORD 或 IP-CIDR 排在前面,可能會先於後方的具體規則命中;FINAL 通常應放在最後。接著查看實際請求使用的網域、IP 與 DNS 結果,不能只依瀏覽器網址列推斷所有連線狀況。變更 DNS 後重新發出請求,必要時重新建立連線,避免舊連線與快取影響判斷;每次只調整一條規則並查看記錄。

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

先在系統電池用量統計中,比較使用時間與網路條件相近的情況。長時間傳輸、網路訊號微弱、頻繁重新連線及持續記錄詳細 Log 都可能增加耗電。排查結束後,請恢復一般記錄設定,避免反覆測速或執行 Connectivity Test。若連線會自動恢復,請檢查 On Demand 的網路觸發條件;它是依條件建立連線的功能,不是改善連線品質的開關。先關閉相關條件進行比較,再依需求逐項啟用,並分別在 Wi-Fi 與行動網路下確認觸發結果是否符合預期。

繼續閱讀:DNS、On Demand 與 Log 設定說明