官方手冊 / iPhone · iPad

Shadowrocket
匯入與連線教學

從既有資訊開始,依序完成 Add Server / Subscribe、Global Routing、連線授權與實際連線驗證。先完成一次可重複的連線,再調整規則。

  • 01 匯入資訊
  • 02 選擇路由
  • 03 連線
  • 04 驗證
  • 05 排查

01 · Add Server / Subscribe

開啟 Shadowrocket,進入 Home。此頁可查看既有伺服器、選取目前使用的伺服器並控制連線。先確認手邊的資料類型:用來更新伺服器列表的訂閱連結,應透過 Subscribe 匯入;包含位址、連接埠及驗證資訊的單台伺服器參數,則應依對應協定填寫。兩種方式擇一即可,不必重複新增相同資料。

已有訂閱連結:使用 Subscribe

從自己的服務供應商處複製完整訂閱連結,返回 Home,點選加號進入 Add Server。在 Type 中選擇 Subscribe,將連結貼到 URL,並填寫方便辨識的備註。儲存前確認連結首尾完整,尤其不要連同聊天訊息中的說明文字、換行或空格一起複製。訂閱連結可能包含帳戶憑證,請只存放在自己信任的裝置上,勿公開分享。

儲存後返回 Home,等待訂閱完成更新;如果列表尚未展開或沒有顯示伺服器,請使用該訂閱項目提供的更新功能,再查看結果。更新成功後,對應的訂閱群組中應會出現伺服器項目,而不只是訂閱網址。訂閱更新只會同步列表,不代表已建立連線,也無法據此判斷列表中的每台伺服器都可使用。先選取其中一台,稍後再執行 Connectivity Test。

如果儲存成功但沒有出現項目,請勿立刻重複新增訂閱。先確認複製的是供 App 讀取的訂閱網址,而非帳戶管理頁面的網址,再檢查目前網路能否連線取得內容。連結失效、存取驗證方式變更或訂閱內容格式不符,都可能導致更新失敗。保留原項目,依本文末的順序檢查,再向自己的服務供應商確認網址狀態。

已有單台伺服器資訊:依協定填寫

同樣在 Home 點選加號進入 Add Server,先依資料選擇 Type,例如 Shadowsocks、VMess 或 Trojan,再填寫 Address、Port 及該協定要求的驗證欄位。不同協定所需欄位各異:密碼不能取代 UUID,傳輸參數也不能只憑伺服器名稱推測。若資料包含 TLS、傳輸方式或伺服器名稱要求,請逐項核對原始資訊;不確定的欄位不要任意留白或替換。

儲存後返回 Home,找到新增的項目並點選。伺服器名稱只是備註,真正影響連線的是協定、位址、連接埠與驗證參數。項目顯示出來,僅代表本機資訊已成功儲存。接著先選擇 Global Routing,再開始連線;此時不必預先新增大量規則,也不要同時修改多個 Settings 項目。

02 · Global Routing 三種模式

選取伺服器後,在 Home 開啟 Global Routing。這裡決定請求採用哪種整體處理方式,與「目前選取哪台伺服器」屬於不同設定層級。即使選對伺服器,路由模式不符合預期,仍可能出現連線已建立、目標存取卻未經由該伺服器的情況。先了解三種選項,再依目前的驗證目的選擇合適的模式。

模式 主要作用 目前應檢查的項目
配置(Config) 依目前設定檔中的規則選擇策略。 設定檔是否已啟用,以及目標命中哪條規則。
代理(Proxy) 讓可代理的連線經由所選伺服器,方便初次測試。 所選伺服器是否可用,以及實際請求能否完成。
直連(Direct) 直接連線,不透過所選伺服器作為代理出口。 是否刻意選擇直連,以及目前網路能否直接連線至目標。

