官方手冊 · 問題索引

Shadowrocket 常見問題

依取得、安裝、匯入、連線的順序查找。先確認裝置及既有資訊,再調整設定;若要刪除、重新安裝或清除設定,請先完成備份。

  • 全平台取得方式說明
  • 兩種取得方式
  • 依症狀查找

正版與購買

先確認產品、帳戶及取得方式,並區分 App 本身與連線所需的伺服器資訊。

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

可以。iPhone / iPad 版從 App Store 取得,$2.99 一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。先前往本站下載頁選擇裝置,電腦與 Android 安裝檔由本站 /dl/shadowrocket/ 路徑提供。Mac 需依晶片選擇版本,Linux 則需確認套件格式,請勿混用不同系統的安裝檔。各平台首次安裝時的系統允許步驟也列於下載頁。

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

請同時確認三項資訊:App 名稱為 Shadowrocket、開發者為 Shadow Launch Technology Limited,產品頁 App ID 為 932747118;再將圖示與本站頁首的官方圖示比對。名稱相似或搜尋結果排名靠前,都不能取代這些資訊。iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac / Windows / Android / Linux 版免費。商店實際金額以當地貨幣顯示,系統需求以 App Store 頁面標示為準。

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

先確認開啟的是 App Store,並檢查目前「媒體與購買項目」使用的 Apple ID 所屬地區,而不只是更改裝置語言。中國大陸商店未提供此 App,可透過本頁下方的產品頁連結確認目前店面是否能取得。若需更改地區,請在系統設定中進入 Apple ID 的「媒體與購買項目」,查看帳戶中的「國家或地區」,並依照 Apple 流程處理餘額、有效訂閱及付款資訊;只切換地區設定,不保證立即符合變更條件。

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

使用同一個購買帳戶,先到 App Store 的已購項目中尋找 Shadowrocket,再重新下載;iPhone 與 iPad 可共用同一帳戶的購買紀錄。iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac / Windows / Android / Linux 版免費。若商店仍顯示購買按鈕,先確認「媒體與購買項目」的登入帳戶及購買紀錄,請勿急著再次付款。重新下載 App 不等於還原設定,舊裝置上的設定與訂閱須另外備份及匯入。

購買 App 後,為什麼還需要自己的訂閱或伺服器資訊?

一次買斷 App ≠ 購買連線方案。iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac / Windows / Android / Linux 版免費。這些取得方式只適用於 App 本身,不包含可直接連線的伺服器。Shadowrocket 會依照既有參數建立連線並套用規則。訂閱連結請向你的服務供應商取得,也可使用自行管理的伺服器資訊。本站為官網與官方手冊,不提供節點服務;匯入前請先確認資訊有效,並妥善保管其中的憑證。

下載安裝與首次開啟

先確認系統與晶片版本,再處理單一檔案的安裝權限;受管理的裝置請遵循管理員政策。

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

點選 Mac 螢幕左上角的 Apple 選單,開啟「關於這台 Mac」。若顯示「晶片」且名稱為 Apple 系列,請選擇 Apple 晶片版;若顯示 Intel 處理器,請選擇 Intel 版。不要根據電腦外觀或購買年份推測。兩個版本的 dmg 都可在本站下載頁取得。開啟後將 App 移至 Applications,再依首次開啟時的提示操作;若系統提示無法驗證開發者,確認檔案來自本站後,前往「系統設定 → 隱私權與安全性」選擇「仍要打開」。

Windows 出現 SmartScreen 風險提示時該怎麼處理?

先確認安裝檔是從本站下載頁取得,路徑為 /dl/shadowrocket/,再檢查檔案是否已完整下載。若出現 SmartScreen 提示,展開「更多資訊」,確認目標檔案後選擇「仍要執行」。如果裝置受機構政策管理、沒有允許按鈕,或安全軟體明確回報威脅,請停止操作並交由裝置管理員判斷,不要關閉整套系統防護。只對已確認來源的檔案允許執行;電子郵件附件或來源不明的同名檔案不應照此處理。

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

