OFFICIAL MANUAL · QUICK START

Shadowrocket 入門指南

匯入訂閱 → Global Routing → 連線 → 驗證 → 排查。依序完成設定,先確認單一伺服器可用,再檢查規則分流。

以下步驟適用於 iPhone 和 iPad。兩種裝置的可用顯示空間不同,但基本流程相同:先將連線資料儲存為伺服器項目,再決定請求的處理方式,最後建立連線。介面配置可能因 App 顯示方式而有所不同,操作時請依 Home、Add Server、Config 等英文介面名稱尋找,不必依賴按鈕固定在螢幕的某個角落。

首次設定不必一次調整所有選項。先保留不熟悉的設定並記下目前狀態,只完成本頁必要步驟。如果資料缺少某協定所需欄位,請先確認資料,不要拿其他欄位的內容代填。訂閱網址、密碼與金鑰都屬於敏感資訊,請勿將完整內容貼到公開討論區或截圖中。

01 · 新增伺服器或匯入訂閱

開啟 Shadowrocket,進入 Home(主畫面),找到新增入口並開啟 Add Server(新增伺服器)。先確認手邊資料的類型:訂閱連結可用來批次取得伺服器項目;單一伺服器資料則包含協定、位址、連接埠與驗證參數。選擇符合手邊資料的其中一種方式即可,不必為了完成教學重複匯入。

已有訂閱連結:使用 Subscribe

在 Add Server 的類型選單中找到 Subscribe(訂閱),進入後將向服務商取得的完整連結填入 URL 欄位。複製時請確認沒有包含說明文字、引號、換行或前後空格。尤其不要刪除問號後的參數;這些參數可能用於識別訂閱,網址能開啟不代表刪減後仍能取得相同內容。

填寫容易辨識的備註,再儲存訂閱。返回 Home 後,確認是否已取得伺服器清單;若尚未出現項目,請使用該訂閱的更新功能,並留意更新結果。儲存訂閱網址和成功取得訂閱內容是兩回事;只有出現可選取的伺服器項目,才算完成本步驟的主要檢查。

訂閱更新會依來源內容調整清單,項目名稱也可能變更。首次匯入時,請先確認群組與來源,不要只因名稱相似就刪除舊項目。需要替換舊訂閱時,請先確認新訂閱能順利更新且其中的伺服器可用,再整理舊內容,保留發生問題時可供核對的原始狀態。

已有單一伺服器資料:核對協定與欄位

如果拿到的是逐項參數,請先在 Add Server 選擇對應協定,再填寫位址、連接埠與驗證資料。Shadowsocks、Trojan、WireGuard 等協定所需欄位各不相同,不能因為都有位址和連接埠就互相套用。位址欄位通常填入主機名稱或 IP 位址,不要自行改成網頁網址;連接埠請依資料填寫,不要猜測常見數值。

資料中若明確列出 TLS、Server Name 或其他傳輸選項,請依原值填寫。網域位址與 TLS 驗證所用名稱可能各有不同用途,不可任意互換。資料未提供必要欄位時,請向原資料提供者確認;不要為了成功儲存而關閉憑證驗證,也不要以看似可用的公開位址取代。

儲存後返回 Home,在 SERVER(伺服器清單)區域找到剛新增的項目,點選本次要使用的伺服器。進入編輯頁再次確認,特別檢查協定類型、連接埠與驗證欄位。此時看到項目只代表資料已儲存,無法證明伺服器可連線。選取完成後,接著設定 Global Routing。

02 · 選擇 Global Routing 模式

在 Home 開啟 Global Routing(全域路由),確認目前採用的請求處理方式。本教學將三種模式稱為配置(Config)/代理(Proxy)/直連(Direct)。此設定決定請求的處理原則,不是選擇伺服器協定,也不會替你補齊連線資料。切換前先記下目前設定,方便驗證後還原。

配置(Config):依目前配置中的規則處理

日常需要分流時,請選擇配置(Config)。接著進入 Config(配置檔頁面),確認目前啟用的是預期的配置檔。清單中儲存了某個配置檔,不代表它已啟用;正在編輯的檔案也可能不是目前生效的檔案。如不確定,請先查看目前啟用標示,再開啟相應內容確認。

Config 會依據目前配置中的規則決定策略。請求可能依規則使用 PROXY(代理策略)、DIRECT(直連策略)或 REJECT(拒絕策略),因此開啟連線不代表每個請求都會經過代理。規則通常依序比對,先符合的項目會影響結果。完整結構、規則語法與最終策略的說明,請參閱配置欄位參考;首次連線時不必在這裡重寫整份檔案。