首次使用且尚未準備設定檔時,可以先選擇代理(Proxy),再進行下一步的連線與存取驗證。這樣做是為了分開確認「伺服器本身是否能連線」與「規則是否設定正確」,並非要求長期固定使用同一種模式。Proxy 也不保證每個 App 或所有系統流量都會經過代理,最終仍須依實際請求驗證。

如果已有自己的設定檔,請進入 Config,確認預期使用的檔案已設為目前設定,再返回 Home 選擇配置(Config)。將檔案匯入 Config 列表,不代表已啟用;選取 Config 模式,也無法證明檔案中的每條規則都符合目前需求。匯入訂閱通常是更新伺服器列表,不應與匯入完整規則設定檔混為一談。

直連(Direct)適合用來確認目前網路能否直接連線至同一目標。它不是「連線失敗後自動修復」的選項,也無法取代伺服器驗證。若要進一步了解 PROXY、DIRECT、REJECT 與比對順序,完成本教學後可閱讀規則與設定參考大全;初次連線時,先盡量減少變數。

03 · Home 開關與 VPN 授權

返回 Home,再次確認目前選取的伺服器與 Global Routing。準備就緒後,開啟連線開關。首次連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定。請先確認提示中的 App 名稱,並確認這是剛才主動發起的操作,再選擇允許,依裝置要求完成密碼或生物辨識驗證。此提示是用來建立系統網路延伸功能所需的設定,不是匯入訂閱的視窗。

完成系統驗證後返回 Shadowrocket,查看開關與連線狀態;若開關仍是關閉狀態,請再手動開啟一次。取得系統權限與成功連線至遠端伺服器是兩回事:前者讓 App 建立本機連線通道,後者還取決於伺服器位址、驗證參數及網路條件。看到系統 VPN 狀態,只能確認本機通道狀態,不能單獨證明遠端請求已成功。

如果剛才取消提示,重新開啟連線開關通常會再次觸發授權流程。若裝置上已有其他 VPN 連線,請先中斷暫時不需要使用的連線,再測試 Shadowrocket,以免將連線切換誤判為伺服器故障。由組織管理的裝置可能會限制 VPN 設定;若遇到明確的管理限制,請先確認裝置管理要求,不要反覆刪除系統設定。

首次驗證期間,先關閉 On Demand,使用手動開關較容易判斷每個步驟的結果。On Demand 會依條件觸發連線,但不會補上錯誤密碼、修正訂閱網址或取代規則選擇。手動連線穩定後,再依實際需求設定。現在保持連線,進行下一步,使用同一個目標確認連線是否確實生效。

04 · Connectivity Test 與連線驗證

先返回 Home,對選取的伺服器執行 Connectivity Test。測試結果會受所選測試方式影響:顯示回應時間,代表該次測試當下收到回應;顯示逾時,則代表測試未能在限定時間內完成。這項測試並非所有網站連線品質的總評,測得的數值也不能直接當作日常網頁載入速度。不要只憑一次測試結果反覆切換伺服器。

綜合測試結果與實際請求

保持同一台伺服器與相同的 Global Routing 設定,開啟瀏覽器並前往自己熟悉且目前可正常使用的網頁。觀察網頁是否完整載入,再開啟頁面中的另一個連結,確認看到的不是先前快取內容。如果只有特定 App 異常,先用瀏覽器測試類似目標作為對照,避免將單一 App 的登入、快取或服務狀態問題誤判為整體連線失敗。

返回 Shadowrocket,可參考 Data 中的流量資訊及介面提供的連線記錄。連線期間流量有所變化,表示有網路活動,但僅憑流量增加,無法判斷特定目標命中了哪條規則。若可使用記錄功能,請找出時間與目標網域相符的請求,再查看實際採用的策略。記錄可能包含瀏覽目標等隱私資訊,分享排查資料前請先處理敏感內容。

使用配置(Config)時,還要驗證規則結果

