Shadowrocket 官方手冊

Shadowrocket 常見問題 安裝、訂閱與連線排查

先確認問題發生在哪個步驟,再依答案逐項檢查。安裝來源、訂閱內容與分流規則應分開處理,避免一次變更多項設定而無法判斷原因。

01 / GET & VERIFY

正版查核與價格

先區分裝置平台,再核對購買紀錄與商店資訊。取得客戶端與準備連線資料是兩回事。

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

可以。iPhone / iPad 版於 App Store 取得,$2.99 一次性付費;Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片版與 Intel 版,Windows 提供 64 位元安裝程式,Android 提供 arm64 安裝套件,Linux 提供 deb、rpm 與 AppImage。先前往客戶端下載頁依裝置選擇,電腦與 Android 安裝套件透過本站 /dl/shadowrocket/ 路徑下載;各平台的取得方式不同,請勿將手機商店的方式套用到所有平台。

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

開啟 Shadowrocket 的 App Store 產品頁,並核對開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118,別只依名稱或搜尋排序判斷。官方圖示是白底、藍紫色描邊的火箭,可與本站頁首圖示比對。iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。請勿將手機商店中標示免費的同名項目,誤認為本文介紹的應用程式。系統需求以 App Store 頁面標示為準。

購買應用程式後,還需要準備什麼?

需要先備妥自己的訂閱或伺服器資訊。一次買斷客戶端 ≠ 購買連線服務:購買應用程式取得的是客戶端使用資格,不會同時提供伺服器位址、訂閱連結或連線憑證。iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。本網站不提供、販售或推薦節點或訂閱;匯入前請向自己的服務供應商確認資料是否有效、是否適用於 Shadowrocket,以及相關服務目前是否可用。

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

先透過下載頁開啟指定產品頁,分辨是「搜尋沒有結果」還是「產品頁顯示目前所在國家或地區無法使用」。中國大陸 App Store 目前未提供此應用程式;是否看得到,取決於「媒體與購買項目」所使用的 Apple 帳號商店地區,而非裝置語言或系統地區。在系統 Settings 中前往 Apple 帳號、「媒體與購買項目」、「檢視帳號」,確認國家或地區。如需變更,請依照 Apple 系統中的國家或地區變更流程操作,並先確認餘額、現有訂閱及付款方式要求;更改裝置語言無法改變商店顯示內容。

換手機、重新安裝或在 iPad 上使用,需要再買一次嗎?

iPhone / iPad 版於 App Store 一次性付費 $2.99,兩種裝置通用;Mac / Windows / Android / Linux 版免費。更換 iPhone 或 iPad,或重新安裝時,請使用原先完成購買的 Apple 帳號,在 App Store 的已購項目或 App 清單中尋找並重新下載。若仍顯示購買價格,請先核對「媒體與購買項目」帳號及購買紀錄,不要直接重複付款。重新下載不代表設定已還原;換機前仍應備份 Config 與現有訂閱資料。是否適用家人共享,請以產品頁及家庭設定的顯示為準。

02 / INSTALL & OPEN

下載安裝與首次開啟

先選擇正確架構,再處理目前檔案對應的系統提示。不要為了安裝一次而關閉整套安全防護。

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

在 Mac 的 Apple 選單開啟「關於這台 Mac」:若看到「晶片」及 Apple 晶片名稱,請選 Apple 晶片版;若看到「處理器」及 Intel 名稱,請選 Intel 版。請勿依外觀或購買年份猜測。下載頁為兩種架構分別提供 dmg。開啟後將 Shadowrocket 移至 Applications,再從該位置啟動。若出現「無法驗證開發者」,確認安裝套件來自本站後,前往系統設定的「隱私權與安全性」選擇「仍要打開」;其他提示的處理方式請見下一則問答。

Windows 或 Mac 顯示有風險、無法開啟,該怎麼處理?

先確認檔案來自本站下載頁;來源不明時請停止操作。Windows 出現 SmartScreen 提示時,核對來源後可選擇「更多資訊 → 仍要執行」;若選項受到組織原則限制,請聯絡裝置管理員。Mac 顯示「無法驗證開發者」時,先嘗試開啟一次,再前往「隱私權與安全性」選擇「仍要打開」。若顯示「已損毀」,請先重新下載並移至 Applications,確認來源後可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再嘗試開啟。僅對已確認來源的 App 執行上述處理,請勿全面關閉系統防護。