先確認晶片版本及下載來源,並將 Shadowrocket 放入 Applications。若提示無法驗證開發者,嘗試開啟後前往「系統設定 → 隱私權與安全性」,找到對應的封鎖紀錄並選擇「仍要打開」。若提示 App 已損毀,先刪除不完整檔案,再從本站重新下載;確認來源和 App 路徑後,可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再嘗試開啟。此命令會移除延伸屬性,但無法修復真正損毀的檔案,也不應批次套用於未知 App。

iPad 可以安裝嗎?首次出現 VPN 設定要求正常嗎?

可以。iPad 可從 Shadowrocket 的 App Store 產品頁取得,裝置系統需求以 App Store 頁面標示為準。iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac / Windows / Android / Linux 版免費。匯入既有資訊並首次啟用連線時,系統可能會要求允許新增 VPN 設定;確認要求來自剛開啟的 Shadowrocket 後,再依系統提示授權並驗證裝置密碼。若裝置受管理或設有存取限制,請先檢查管理政策,不要反覆重新安裝 App。

Android 和 Linux 下載後無法開啟,應先檢查哪些設定?

Android 請先確認裝置適用 arm64 安裝檔;若瀏覽器提示需要權限,請在系統設定中只對實際用來安裝的 App 開啟「安裝未知的應用程式」,安裝完成後可撤回權限。Linux 請依發行版選擇 deb、rpm 或 AppImage;AppImage 須先授予執行權限,再執行下載的檔案。兩種系統的安裝檔都應從本站下載頁取得,並依照頁面上的安裝允許指引操作。若系統架構、發行版或相依套件不相容,請先處理相容性問題,不要反覆點選同一個檔案。

查看安裝允許指引與指令 →

訂閱管理

以下操作需已有有效訂閱或伺服器資訊。請先確認輸入來源,更新或清理前先備份。

已有訂閱連結,應該在哪裡匯入?

訂閱連結請向你的服務供應商取得。以 iPhone / iPad 為例,在 Home 進入 Add Server,選擇 Subscribe,將完整連結貼到 URL,並填寫方便辨識的備註,儲存後執行更新。貼上時請檢查開頭的協定、結尾參數,以及是否混入空格;不要把網頁標題或帳戶管理頁面網址當成訂閱連結。更新後確認清單出現預期項目,再選擇可用項目連線。訂閱連結通常含有存取憑證,請勿放入公開截圖、聊天紀錄或公開的設定範例。

訂閱匯入失敗或更新後清單空白,該如何排查?

先保留原有訂閱和設定,記下問題發生在儲存連結、要求更新,還是解析內容的階段。檢查連結是否完整、是否已過期,以及目前網路能否連上訂閱網址;若回傳登入頁、錯誤頁或空白內容,就無法解析為有效訂閱。接著向你的服務供應商確認連結適用於 Shadowrocket,且帳戶狀態正常。需要對照測試時,每次只變更一個條件,避免同時更換網路和連結,或刪除設定。分享錯誤訊息前,請遮住 URL 參數及伺服器憑證。

什麼時候需要更新訂閱?更新會造成哪些變更?

服務供應商調整伺服器、連接埠或憑證後,應更新對應的 Subscribe 項目;長時間未更新且連線異常時,也可先手動更新一次。更新會重新取得連結回傳的伺服器資訊,原有項目可能遭到取代或移除,因此請先記下目前使用的項目及個別修改過的參數。更新成功只代表已取得並解析內容,不表示每台伺服器都能連線。完成後重新選擇項目並測試;若錯誤持續發生,請勿頻繁重複更新,以免掩蓋最初的錯誤訊息。

使用 QR Code 匯入和手動填寫 Add Server 有什麼差別?

Scan QR Code 用來讀取 QR Code 中既有的連線資訊;手動使用 Add Server 則須逐項輸入參數,兩者都以原始資訊正確為前提。掃描前先確認 QR Code 來自你已有的伺服器資料;掃描後核對 Type、Address、Port,以及該協定所需的憑證。手動填寫時,Trojan 的密碼、TLS 與 SNI 等參數應與伺服器設定一致;不要只憑位址和連接埠猜測其他欄位。QR Code 也可能包含訂閱網址,匯入後請確認結果是訂閱群組還是單一伺服器。

多個訂閱出現重複項目,可以直接刪除嗎?