代理(Proxy):先檢查代理連線路徑

若要確認所選伺服器本身能否用於存取,可暫時選擇代理(Proxy),讓需要透過此模式處理的請求經由所選代理伺服器傳送。這樣能減少規則分流對判斷的干擾。此模式適合用於目的明確的單次對照測試,不代表所有 App、所有目標在任何網路環境下都一定能存取。

測試前請確認 Home 選取的仍是剛才核對過的伺服器。測試結束後,如果日常使用需要依規則分流,請還原為配置(Config),並重新驗證目標請求。否則後續的存取結果可能來自 Proxy 模式,而非正在檢查的配置規則。

直連(Direct):確認本機網路存取

直連(Direct)會讓請求直接存取目標,不經由所選代理伺服器。這有助於判斷本機網路能否存取某項服務,但不能證明代理伺服器可用。匯入資料後若一直使用 Direct,即使網頁正常開啟,也不能據此認定訂閱已生效。

完成本步驟時,應能說明目前的模式及選擇原因:日常依規則使用時選 Config;要排除規則影響、檢查代理路徑時可暫選 Proxy;檢查本機直接存取則使用 Direct。確認後返回 Home,準備建立連線。

03 · 開啟開關並完成系統授權

返回 Home,先檢查所選伺服器與 Global Routing,再開啟連線開關。首次建立連線時,系統可能會提示新增 VPN 配置。這代表允許 Shadowrocket 在裝置上建立用於處理網路流量的系統連線配置,並非購買流程,也不是取得伺服器資料的步驟。

閱讀彈出視窗中的 App 名稱與提示內容,確認是由剛才的操作觸發,再選擇允許,並依系統要求完成裝置認證。若取消授權,用戶端無法只靠儲存伺服器項目完成連線。再次操作時,請返回 Shadowrocket 重新觸發連線,依目前系統提示處理,不要反覆點擊開關嘗試略過確認。

完成授權後,等待狀態穩定並觀察 Home 的連線狀態。系統的 VPN 標示只能說明相關連線狀態,不能單獨證明目標服務可存取,更不代表所有請求都經過代理。如果開關剛開啟就又關閉,請先記下 App 顯示的提示,再進行下一步排查;不要連續修改協定、路由與配置檔。

如果裝置上還有其他正在使用系統 VPN 連線的設定,請先結束目前不需要的連線,再進行本次驗證。在受組織管理的裝置上,網路政策或配置管理可能會限制相關操作,請依裝置管理要求處理,不要刪除用途不明的系統配置。

首次驗證建議維持相同的網路環境,例如全程使用目前的 Wi-Fi,不要一邊切換網路一邊判斷伺服器是否可用。網路變更會影響連線條件,容易將本機網路問題誤認為資料填寫錯誤。確認連線成功後,再單獨測試其他網路環境。

完成本步驟的判斷標準是:授權流程已結束、連線狀態維持穩定,且目前的伺服器與路由模式仍符合預期。接著透過測試與實際存取一併確認結果。

04 · 透過測試與實際存取驗證是否生效

在 Home 找到 Connectivity Test(連線測試),測試目前的伺服器。請將結果視為特定測試目標、測試方式與目前網路條件下的可達性參考。測試有數值不代表每個目標服務都能正常使用;沒有測出結果也不代表所有協定參數都有錯,請搭配實際存取繼續判斷。

接著開啟瀏覽器,前往一個平常會使用、且目前能明確判斷成功與否的目標頁面。確認是否載入新的頁面內容,而不是只看到先前快取的內容。若頁面本身受到登入、地區、帳戶或伺服器端限制,這些因素可能各自影響結果,不應一概歸因於 Shadowrocket。

實際存取成功後,返回 App 確認連線是否仍維持,並參考可用的請求記錄,核對該目標的處理路徑。使用配置(Config)時,請特別查看目標符合哪條規則,以及最後採用哪種策略。若符合 DIRECT,網頁能開啟只代表直連路徑可用,不能證明該請求經過所選代理伺服器。

若要驗證某條規則,請維持相同目標與伺服器,再檢查配置。先確認查看的是目前啟用的檔案,再檢查比對順序。有些目標會同時請求多個網域;首頁能開啟但資源載入不完整時,應確認是哪個請求失敗,而非只看網址列中的主要網域就判斷所有規則。