Android 或 Linux 下載後,如何完成首次安裝?

Android 請從下載頁取得 arm64 安裝套件;若無法在微信內開始下載,請改用系統瀏覽器開啟本站。遇到安裝限制時,只需允許這次使用的瀏覽器或檔案管理員「安裝未知的應用程式」,安裝完成後即可撤銷權限。Linux 請依發行版選擇 deb 或 rpm;AppImage 需先設定可執行權限,例如在檔案所在目錄執行 chmod +x Shadowrocket.AppImage,再執行檔案,檔名以實際下載的檔案為準。若系統仍顯示錯誤,請保留完整提示,不要反覆改用來源不明的檔案。

首次開啟時連線開關無法啟用,該從哪裡檢查?

先確認 Home 中已有可用的伺服器項目並選取目標,再嘗試開啟連線開關。iPhone / iPad 首次連線時會要求新增 VPN 設定,請依系統提示確認並完成裝置驗證;若取消授權,開關可能立即關閉。接著檢查系統的 VPN 設定,確認沒有其他連線互相衝突,並留意受管理裝置是否限制新增設定。不要一開始就刪除所有系統設定;先記下 App 內的錯誤,再依「權限、現有設定、網路連線能力」的順序排查。

介面是英文,應先認識哪些功能入口?

先認識 Home、Config、Settings 和 Data,再查看目前頁面中的具體選項。Home 用於查看伺服器與連線狀態,Config 用於管理設定,Settings 集中各項應用程式設定,Data 用於查看流量資訊。Global Routing 下的 Config、Proxy、Direct 是連線處理方式,不是三個伺服器群組;Add Server 與 Subscribe 則用於新增資料。本手冊保留這些英文原文,方便逐項對照。不同平台或 App 介面的版面可能不同;找不到時先依入口名稱尋找,不要只照著按鈕位置操作。

03 / SUBSCRIBE & CONFIG

訂閱與伺服器匯入

以下操作以已備妥自己的訂閱或伺服器資訊為前提。請先保留原始資料,再進行匯入、更新與移轉。

如何將現有訂閱匯入 Shadowrocket?

先向自己的服務供應商取得完整訂閱連結,確認複製的是訂閱網址,而非登入或付款頁面。在 Home 中進入 Add Server,選擇 Subscribe,填入方便辨識的名稱與完整 URL,儲存後執行更新,並等待項目出現。匯入後先選取一台伺服器,再檢查連線;只將連結存入清單不代表已連線。訂閱 URL 可能包含存取憑證,請勿貼到公開聊天室、截圖或留言中。詳細操作流程可參閱教學,匯入前也請保留原有訂閱資料。

訂閱匯入失敗、內容為空或顯示格式錯誤,該怎麼辦?

先檢查連結是否完整,尤其是結尾參數;移除複製時帶入的空格與換行,但不要自行修改有效字元。再確認目前網路能連線至訂閱網址,並核對服務是否到期、連結是否已重設。若開啟後是登入頁面、網頁錯誤或空白內容,都無法作為有效訂閱解析;即使瀏覽器能開啟,也不代表內容格式適用。仍無法匯入時,記下完整錯誤訊息與發生步驟,向自己的服務供應商確認訂閱格式;回報時請遮住 URL 中的憑證,也不要反覆刪除現有可用群組。

如何更新現有訂閱?更新後選取項目會改變嗎?

在 Home 找到對應的 Subscribe 群組,使用該群組的更新功能;完成後核對伺服器清單、選取項目及錯誤提示。更新只會取得該網址目前提供的內容,不會延長現有服務的有效期限。服務供應商若變更名稱或移除項目,原先的選取可能不再適用,因此應重新確認目標伺服器,而不是只看更新是否完成。管理多個訂閱時,請為各群組使用不同名稱,逐一更新並保留原始網址;更新不必重新匯入相同訂閱。

手動新增伺服器時,協定和欄位應如何填寫?

