官方手冊 / 入門操作

Shadowrocket 使用教學:匯入與連線

依照「新增資料 → 選擇模式 → 連線 → 驗證 → 排查」的順序操作。先建立一次可重複驗證的手動連線,再調整規則與自動連線條件。

操作裝置:iPhone / iPad 先確認參數,再調整規則 介面用語保留英文原文
步驟 01 / 準備連線資料

Add Server:新增與匯入

先確認資料類型。單一伺服器、伺服器訂閱與 Config 設定檔是不同類型的內容。

開啟 Shadowrocket 的 Home,找到 SERVER 群組及 Add Server 入口。開始填寫前,先檢查手邊資料:一組位址、連接埠與認證資料適用於手動新增;伺服器分享連結或 QR code 適用於單筆匯入;可取得伺服器清單的連結則是伺服器訂閱。包含規則、DNS 或策略設定的設定檔由 Config 管理。連結都是網址,不代表可以使用同一個入口匯入。

手動填寫 Add Server

  1. 點選 Add Server,先開啟 Type,依照現有資料選擇協定。協定會決定後續顯示的欄位;截圖中的 Password、Method 是特定類型的欄位範例,並非所有協定都使用相同表單。
  2. 將伺服器位址填入 Host,連接埠填入 Port。只填入欄位要求的值,不要將完整分享連結貼到 Host,也不要在位址末尾重複填寫連接埠。
  3. 依照資料填寫認證資訊與協定相關選項。確認大小寫、前後空格,以及複製時是否混入換行。若涉及 TLS、傳輸方式或伺服器名稱,請依照原始參數設定,不要自行猜測。
  4. 使用頁面上的儲存功能返回 Home,確認 SERVER 中出現對應項目。備註可用來辨識伺服器;備註相同不代表位址或認證資料相同。

如果手邊有既有伺服器的 QR code,可在 Add Server 頁面使用 Scan QR Code。掃描後仍須檢查辨識出的 Type、Host 和 Port,再儲存。Import from Cloud JSON 用於匯入符合該入口要求的 JSON 內容,不應當作通用的訂閱連結貼上欄位。匯入成功只代表 App 已辨識資料,不代表遠端伺服器已連線。

已有訂閱:區分伺服器清單與設定檔

如果已有伺服器訂閱,請在 Add Server 中依據資料類型選擇 Subscribe,將完整訂閱網址填入 URL,儲存並等待清單取得完成。不要刪除或修改網址中的路徑與查詢參數;這些內容可能用於身分驗證。返回 Home 後,確認訂閱群組中是否出現伺服器。如果只有群組名稱、沒有項目,應先排除清單取得問題,不要直接進入連線步驟。

如果已有設定檔訂閱,請前往 Config,使用其中的 Subscribe 入口新增對應的設定檔網址,取得後確認並選擇要使用的檔案。Config 的 Subscribe 與伺服器清單訂閱用途不同:前者管理設定內容,後者管理連線對象。不要只因網址名稱含有「訂閱」就混用入口。若要整理多份訂閱、確認分享格式或安排更新,請繼續閱讀訂閱與伺服器管理手冊。

完成這個步驟後,應能確認 Home 中準備使用的伺服器,以及是否已有可供規則模式使用的設定檔。接著選擇 Global Routing,不要立刻反覆切換連線開關。

Shadowrocket 的 Add Server 官方介面,顯示 Type、Host、Port、Password、Method 與 QR code 掃描匯入入口
官方 App Store 螢幕截圖:Add Server。先選擇 Type,再依實際顯示的欄位填寫;截圖中的欄位不代表所有協定都使用相同表單。
步驟 02 / 決定流量處理方式

Global Routing:三種模式

先決定目前希望如何處理流量,再檢查設定檔;模式名稱不是連線品質指標。

返回 Home,點選 Global Routing。本教學將三種模式稱為設定(Config)、代理(Proxy)和直連(Direct),括號內是 App 中的英文選項。選擇後返回 Home,確認 Global Routing 這一列實際顯示的值。不要只憑上一次操作的印象判斷目前模式。

模式處理方式與用途
設定(Config)依照目前啟用的設定檔與規則決定策略,適合檢查分流結果。
代理(Proxy)以代理模式處理流量,適合先排除規則因素,驗證所選伺服器。
直連(Direct)以直連方式處理流量,可作為本機網路的對照,不適合用來確認代理伺服器是否可用。

如果是第一次新增伺服器,尚未準備好規則設定檔,可以先用代理(Proxy)驗證連線對象。驗證完成後,再切換到設定(Config)檢查實際分流。Proxy 並非所有故障的修復方式:伺服器位址、認證資料或本機網路有問題時,切換模式無法補足這些條件。