使用配置(Config)時,分別存取一個預期使用 PROXY 的目標,以及一個預期使用 DIRECT 的目標,並在可用的請求記錄中核對結果。設定檔中的規則通常依序比對,前方較寬泛的規則可能使後方的特定規則無法生效。網頁能開啟不代表流量已依預期分流,還要確認目標請求所採用的策略。

需要比較時,先停止目前的測試請求,再切換 Global Routing 並重新發出請求;既有連線可能繼續沿用建立時的處理方式。比較時使用相同網頁與相同網路環境,每次只變更一項條件。完成「測試有回應、網頁可正常存取、策略符合預期」的驗證後,再逐步啟用自己的設定檔或 On Demand。如此一來,設定變更後若出現異常,會更容易找出原因。

05 · 常見問題與排查順序

發生問題時,先記錄停在哪個步驟。不要把訂閱更新失敗、VPN 未建立、Connectivity Test 逾時,以及單一網頁無法開啟都當成同一個問題。記下可重現的目標、目前網路類型、伺服器名稱與 Global Routing 狀態即可;請勿在公開紀錄中附上完整訂閱連結、密碼或驗證資訊。以下依序檢查,每完成一項就重新測試。

訂閱未展開:先檢查取得內容的過程

確認裝置目前的網路可正常開啟一般網頁,再檢查 Subscribe 中儲存的 URL 是否完整。如果更新訂閱需要先建立連線,請先確認自己是否已有可用的連線方式,不要將空白列表當成伺服器選擇問題。網址過期、帳戶狀態變更或回傳內容不符合訂閱格式時,請向自己的服務供應商確認;反覆儲存相同的錯誤網址不會產生有效項目。

測試逾時:檢查參數與網路條件

開啟伺服器編輯項目,對照原始資料檢查 Type、Address、Port 與驗證欄位,再核對 TLS、傳輸方式及相關名稱欄位。留意複製內容前後的空格、數字連接埠與容易混淆的字元;不要只因兩份資料名稱相似,就將參數交叉組合。若連線需要進行時間驗證,也請在裝置系統設定中確認日期、時間與時區正確。

參數確認無誤但仍無法連線時,可在條件允許的情況下切換 Wi-Fi 與行動網路,使用同一台伺服器及相同的測試方式進行比較。如果只有某個網路無法連線,優先檢查該網路的連線條件;若多個網路都失敗,再確認伺服器是否可用。測試方式本身也可能受目標限制,因此應同時參考實際網頁存取結果,不要只憑一次逾時就下結論。

開關無法維持開啟:先檢查系統設定

確認是否已允許新增 VPN 設定,以及是否有其他連線正在接管系統 VPN。可在系統設定中搜尋 VPN,查看相關設定狀態,但不要一開始就刪除描述檔。若確實需要重新授權,請先保留 App 中的伺服器與設定資料,依系統提示完成操作後,再返回 Home 連線。App 內資料、系統 VPN 設定與遠端伺服器各屬不同層級,刪除其中一項不代表所有問題都已重設。

已建立連線但部分內容無法存取:檢查路由與 DNS

先確認 Global Routing 沒有停在直連(Direct)。如果代理(Proxy)可以存取、配置(Config)卻不行,優先檢查目前啟用的 Config 檔案、規則順序及命中策略。網域解析失敗時,可能看起來與伺服器逾時相似;請參考連線記錄,確認問題發生在解析階段,還是建立遠端連線階段。不要同時更換 DNS、規則與伺服器,再猜是哪一項生效。

每次只修改一個欄位或一種模式,儲存後重新送出相同請求;若沒有改善,請還原原值,再檢查下一項。需要進一步排查時,可閱讀常見問題,了解購買、權限與訂閱問題;或前往規則與設定參考大全核對設定檔結構。完成上述步驟後,應能分辨「資訊尚未匯入」、「伺服器無法連線」、「本機未獲授權」與「規則不符合預期」,不必靠反覆重新安裝 App 試錯。