兩種裝置可使用同一購買帳號的購買記錄。取得前請核對應用程式名稱、開發者與應用程式 ID;更換裝置時先查已購項目,不必將重新下載誤認為重新購買。實際下載資格以目前帳號的商店顯示為準。
Shadowrocket 使用指南
下載、設定與連線
全平台規則代理用戶端,支援規則分流。iPhone / iPad 在 App Store $2.99 一次性付費,Mac、Windows、Android、Linux 版免費。
目前版本 等候讀取 · Mac、Windows、Android、Linux 版免費
首次使用:依步驟匯入與連線 →
依裝置選擇 Shadowrocket
iPhone / iPad 在 App Store $2.99 一次性付費;Mac、Windows、Android、Linux 版免費。電腦與 Android 安裝檔可從本站下載頁取得,連結位於本站 /dl/shadowrocket/ 路徑。請先確認裝置與檔案格式,再進行安裝。
在「關於這台 Mac」查看晶片或處理器資訊,再選擇對應版本,不要根據電腦外觀判斷。首次開啟若提示無法驗證開發者,確認檔案來自本站後,前往「系統設定 → 隱私權與安全性」查看「仍要打開」;詳細步驟請參閱下載頁。
下載後執行安裝程式,再依系統提示完成設定。若 SmartScreen 阻止啟動,先確認檔案來自本站,再於提示中查看「更多資訊 → 仍要執行」。受組織政策管理的電腦應由管理員確認權限,請勿反覆修改系統防護設定。
使用系統瀏覽器開啟下載頁,依提示允許該瀏覽器「安裝未知的應用程式」,完成後即可撤銷此項權限。在微信內點選下載沒有反應時,請改用系統瀏覽器繼續。首次連線需要確認系統網路權限,允許後再檢查開關狀態與存取結果。
Debian / Ubuntu 系統選擇 deb,Fedora 系統選擇 rpm;其他發行版可先查看 AppImage 的執行條件。AppImage 需要新增執行權限,deb 與 rpm 則交由對應套件管理工具處理相依項目。下載頁列出指令與安裝注意事項,請先確認發行版再操作。
用戶端安裝完成不代表已具備可用的伺服器設定。後續步驟以使用者已有自己的訂閱或伺服器資訊為前提。
查看全部平台 →連線模式、設定與診斷
先釐清各項設定負責的層級,再修改參數。Global Routing 決定處理方式,Config 決定規則,伺服器項目決定連線目標;每次只修改一項,才能判斷變化來自何處。
Global Routing:先確定處理模式
在 Home 的 Global Routing 中,Config 模式依目前設定的規則處理連線;Proxy 模式用於檢查所選伺服器的代理路徑;Direct 模式用於觀察不經代理的存取結果。日常需要分流時,先啟用正確的 Config,再確認所選伺服器。遇到部分網站異常,可以暫時切換模式進行比較,但測試後應還原原設定。連線開關已開啟,並不能單獨證明規則命中與目標存取都正確。
Config / Proxy / Direct先查看目前模式,再判斷某次連線為何直連或代理。
On Demand:核對觸發條件與恢復狀態
On Demand 用於依指定條件觸發連線,並非提升線路速度的選項。在 Settings 中查看目前規則,先確認何時應連線、何時應中斷,再到相應的網路環境測試。排查開關關閉後又自動開啟的情況時,應先檢查這裡的觸發條件,而不是立即刪除設定。建議先完成一次手動連線驗證,再逐項新增自動條件;若結果不如預期,暫時停用 On Demand,維持相同伺服器與 Config 重新測試,縮小問題範圍。
Settings → On Demand先驗證手動連線,再驗證自動觸發。
Config:依序理解規則
Config 管理設定檔與規則。規則會依序檢查,前面已命中的項目會影響後續處理,因此新增規則時,除了核對內容,也要確認位置。DOMAIN-SUFFIX 比對指定網域及其子網域,IP-CIDR 依 IP 位址範圍比對,FINAL 則處理其餘連線。編輯前請儲存副本,並確認 PROXY 等策略在目前設定中有對應意義。更換裝置時,可透過 iCloud 同步與手動匯出保留設定;還原後仍應檢查已啟用的檔案及伺服器參照項目。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY語法範例,並非可直接取代現有設定的完整檔案。
Subscribe:匯入並維護既有設定
Subscribe 用於處理使用者既有的訂閱資訊。先向自己的服務商取得適用於 Shadowrocket 的連結,再依教學新增;匯入後核對項目數量與協定類型,避免將網頁網址誤認為訂閱內容。更新失敗時,分別檢查連結是否完整、目前網路能否連線,以及服務商回傳的格式。訂閱更新可能覆寫由訂閱管理的伺服器欄位,手動修改前應先留存副本。訂閱網址可能包含存取憑證,不應出現在公開截圖、記錄或求助文字中。
Subscribe → 更新既有訂閱
Add Server → 手動新增伺服器訂閱與 Config 是不同項目,更新其中一項不代表另一項也已更新。
協定:欄位必須與伺服器一致
Shadowrocket 支援 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定,新增時應以自己的伺服器提供的資料為準。在 Add Server 中先選擇 Type,再填寫 Host、Port 及該類型所需的身分資訊。使用 Scan QR Code 可減少手動輸入,但掃描完成後仍需檢查傳輸方式、TLS 與相關名稱欄位。不要只因連線逾時就更換協定類型;先確認伺服器實際使用的協定,才能繼續定位連接埠或參數問題。
Type → Host → Port
Scan QR Code不同協定需要不同欄位,範例欄位不能當作通用參數。
診斷:將現象拆分為可驗證的問題
Home 的 Connectivity Test 用於檢查連線狀況,Settings 中的 Diagnostics 可協助定位異常。先確認問題出在單一伺服器、單一網站或所有存取,再維持其他條件不變進行測試。Data 的流量統計可用來觀察是否有連線活動,但有流量不代表服務存取成功,測試數值也不等於實際下載速度。回報問題時記錄模式、網路環境與錯誤文字,並隱藏伺服器憑證;逾時、DNS 異常與規則誤命中應依不同流程排查。
Connectivity Test
Settings → Diagnostics
Data記錄可重現的現象,比反覆重新安裝更有助於定位原因。
設定名稱保留應用程式中的英文原文。教學中的介面位置以 iPhone / iPad 為操作範例,其他平台請對照實際介面確認,不要將某個平台的選單位置直接套用至所有裝置。
查看設定說明 →從既有設定到連線驗證
以下以 iPhone / iPad 為例。請先準備自己的既有訂閱或伺服器資訊;若尚未取得這些資料,應先完成準備,而非反覆嘗試連線開關。
Add Server:新增設定
依資料選擇手動填寫、Scan QR Code 或匯入既有訂閱。手動新增時,Type 必須與伺服器協定一致,再逐項輸入 Host、Port 與必要的身分資訊。貼上內容後檢查是否多出空格或換行;掃描 QR Code 只負責輸入資料,不代表伺服器已可使用。
儲存後回到 Home,確認 SERVER 分組中出現預期項目,並選取預計使用的伺服器。訂閱連結與完整設定檔用途不同,匯入結果也不同;若顯示的內容不如預期,請先核對資料類型。
Global Routing:選擇模式
需要依規則分流時,使用 Config,並檢查目前啟用的設定檔。暫時驗證伺服器路徑時,可使用 Proxy 進行比較;Direct 用於觀察直連結果。請勿混合不同模式下的存取結果進行判斷。
首次設定建議保持簡單:確認一台伺服器、一份設定與一種網路環境。先建立可重複的測試基準,再調整規則或 On Demand;一次修改多項設定會讓故障來源難以區分。
連線開關:驗證存取
開啟 Home 頂端的開關,依系統提示允許新增 VPN 設定。出現連線狀態後,再執行 Connectivity Test,並開啟需要存取的頁面進行驗證。系統狀態表示網路設定已啟用,服務頁面是否正常仍需另外確認。
失敗時先記下錯誤文字,區分開關無法啟用、伺服器測試逾時與個別網站無法開啟。檢查系統時間、目前網路與協定參數,不要急著刪除所有設定;保留記錄有助於後續診斷持續追查。
正版核對與取得資訊
本站是 Shadowrocket 官網與官方手冊。Shadowrocket 是閉源商業應用程式;核對應用程式身分應依據商店可見資訊與本站下載入口,不要根據名稱相近、圖示相似或搜尋排序判斷。
在 App Store 核對三項資訊
開啟產品頁後,確認名稱為 Shadowrocket、開發者為 Shadow Launch Technology Limited,並核對產品連結中的應用程式 ID 932747118。再對照本頁顯示的官方圖示。三項資訊應一併確認,僅看名稱或單張圖片不足以確認項目身分。購買前也應閱讀商店目前顯示的相容性與價格,系統需求以 App Store 頁面標示為準。
商店顯示狀況與帳號地區
App Store 的搜尋與購買結果會受帳號所屬商店地區影響,中國大陸商店目前沒有此應用程式。搜尋不到時,請先確認目前登入的購買帳號及其地區,再查看產品頁提示,不要將搜尋結果為空理解為裝置本身無法使用。需要調整地區時,請依 Apple 帳號設定中的官方流程,確認餘額、訂閱與付款條件;帳號地區與裝置語言是不同的設定。
一次購買與更換裝置還原
iPhone / iPad 版在 App Store 美區 $2.99 一次性付費,實際金額以目前商店顯示為準;Mac、Windows、Android、Linux 版免費。iPhone 與 iPad 可共用同一購買帳號的購買記錄。更換裝置或重新安裝時,先到已購項目尋找 Shadowrocket;若看到購買按鈕,應先核對帳號與歷史購買記錄,不必急著再次付款。
還原應用程式與還原設定是兩件事。重新下載應用程式後,還要確認伺服器、訂閱與 Config 是否已還原。更換裝置前可儲存設定副本,並檢查 iCloud 同步狀態;不要等舊裝置清除後才確認是否有可用備份。
其他平台的取得與更新
Mac 提供 Apple 晶片與 Intel 兩種安裝檔,Windows、Android 與 Linux 則依系統格式選擇,統一從本站下載頁進入。iPhone / iPad 的應用程式更新由 App Store 管理;其他平台可返回本站下載頁取得目前安裝檔。更新前請儲存現有設定,更新後確認已啟用的設定、連線權限與規則是否仍符合預期,不要將安裝完成視為設定遷移已結束。
常見問題可依類別查閱:電腦與 Android 的平台選擇、Mac 晶片版本判斷、商店搜尋與購買還原,以及匯入訂閱後的連線檢查。
查看疑難排解 →安裝與故障排查文章
依目前的需求閱讀,不必從頭看完所有設定。安裝階段先處理系統權限與檔案格式;若已能啟動但無法存取,再檢查伺服器參數與網路環境,避免混淆安裝問題與連線問題。
Shadowrocket 節點逾時怎麼辦:延遲測試、協定參數與系統時間排查順序
節點顯示逾時或連線失敗時,先進行延遲測試判斷範圍,再逐項核對連接埠、密碼、傳輸方式等協定參數,最後檢查系統時間是否設為自動。
閱讀排查順序 →小火箭 Android 版安裝教學:下載 apk 並允許安裝未知的應用程式
從本站下載 Shadowrocket Android 版 apk,在系統設定中允許瀏覽器安裝未知的應用程式;在微信內點選下載沒有反應時,改用系統瀏覽器開啟頁面。
閱讀 Android 安裝步驟 →Shadowrocket Linux 版安裝:如何選擇 deb、rpm、AppImage
依發行版選擇安裝檔:Debian / Ubuntu 使用 deb 搭配 apt,Fedora 系統使用 rpm 搭配 dnf,其他發行版則使用 AppImage 並新增執行權限。
閱讀 Linux 安裝說明 →