Config 模式需要確認的項目

選擇設定(Config)之前,請前往 Config,確認目前選取的檔案就是這次要使用的設定檔。查看內容時,可依照截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段辨識。首次連線只需確認既有設定,不必為了完成教學而逐一啟用這些功能;尤其不要把 HTTPS Decryption 當成一般連線的必要步驟。

在 Rule 中,確認瀏覽目標符合哪條規則、該規則使用什麼策略,以及最後的預設處理方式。規則通常依序比對,前面的規則命中後,後續規則可能不再參與同一次判斷。以下僅供辨識語法,不代表要以整段內容取代現有設定:

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

這組範例分別表示網域後綴比對、區域網路位址範圍比對,以及最終策略。PROXY、DIRECT 是策略詞,不是伺服器位址。使用 Add Rule 新增內容前,請確認插入位置與既有規則的關係;只新增規則而不檢查順序,可能無法達到預期效果。規則關鍵字與 DNS 的詳細說明請參閱概念速查;這次先維持最少且可確認的變更。

到這裡應已確認一組明確的組合:「所選伺服器 + 目前的 Global Routing + 目前的 Config 檔案」。若連線失敗,請記下這三項資訊,後續才能判斷問題出在哪一層。

Shadowrocket 的 Config 設定檔編輯官方介面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
官方 App Store 螢幕截圖:Config 檔案編輯。請在 Home 選擇 Global Routing;此處展示設定檔內的區段與 Rule 編輯入口。
步驟 03 / 建立手動連線

Home:連線開關與系統授權

先選擇伺服器,再開啟頂端開關。系統授權與遠端服務是否可用,須分別確認。

返回 Home,在 SERVER 群組中點選這次要使用的伺服器,確認選取標記。若同一群組有多部伺服器,查看清單不代表已切換至其中一部;也不要把訂閱群組名稱當成目前的連線對象。確認後,再檢查 Global Routing 是否仍為上一步選擇的模式。

  1. 找到 Home 頂端的連線開關。截圖中的 Not Connected 表示拍攝當下尚未建立連線,不是匯入資料失敗的提示。
  2. 開啟連線開關。首次建立連線時,系統可能會提示加入 VPN 設定;請確認發起 App 是 Shadowrocket,再依照系統提示允許,並完成裝置要求的認證。
  3. 返回 Shadowrocket,等待狀態回報。如果取消了授權,請重新發起連線並完成授權,不要立即修改伺服器密碼或規則。
  4. 建立連線狀態後,保持目前的伺服器與模式不變,進入下一步驗證實際瀏覽情況。驗證前不要同時更新訂閱、更換伺服器和修改 DNS。

系統 VPN 設定會讓裝置依照 App 設定處理相應的網路流量,並非用來建立遠端伺服器。授權通過不代表訂閱仍在有效期限內、伺服器認證正確或遠端網路正常。反過來說,若尚未完成系統授權,繼續測試伺服器參數也無法取代這個步驟。

如果開啟開關後很快又自動關閉,請先留意是否出現明確錯誤,並檢查裝置上是否有其他正在使用連線的 VPN 設定。需要切換時,先停止原有連線,再重新嘗試使用 Shadowrocket;不要刪除來源與用途不明的裝置管理設定。如果開關維持開啟但網頁無法瀏覽,請保留目前狀態,依照後續驗證與排查順序處理。

確認首次手動連線成功之前,先不要調整 On Demand。自動連線條件會增加判斷變數,讓「是什麼觸發重新連線」與「伺服器是否可用」混在一起。先完成一次可手動開啟、驗證並主動關閉的連線,再考慮自動化。

Shadowrocket 的 Home 官方介面,顯示 Not Connected 開關、Global Routing、Connectivity Test、SERVER 群組與 Add Server
官方 App Store 螢幕截圖:Home。連線前依序確認 SERVER 選取項目、Global Routing 與頂端開關,再執行 Connectivity Test。
步驟 04 / 區分狀態與結果

Connectivity Test:驗證是否生效

測試結果、實際瀏覽情況與規則命中是不同層次的證據,不能只看開關狀態。

