官方手冊 · 上手操作
Shadowrocket
訂閱匯入與連線教學
依新增、模式、連線、驗證、排錯的順序操作。先完成一次可重複的連線,再調整規則與自動連線設定。
開始前:準備既有連線資料
先判斷手上的資料屬於哪一種:用於更新伺服器清單的訂閱連結,或單一伺服器的分享連結、QR Code 或參數表。兩者入口相近,但用途不同;不要將訂閱網址填入 Host,也不要只因連結以 HTTPS 開頭,就判定它一定是訂閱。若無法確認,請先核對資料說明再繼續新增。
STEP 01 / ADD
Add Server:新增伺服器或匯入訂閱
本步驟只需輸入資料。返回 Home 後能看到伺服器記錄,再繼續選擇連線模式。
已有單一伺服器參數
開啟 Shadowrocket 的 Home,找到 Add Server 並進入。先點選 Type,依照既有資料選擇協定,再填寫 Host、Port 及該協定要求的驗證欄位。截圖中的 Password、Method 是特定 Type 下顯示的項目;選擇其他 Type 後欄位可能不同,應以目前頁面及原始資料為準,不要把截圖中的欄位視為所有協定的固定要求。
Host 填寫伺服器網域或 IP,不要加上網頁路徑;Port 填寫資料提供的連接埠。複製時檢查前後空格與換行,尤其是 Password 等驗證內容。若資料還列出 TLS、SNI 或傳輸設定,應在同一筆記錄中逐項核對,不要只憑協定名稱自行推測這些值。填寫後儲存,返回 Home 的 SERVER 分組查看新增記錄。
已有訂閱連結
再次進入 Add Server,在 Type 中選擇 Subscribe,將完整訂閱連結貼到對應的網址輸入欄位,並填寫方便辨識的備註後儲存。這裡需要的是用於取得清單的完整網址,而不是某個伺服器的 Host。訂閱網址可能包含身分資訊,不要放入公開截圖、聊天記錄或診斷範例中。
儲存後等待訂閱完成首次取得,再返回 Home 查看清單。若已出現該訂閱分組,但分組內沒有伺服器,先檢查更新結果與網址是否完整,不要立刻再建立一份相同訂閱。重複新增會讓後續選取與更新更難核對;修正原有記錄後重新更新,更容易判斷問題是否解決。
已有 QR Code 或分享連結
可使用 Scan QR Code 讀取 QR Code,並依系統提示授權相機。匯入後仍要開啟記錄,檢查 Type、Host、Port 與驗證欄位。Import from Cloud JSON 對應特定格式的遠端 JSON 資料,不是任意網頁或任意訂閱的通用入口。分享連結與訂閱的結構差異,請參閱分享連結與訂閱連結說明。
最後,在 Home 點選實際要使用的伺服器,確認選取標記位於預期記錄上。清單中有記錄只代表資料已儲存,不代表遠端伺服器已可使用;下一步先將 Global Routing 設定為容易理解的狀態,再進行連線測試。
STEP 02 / ROUTE
Global Routing:選擇三種模式
伺服器決定連線到哪裡,Global Routing 決定請求如何選擇路徑。兩項設定需要分別核對。
返回 Home,開啟 Global Routing。三種模式分別是配置 (Config)/代理 (Proxy)/直連 (Direct)。第一次操作不要頻繁切換模式;先確認目前要驗證的是伺服器本身,還是設定檔中的規則,再選擇相應模式。模式變更後,應重新開啟目標頁面並送出請求,不要只根據先前已載入的頁面判斷結果。
配置 (Config):依目前檔案分流
日常依規則使用時選擇配置 (Config)。接著進入 Config,確認目前實際使用的設定檔,而不只是查看清單中某個檔案的名稱。設定編輯頁包含 General、Rule、Hosts 等區段;本教學只關注 Rule 中的比對條件與策略,首次連線不需要修改所有區段。
規則會依序檢查,具體規則通常應放在涵蓋範圍較廣的規則之前。以下是說明策略意義的語法片段,並非可直接取代現有檔案的完整設定;其中 PROXY 也需要對應實際設定中的策略。請先閱讀現有檔案,確認理解後再編輯,並在修改前保留原始檔案。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-SUFFIX,ad.example.com,REJECT
FINAL,PROXY
PROXY 表示使用對應的代理策略;DIRECT 表示使用直連路徑;REJECT 表示拒絕該請求。FINAL 是前面都未比對成功時使用的最終策略。介面中的模式名稱 Proxy 與規則策略 PROXY 不是同一個操作入口,不要把選擇模式當成已修改 Rule。
代理 (Proxy) 與直連 (Direct):用於對照
代理 (Proxy) 可用於檢查所選伺服器的代理路徑,減少一般規則分流對本次排查的影響,但不應理解為裝置所有系統流量都必定經過相同路徑。直連 (Direct) 則用於對照本機網路;即使開啟連線開關,也不會自動改用所選伺服器。
若 Proxy 下目標頁面可用,但 Config 下失敗,後續應檢查目前設定與命中規則;若 Direct 下本機網路也無法正常存取,請先恢復 Wi-Fi 或行動網路。暫時不理解某條規則時,保留原值即可;完整的設定維護方法請參閱新手到進階官方手冊。
STEP 03 / CONNECT
Home:開啟連線開關
先確認選取的記錄與模式,再授權連線。系統授權與伺服器是否可用是兩回事。
返回 Home,檢查 SERVER 分組中的選取記錄是否正確,再確認 Global Routing 是否維持上一步選擇的模式。若剛更新過訂閱,原有記錄可能已變更,不要只憑先前的選取繼續測試。確認後,開啟頂端 Not Connected 旁的連線開關。
首次連線時,系統會詢問是否允許新增 VPN 設定。確認提示來自本次 Shadowrocket 操作後再允許,並依裝置提示完成密碼或生物辨識驗證。這個步驟是在裝置上建立網路接管權限,不會替你建立伺服器資料,也不代表遠端驗證已通過。若取消授權,請返回 Home 再次開啟開關,並依系統提示處理。
完成授權後返回 Home,觀察頂端狀態是否由 Not Connected 變為已連線狀態。如果開關立即關閉,先檢查系統授權是否完成,再確認目前伺服器記錄是否完整。此時不要連續快速切換開關,也不要同時重建訂閱、修改 DNS 和更換模式;維持單一穩定狀態,才能對應到具體的問題環節。
狀態穩定後,使用 Home 中的 Connectivity Test。它用於檢查應用程式依目前測試設定進行的連線狀況,並非對每個網頁、每種協定和每條分流路徑的統一保證。取得測試結果後,仍需進行下一步的實際存取驗證;只看頂端連線狀態,無法確定目標請求已依預期經過代理。
STEP 04 / VERIFY
驗證是否生效:實際存取與 Data 對照
以新送出的請求為準,同時核對目標頁面與規則結果,不要以單一測試值作為全部結論。
先選擇平時能正常存取的頁面檢查基本網路,再開啟本次需要驗證的目標頁面。必要時重新載入或開啟新頁面,避免瀏覽器快取讓舊內容看起來像是成功送出新請求。如果基本網路可用但目標頁面失敗,記錄當時的伺服器、Global Routing 與現象,再進入 Data 查看本次新產生的請求。
在 Data 中依請求時間與目標網域尋找記錄;如果目前詳情頁顯示命中規則、策略或連線資訊,就將這些內容與預期路徑對照。Config 下某個請求走 DIRECT,可能正是規則設定的結果,不代表連線開關失效;同樣地,出現 REJECT 時應先檢查命中的規則,而不是立即更換伺服器。
若目標請求應走 PROXY,請確認比對到的策略是否正確,以及該策略實際使用的伺服器是否符合預期。若走 DIRECT,則對照目標是否原本就應由本機網路處理。網頁通常包含多個網域,主頁無法開啟可能是其中某個資源請求所致;檢查時應查看相關記錄,而不只搜尋網址列中的網域。
- 維持伺服器不變,只對照 Proxy 與 Config 兩種模式,重新送出同類型的存取請求。
- 維持模式不變,如果自己另有可用記錄,再切換伺服器進行對照。
- 每次記錄目標、模式、結果與命中策略,避免混淆不同時間的結果。
如果 Proxy 可存取而 Config 無法存取,優先返回 Config 檢查規則與最終策略。如果兩者都失敗,但 Direct 下基本存取正常,優先核對伺服器參數與遠端狀態。確認規則正確命中後,再恢復適合日常使用的 Config,並以相同方式驗證另一個需要不同路徑的目標。
本步驟的完成標準不是固定的延遲數字,而是:連線狀態穩定、實際目標可存取,且可查詢的請求路徑符合你的設定預期。若要進一步了解 Home、Config、Data 的職責,請參閱介面英文詞彙對照。
STEP 05 / CHECK
Settings:依問題環節逐項檢查
保留原有設定,每次只修改一項。先檢查基本連線,再檢查參數、模式與規則。
匯入失敗或清單空白
先確認訂閱連結沒有缺漏字元,也沒有把單一伺服器分享連結填入 Subscribe。檢查目前網路能否完成訂閱取得,並查看應用程式提供的更新結果。伺服器清單空白不代表客戶端尚未購買,也無法透過反覆新增相同記錄解決。若涉及訂閱有效性或伺服器資料變更,應向自己取得資料的來源確認。
開關已開啟,但無法存取
先確認不經代理時基本網路是否正常;遇到需要網頁認證的 Wi-Fi,應先完成網路本身的認證。再檢查所選伺服器的 Host、Port、驗證欄位與傳輸設定,特別注意複製時產生的空格。若問題只發生在某筆伺服器記錄,先修正該記錄,不要立即修改全部設定。
接著依照第二步對照 Global Routing。Config 失敗但 Proxy 可用時,檢查目前啟用的檔案、規則順序與 FINAL;兩種模式都失敗時,再核對遠端連線與驗證。若狀況是網域無法解析,查看目前 DNS 設定與相關診斷資訊,不要一次貼上多組陌生 DNS 設定,以免掩蓋原本的問題。
測試失敗,但網頁可以開啟
進入 Settings 確認 Test Method。測試方式與實際網頁存取路徑可能不同,因此 Connectivity Test 失敗,不能單獨證明所有存取都失敗。反過來,測試通過也不保證某個目標一定可用。請一併判斷測試結果、實際頁面結果和 Data 中的記錄;必要時維持測試方式不變,只對照一次伺服器或模式。
關閉後又重新連線,或只有部分請求異常
在 Settings 檢查 On Demand 是否啟用了符合目前網路的自動連線條件。為了完成手動對照,可以先記下原設定,再暫時停用相關條件;驗證完成後,依實際需要恢復。只有部分請求異常時,優先查看相關規則與傳輸需求,不要先修改 Settings 中所有 Proxy、TCP、UDP 項目。
需要更多線索時,使用 Diagnostics,依應用程式提供的結果繼續查找原因。分享截圖或記錄前,請移除完整訂閱網址、Password、驗證內容與個人瀏覽記錄,只保留必要的錯誤現象。其他情況請參閱疑難排解;開關已開啟但無法存取的詳細檢查順序,請見連線後無法上網檢查清單。
完成後:保留可用狀態
確認選取的伺服器、目前設定與規則結果一致後,再進行日常維護。
保留一份已驗證可用的設定,訂閱更新後留意原有伺服器是否仍在清單中。日後遇到異常,先以相同目標與模式重現,再決定要檢查資料、切換網路或調整規則。不要把自動更新訂閱與替換整份設定視為相同操作;後者可能同時變更 DNS、Rule 與其他設定,需要重新驗證。
本教學到此完成首次上手。若要了解權限、Data、Settings 與長期維護之間的完整關係,請繼續閱讀新手到進階,首次連線時不必一次設定所有功能。