依照現有伺服器資料選擇協定,再逐一填入位址、連接埠及驗證資訊,不要只憑連接埠號碼推測協定。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等資料的欄位並不通用,TLS、SNI、傳輸方式等也應與伺服器端一致。可透過 Scan QR Code 匯入 QR Code 資料,但儲存前仍須核對內容。若只有伺服器位址而缺少驗證參數,應先補齊資料;更改協定名稱無法修正不相符的設定。連線失敗時,只修改已確認有誤的欄位。

Subscribe 和 Config 有什麼不同?換機時如何保留?

Subscribe 主要用來更新現有伺服器清單;Config 用來管理規則、策略及相關設定,兩者不是同一份資料。伺服器出現在 Home,不代表已啟用預期的 Config。換機前應分別保留訂閱來源與 Config 設定,並確認其中的策略名稱仍能對應現有伺服器。設定匯出檔可能含有敏感參數,請儲存在自己能控制的位置;使用 iCloud 同步時,也要在新裝置上實際確認還原結果。先確認新裝置能連線,再清除舊裝置資料,避免誤以為重新下載 App 就已完成資料移轉。

04 / ROUTING & CONNECTION

規則分流與連線故障

維持測試目標一致,每次只變更一項。先區分原始網路、伺服器與 Config 規則問題。

Global Routing 的 Config、Proxy、Direct 三種模式該如何選擇?

一般可先選 Config,讓目前 Config 中的規則決定連線策略;Proxy 會讓由客戶端處理的連線採用代理路徑,方便檢查伺服器是否可用;Direct 則讓受處理的連線直接存取,方便與原始網路比較。此處中文僅用來說明模式,介面選項仍以 Config、Proxy、Direct 為準。排查時每次只切換一種模式,並存取同一個目標:Proxy 可用但 Config 不通時,優先檢查規則與策略的對應關係;Direct 也失敗時,應先檢查原始網路。

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

連線圖示出現只代表系統已建立連線,不表示遠端伺服器、DNS 和所有網站都能正常使用。先中斷連線,確認原始網路能正常存取,再連線並檢查目前選取的伺服器。可使用 Connectivity Test 輔助判斷連線能力,但測試結果不代表所有服務都正常。接著以 Proxy 和 Config 測試同一目標,查看 App 提供的連線記錄或錯誤資訊,區分驗證、逾時、DNS 與規則問題。每次只變更一項並記錄結果;若伺服器本身無法使用,應向自己的服務供應商確認,不要持續改寫本機規則。

只有部分網站連線路徑錯誤,該如何檢查分流規則?

先確認 Global Routing 使用 Config,且已啟用預期的設定。規則通常依序比對,符合後便採用該規則指定的策略;較廣泛的規則若排在前面,後續更精確的規則可能無法生效。檢查 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP 與 IP-CIDR 的條件是否符合目標,再確認 PROXY、DIRECT、REJECT 或自訂策略名稱是否正確引用。FINAL 用於此前規則都未符合的情況,不應當作精確網域規則。修改前先保留原設定,使用一個明確目標測試後,再擴大調整範圍。

On Demand 為什麼會自動連線?如何避免反覆切換?

On Demand 會依設定的網路條件觸發連線;啟用後在條件符合時自動連線是預期行為。若手動中斷後又重新連線,先檢查 On Demand 的 Wi-Fi、行動網路及相關條件,不要直接認定開關失效。排查連線問題時,可暫時關閉 On Demand,再手動連線比對結果;確認穩定後再逐項恢復條件。若網路在 Wi-Fi 與行動網路間頻繁切換,也要檢查是否有互相衝突的條件。由公司或學校管理的裝置也可能受到系統策略影響,請先確認管理限制。

感覺耗電增加,該如何判讀 Data 中的流量?

先在系統電池用量統計中比較相近的使用時間與網路條件,再搭配 Data 查看傳輸情況,不要只憑開啟連線後的主觀感受判斷。訊號微弱、持續傳輸、伺服器反覆重新連線,以及長時間執行測試,都可能增加耗電;排查時請停止連續測試,保留日常所需設定,並分別觀察 Wi-Fi 與行動網路。Data 是客戶端查看流量的入口,不能取代服務供應商的計費紀錄或系統行動網路統計;統計範圍與重設時間不同,數值可能有差異。記錄發生時段、連線方式及重新連線情況,比只截取單一流量數值更有助於找出問題。