Data(流量統計)中的上傳與下載變化可供參考,但不能直接證明某個目標一定採用了特定路徑。統計數據可能包含其他 App 的背景請求,也可能與服務商的計量範圍不同。首次驗證時,優先確認實際存取結果及對應策略,不必要求兩處數值完全一致。

建議簡單記下四項結果:使用的網路、選取的伺服器、Global Routing 模式,以及目標服務的存取情況。請勿記錄完整密碼或訂閱連結。之後更換網路、更新訂閱或修改規則時,就能在相同條件下重新測試,而非憑印象比較。

完成本步驟時,請將暫時切換的 Proxy 或 Direct 還原為預期的日常模式,再次存取相同目標。若還原 Config 後結果改變,請優先檢查規則;若兩種模式都無法存取,則依下方順序檢查網路與伺服器資料。

05 · 逐步排查常見問題

排查時每次只變更一項條件,並重複相同測試。若先修改訂閱、再切換網路、接著更換規則,即使最後恢復存取,也難以判斷是哪個步驟發揮作用。依照以下順序檢查,可分別處理「匯入失敗」、「未建立連線」與「規則未符合」等問題。

訂閱已儲存,但清單中沒有伺服器

先確認裝置的本機網路可用,再檢查訂閱網址是否完整。更新失敗時,請閱讀相關提示,分辨網址無法連線、驗證失效或內容無法識別等情況。即使連結能在瀏覽器中開啟,也只能表示瀏覽器取得了某種回應,不能證明回應內容一定可匯入為訂閱。不要將登入頁或提示頁的網址當成訂閱網址。

若連結先前可用、現在卻無法更新,請向服務商確認連結狀態及內容格式。訂閱更新失敗不一定會立即移除原有伺服器,因此也要區分「舊項目仍存在」與「本次更新成功」。尚未確認來源狀態前,請勿清空原有清單。

伺服器已存在,但連線或存取失敗

重新進入該項目的編輯頁,逐一核對協定、位址、連接埠、密碼及其他驗證參數。複製內容時容易夾帶空格,也可能將備註誤填為位址。使用 TLS 的連線,請檢查資料中的名稱設定及裝置日期時間是否正確;不要藉由放寬驗證要求來掩蓋資料錯誤。

接著確認 Home 實際選取的是該項目,而不是名稱相同的舊伺服器。暫時切換至 Proxy,測試相同目標;若仍失敗,再分別檢查本機網路與伺服器狀態。不要只因一次測試逾時就批次刪除所有伺服器;單一測試目標無法連線,不一定代表整體連線都不可用。

連線狀態穩定,但部分目標無法使用

先確認目前的 Global Routing。若 Proxy 可以存取、Config 卻不行,請檢查目前啟用的檔案及目標符合的規則,特別留意前面較寬泛的規則是否已先符合,以及是否符合 REJECT。不要先加入大量重複規則;先找出實際決定策略的規則,再做最小幅度的修改。

如果只有網域存取失敗、其他存取正常,再檢查 DNS(網域名稱解析)相關因素。網域尚未正確解析時,修改伺服器備註或重新排列清單通常無法解決問題。請記下失敗的網域與當時的模式;進一步了解 DNS 與規則,請參閱問答頁及配置欄位參考。首次排查時不要同時更換所有解析設定。

開關無法維持開啟,或關閉後又自動連線

開關無法維持開啟時,先確認系統授權是否完成、App 是否顯示錯誤提示,以及裝置是否受到連線管理限制。若關閉後又重新連線,請檢查 On Demand 是否因符合條件而再次觸發。這兩種現象的原因不同,不應一概歸因於訂閱失效。需要查看系統配置時,只處理能明確確認是本次設定的項目。

準備尋求協助時,請以文字說明「在哪個步驟失敗、使用什麼協定、目前的模式,以及測試與實際存取結果」。分享截圖或記錄前,請遮蔽訂閱網址、密碼、金鑰與帳戶識別資訊。可保留錯誤類型及必要欄位名稱,提供排查線索,同時避免洩露連線憑證。

排查結束後,還原暫時變更的路由模式與測試設定,確認目前的 Config 和伺服器選擇,再進行一次實際存取。至此應保留一套可重現的操作流程:資料匯入成功、選取正確伺服器、完成連線授權,且實際策略符合預期。之後只在有需要時,逐項加入 On Demand 或更細緻的規則。