開啟連線開關後,在 Home 執行 Connectivity Test,查看目前伺服器在此測試方式下的回應。測試結果可協助判斷連線情況,但不能只憑某個數值推斷所有網站都能瀏覽,也不能將測試失敗直接解讀為密碼錯誤。測試方式與目標都會影響結果;後續排查時應維持測試條件一致。

  1. 驗證實際連線。 開啟瀏覽器,前往這次實際需要使用的頁面,重新載入並確認頁面內容是否正常顯示。只看到先前已開啟的內容,可能是快取,不能充分證明新連線成功。
  2. 對照目前模式。如果目前使用代理(Proxy),先確認所選伺服器能完成請求;如果使用設定(Config),還須檢查目標是否符合預期規則。在直連(Direct)模式下能瀏覽某個頁面,不代表該請求使用了代理。
  3. 確認不同策略。使用自己熟悉且可正常瀏覽的目標,分別檢查應透過 PROXY 和 DIRECT 處理的請求。在 App 提供的連線記錄中,比對目標、命中規則與策略;連線記錄的保留與顯示範圍以目前 App 介面為準。
  4. 重測相同目標。需要調整時,每次只修改一個變數,再重新開啟同一頁面。記錄修改前後的模式、伺服器與現象,避免將目標網站的差異誤判為設定變更的結果。

如果 Proxy 可以瀏覽、Config 卻不行,請優先檢查目前的設定檔、規則順序與 DNS,而不是立刻重新建立訂閱。如果兩種模式都無法瀏覽,應先檢查伺服器與本機網路。若只有單一網站無法瀏覽,請繼續確認該目標對應的規則與服務狀態,不必直接重設所有設定。

步驟 05 / 依故障位置排查

Settings:常見故障原因

從前置條件到規則逐層排查。每次只調整一項,重新測試後再決定下一步。

清單沒有項目:先檢查匯入

如果儲存訂閱後沒有出現伺服器項目,先確認網址完整、使用正確的 Subscribe 入口,且本機網路能正常取得清單。學校、公司或公共 Wi-Fi 可能需要先登入網路;必要時可比較自用 Wi-Fi 與行動網路的結果。訂閱網址可能包含認證資料,請確認複製時沒有截斷,但不要將完整網址貼到公開頁面。需要確認服務狀態時,請透過既有服務的管理管道查詢,不要改用來路不明的網址。

有項目但無法連線:確認伺服器參數

重新開啟伺服器編輯頁,依照原始資料逐項檢查 Type、Host、Port 與認證資料。先確認協定,再檢查該協定所需的附加設定;只修改 Password 無法修正 Type 選錯的問題。訂閱產生的項目可能在更新時被重新寫入,長期手動修補前,應先確認訂閱資料本身是否正確。刪除或重新匯入前,請保留必要的備份;整理方式請參閱伺服器管理手冊。

已連線但無法瀏覽:檢查模式、規則與 DNS

先確認 Home 目前選取的伺服器,再檢查 Global Routing。只有在 Config 模式下失敗時,才檢查實際啟用的檔案、Rule 中的比對順序與 FINAL 的處理方式;不要因檔名相似就認定內容相同。如果是網域無法瀏覽,再檢查設定檔中的 DNS 設定,以及本機網路對解析請求的影響。一次同時更換 DNS、伺服器與規則檔,會讓結果失去比較基準。

前往 Settings 確認 Test Method,確保前後使用相同的測試方式。如需進一步找出問題,請使用 Diagnostics 查看可用的診斷資訊,並記錄發生錯誤時的操作與目標。診斷文字可能包含伺服器位址或連線資料,分享前請先移除訂閱認證參數、密碼及其他個人資訊。不要只為了排查單一網頁問題,就連續修改 Proxy、TCP、UDP 下的所有選項。

自動連線與速度問題:最後再處理

確認手動連線已通過驗證後,才前往 Settings 設定 On Demand,依照實際網路條件設定自動連線行為。修改後,分別檢查加入與離開相關網路時的情況;自動觸發不代表遠端連線一定成功。如果發生非預期的重新連線,請先停用相關條件,恢復手動驗證,再逐項重新設定。

連線可用但速度不如預期時,先使用相同裝置、目標與模式比較本機網路,再比較自己已有的其他伺服器。Connectivity Test 的結果不能直接換算成下載速度;目標服務的回應、遠端線路與裝置目前的網路狀況都可能影響使用體驗。記錄可重複出現的現象,比一次大量修改設定更有助於找出問題。

排查完成後,保留可重現成功連線的伺服器、模式與設定檔,再逐項恢復需要的規則或自動連線條件。若不清楚協定欄位或規則關鍵字,請參閱概念速查;涉及多份訂閱、更新、刪除與備份時,請前往訂閱與伺服器管理手冊。本教學以完成一次可驗證的連線為止,不要求首次操作就調整所有設定。

Shadowrocket 的 Settings 官方介面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
官方 App Store 螢幕截圖:Settings。排查時優先確認 Test Method 與 Diagnostics;完成手動連線驗證後,再設定 On Demand。