先依訂閱來源加上不同備註,再比較伺服器位址、連接埠、協定及必要參數,不要只看顯示名稱就判定重複。同名項目可能使用不同傳輸設定,不同名稱的項目也可能指向同一台伺服器。確認後,優先清除不再使用的訂閱群組,並安全備份原始連結;若只刪除訂閱產生的單一項目,下次更新時可能再次出現。清除前記下目前選取的項目,並檢查 Config 是否依名稱引用該項目,避免刪除後規則指向無效目標。

依步驟查看匯入與首次連線說明 →

規則分流與故障排查

分開驗證基本網路、伺服器連線、DNS 與規則。保留錯誤提示,每次只變更一個條件。

Home 的連線開關無法開啟或立刻跳回,該怎麼辦?

先閱讀當下的錯誤提示,確認已選取有效伺服器,並完成系統 VPN 設定授權。接著檢查系統中是否有其他 VPN 連線正在使用,以及裝置管理或存取限制是否禁止新增設定。可先關閉衝突的連線,再重新嘗試;仍然失敗時,請重新啟動裝置後再測試。不要一開始就刪除 App,否則尚未備份的設定可能遺失。只有在完成備份,且確認問題與舊 VPN 設定有關後,才考慮移除對應設定、重新開啟 Shadowrocket 並再次授權。

顯示已連線,但網頁無法開啟,排查順序為何?

先關閉連線測試基本網路,確認 Wi-Fi 或行動網路本身可用;再開啟 Shadowrocket,檢查目前的伺服器與 Global Routing。可用 Connectivity Test 作為連線參考,並比對多個網站,不要把單次測試結果當成所有流量的結論。若 Proxy 可以連線但 Config 不行,優先檢查規則、策略目標及 DNS;若兩者都失敗,優先確認伺服器參數及服務狀態。Direct 可用來比對直連路徑,切換至 Direct 不代表伺服器故障已修復。

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

配置(Config)會依照目前 Config 中的規則選擇策略,適合已確認規則內容後日常使用;代理(Proxy)會將相關連線交由所選代理處理,可用來比對排查規則問題;直連(Direct)則走直接連線路徑,可用來檢查基本網路。若要指定網站透過代理連線,請選擇 Config,並確認 DOMAIN-SUFFIX 等規則及 FINAL 預設規則,而不是一直停留在 Proxy。規則通常依序比對,較具體的條件應放在較寬泛的條件之前;修改後請重新建立連線並驗證。

介面是英文,應先認識哪些名稱?

本手冊保留英文介面用語,方便逐項對照:Home 是連線及伺服器相關操作的入口,Add Server 用於新增資訊,Subscribe 表示訂閱類型,Config 用於設定,Settings 用於設定選項,Global Routing 用來選擇路由模式。協定名稱和規則關鍵字也請依原文辨識,不要將翻譯後的詞寫入設定。介面顯示語言與伺服器能否連線是不同問題;若要調整顯示語言,可先查看系統的 App 語言選項,並以裝置和 App 實際提供的選項為準。

使用後覺得耗電增加,該關閉哪些項目來排查?

先在系統電池用量統計中,比較日常使用時間相近時的耗電情況;同時檢查背景下載、行動網路訊號和螢幕使用狀況,不要只憑 VPN 圖示判斷耗電來源。若連線頻繁重試,先處理不穩定的伺服器或網路切換問題;若啟用了持續診斷和詳細記錄,排查完成後請恢復日常設定。檢查 On Demand 的觸發條件是否符合實際需求,避免不必要的反覆連線。每次只調整一項並觀察,切勿為了降低耗電而取消必要的系統安全設定。

只有部分網域連線失敗,如何區分 DNS 和規則問題?

先記下失敗的網域、使用中的網路及發生時間,再檢查目前 Config 對該網域套用的規則和策略。網域解析失敗與伺服器連線逾時屬於不同階段,應搭配錯誤提示及記錄判斷;可在同一網路下比對 Config 與 Proxy,觀察是否只有規則路徑失敗。修改 DNS 前先儲存原有設定,確認解析要求所經路徑與策略一致,不要一次更換所有設定。若問題只在特定網路出現,先排查該網路的 DNS 解析連線狀況;分享記錄時請遮住憑證及個人瀏覽紀錄。