Shadowrocket 使用教學
訂閱匯入與連線測試

步驟 01 · 先確認資料類型

新增伺服器或匯入既有訂閱

先確認手上的資料類型，再選擇適合的匯入方式。訂閱連結通常用於取得一組伺服器，之後也可更新；單一伺服器分享內容只包含一筆連線資料；手動參數則需分別輸入協定、位址、連接埠與驗證資訊。不要只因一段內容看起來像網址，就把它當成訂閱。請依服務提供者對資料用途的說明操作，避免將說明頁、帳戶頁面或設定檔下載網址填入錯誤欄位。

訂閱連結：在 Config 找到 Subscribe

開啟 Shadowrocket，進入 Config，找到 Subscribe 訂閱入口。開啟新增訂閱表單後，為資料填寫易於辨識的名稱，將自己的訂閱連結完整貼到網址欄位，然後儲存並等待讀取完成。名稱僅供本機辨識，不會改變訂閱內容；網址中的路徑與查詢參數可能用於驗證，請勿自行刪除或重新拼接。

讀取完成後返回 Home，確認是否出現相應的伺服器群組或項目。匯入後出現清單，只代表用戶端已讀取資料，不能證明其中每台伺服器都可使用。先選取確定要使用的伺服器，再進行後續連線測試。若儲存後清單仍為空白，請先檢查訂閱項目的網址是否完整，以及更新時是否出現錯誤訊息；不要連續新增多份相同資料。

手動輸入參數：在 Home 使用 Add Server

如果取得的是個別參數，請在 Home 點選新增按鈕，進入 Add Server。先依資料選擇正確的協定類型，再依序填寫伺服器位址、連接埠與驗證欄位。不同協定的必填欄位各不相同，例如有些使用密碼，有些使用 UUID，請勿混用不同協定的欄位。名稱或備註可自行設定，連線欄位則必須與既有資料一致。

填寫位址時，若欄位要求主機名稱，就只輸入資料中的主機名稱，不要額外加上網頁路徑。連接埠請填入指定數字；TLS、傳輸方式、Host、SNI 等欄位只有在資料要求時才設定。不要只因選項看起來更完整，就自行開啟所有開關。儲存後返回 Home，選取剛新增的項目並重新開啟檢查，確認沒有一併貼入換行、空格或其他說明文字。

QR Code 與剪貼簿：匯入後仍須核對

若已有伺服器 QR Code，請使用 Scan QR Code，依系統提示授予相機權限，再掃描自己持有的 QR Code。若要從剪貼簿匯入，請先複製完整的分享內容，再使用用戶端提供的匯入入口。QR Code 與剪貼簿只是減少手動輸入的方式，不會補上原始資料缺少的參數，也不保證伺服器目前可連線。

完成任一匯入方式後，返回 Home 確認項目名稱、協定類型與伺服器位址符合預期，再選取該項目。訂閱連結、密碼與完整分享內容都應妥善保管；排查問題時只記錄錯誤訊息與欄位名稱，不要公開整份資料。下一步先確認 Global Routing，暫時不要急著開啟連線開關。

步驟 02 · 確認請求處理方式

選擇 Global Routing 模式

在 Home 找到並開啟 Global Routing，先確認目前選取的是配置（Config）、代理（Proxy）還是直連（Direct）。伺服器決定使用哪份連線資料，Global Routing 則決定請求如何處理。若只切換伺服器而未確認此處設定，可能會誤以為請求已經透過所選伺服器傳送。

首次測試：先減少變因

首次連線若要確認剛匯入的伺服器是否可用，可暫時選擇代理（Proxy）。這樣能減少規則設定造成的干擾：若仍無法完成基本請求，應先檢查伺服器參數或網路，而不是馬上大量修改規則。代理（Proxy）不代表所有 App 或系統流量都會以完全相同的方式處理；下一節連線後，仍須針對個別 App 實際測試。

確認伺服器可用後，若要依目標分別處理請求，再切回配置（Config）。進入 Config 確認目前啟用的是哪份配置，避免混淆「已匯入配置」與「已啟用配置」。只有目前生效的配置會影響當下的規則處理；編輯其他檔案不會自動變更正在使用的規則。

配置（Config）：先確認目前檔案，再了解規則

規則通常依序由上而下比對，符合後便採用對應策略。PROXY 代表交由代理策略處理，DIRECT 代表直接連線，REJECT 代表拒絕請求；FINAL 則在前面的規則都未符合時作為預設處理。第一次使用既有配置時，不建議同時修改規則、更換伺服器並調整 DNS，否則即使結果改變，也很難判斷是哪項設定造成影響。

直連（Direct）適合在排查時與原始網路比較，不適合用來測試代理路徑。選好模式後返回 Home，確認選取的伺服器仍是剛才核對的項目。此時用戶端已設定好「使用哪份伺服器資料」和「如何處理請求」，接著再開啟開關並完成系統授權。

步驟 03 · 完成系統連線授權

開啟開關並確認連線狀態

返回 Home，確認伺服器選取狀態與 Global Routing 都符合剛才的設定，再開啟頂端的連線開關。首次使用時，iPhone / iPad 可能會顯示新增 VPN 設定的系統提示。確認提示對應 Shadowrocket 後允許新增，並依裝置要求完成密碼或生物辨識驗證。這個步驟由系統處理，無須在任何網頁輸入裝置密碼。

完成授權後返回 Shadowrocket，確認開關是否維持開啟。若開啟後立即自動關閉，或系統提示未完成，請先處理授權問題，不必馬上刪除訂閱。若沒有出現預期提示，可到系統 Settings 檢查 VPN 設定狀態，再返回 App 重試；由組織管理的裝置也可能受到管理政策限制，請依裝置管理規定處理。

連線開關已開啟，不代表目標一定能存取

系統接受 VPN 設定，代表用戶端可以建立用來處理流量的連線環境，不代表所選伺服器已通過驗證，也不代表每個目標都能存取。不同裝置與顯示情境下，狀態列標示可能不同，不能只憑某個圖示是否持續顯示來判斷。接下來應保留目前的伺服器與路由設定，實際執行測試並開啟目標頁面。

首次排查時，先不要同時啟用其他會改變網路路徑的 VPN 連線，也不要立刻新增 On Demand 等自動化設定。維持明確的手動連線狀態，較容易確認開關何時開啟，以及錯誤發生在哪個階段。若已有其他網路設定，請先記下原本狀態，再依系統實際顯示確認目前啟用的項目。

若要更換伺服器，先完成目前的測試並記錄結果，再切換一個項目重複測試。需要變更配置時，也請一次只改一項。停止使用時可返回 Home 關閉開關；之後再次連線，仍應確認目前選取的伺服器與 Global Routing，不要因上次成功就忽略這次的選取狀態。

步驟 04 · 從測試確認實際請求

測試 Connectivity Test 與 App 存取

先執行 Connectivity Test，再測試實際網頁與目標 App。測試結果只反映特定測試方式與目標下的狀況，不能一概而論。若測試成功但 App 仍無法使用，或測試逾時但部分網頁可正常開啟，都應繼續檢查請求的處理路徑，而非立刻認定整份資料有效或失效。

先測試所選伺服器，再開啟同一個網頁

在 Home 找到 Connectivity Test 並執行，等待本次測試完成，記錄所選伺服器的成功或失敗狀態。不同測試方式測量的對象可能不同，不要把清單中的數值當成實際下載速度，也不要只看數值大小就更換伺服器。首次測試更重要的是：在相同條件下能否穩定完成測試，以及實際請求是否得到正常回應。

接著開啟瀏覽器，造訪一個自己有權存取且內容容易辨識的一般網頁。確認頁面內文與必要資源是否載入，而不只是看到先前保留的頁面外觀。可重新載入頁面，再開啟另一個頁面交叉確認。維持目前的伺服器不變，避免測試與瀏覽器使用不同項目，導致結果無法比較。

接著測試目標 App 與規則命中情況

瀏覽器正常存取後，再開啟原本要使用的 App，執行一項明確操作，例如重新整理清單或開啟新頁面。一個 App 可能同時向多個網域發出請求；首頁能開啟，不代表登入、圖片或其他功能都使用相同路徑。若只有特定功能失敗，請記錄實際操作與顯示訊息，後續再針對相應請求排查。

使用配置（Config）時，請根據連線記錄中可見的目標與策略，確認請求是否符合預期。若目標命中 DIRECT，表示依規則直接連線，並非伺服器失效而「自動失去作用」；若命中 REJECT，應先檢查目前配置中的規則意義。確認實際採用的策略後，才能判斷問題出在連線還是規則選擇。

Data 中上傳與下載流量的變化可作為請求已發出的輔助線索，但流量增加本身無法證明目標內容已成功傳回，背景工作也可能產生流量讀數。綜合 Connectivity Test、實際頁面結果、路由策略與 Data 判斷，比只看開關或單一數字可靠。確認代理（Proxy）模式可用後，再切回配置（Config）並重複同一套測試，方便找出規則造成的差異。

步驟 05 · 從最早失敗處開始排查

常見問題與排查順序

排查時應從最早未完成的步驟開始。資料尚未匯入，就先修正匯入問題；連線開關無法維持開啟，就先處理系統授權；開關正常但頁面無法開啟，再檢查伺服器與路由。不要略過失敗階段直接重新安裝，也不要一次更改協定、DNS、規則與伺服器。每次變更後，使用相同測試與相同頁面確認，才能判斷是否有效。

匯入失敗或伺服器清單空白

先確認複製的是訂閱連結或用戶端可識別的分享內容，而不是說明頁網址。檢查是否漏複製尾端參數、混入空格或換行，以及網址是否已由服務提供者變更。若訂閱更新顯示驗證失敗或回傳內容不受支援，請向既有資料的提供者確認用途與有效狀態；反覆點選更新無法修正錯誤網址，也無法補上缺少的權限。

已有伺服器清單但沒有出現新資料時，請區分「更新訂閱」與「重新新增伺服器」。先更新原有訂閱，再查看對應群組，避免重複新增後誤選舊項目。手動輸入的伺服器不會因訂閱更新而自動修正；參數有變更時，需依新資料逐項核對。

Connectivity Test 失敗或連線後沒有回應

先關閉連線開關，確認原本的 Wi-Fi 或行動網路能否正常開啟一般網頁。若公共網路仍停留在連線認證頁面，請先完成該網路要求的登入，再返回 Shadowrocket。若原始網路也無法使用，不應先修改代理設定；請先排除裝置連上網路的基本問題。

確認基本網路正常後，重新檢查協定類型、伺服器位址、連接埠與驗證欄位。若資料啟用了 TLS，也要確認相關主機名稱與資料一致，並確認裝置日期與時間正確。請勿任意關閉憑證驗證來略過錯誤。若已有多台伺服器，可只更換伺服器作比較，其餘設定保持不變；接著將完整且準確的錯誤訊息提供給自己的服務提供者查核。

開關立即關閉或授權未完成

先確認系統是否拒絕新增 VPN 設定、身分驗證是否完成，以及是否有另一個 VPN 連線正在使用。到系統 Settings 檢查相關設定時，只處理自己確認用途的項目，不要大量刪除其他網路設定。若裝置受到管理限制，請依管理政策處理，不要反覆重新安裝 App。

代理（Proxy）可用，但配置（Config）下部分請求失敗

遇到這種差異，優先檢查目前啟用的配置與實際命中策略。返回 Config 確認正在使用的檔案，再檢查目標是否符合較前面的規則，以及 FINAL 最後指向哪種策略。規則通常採用第一條符合的項目，排在前面的寬泛規則可能使後面的細項規則無法生效。此時先找出一筆具體請求，不要為了修正單一頁面就清除所有規則。

若只有 Wi-Fi 或只有行動網路發生問題，請保留相同伺服器與模式，再切換網路測試並比較結果。若只有一個 App 異常，請重新開啟該 App 並重複明確操作，再配合連線記錄判斷；不能只因瀏覽器正常，就推定所有 App 都正常。若要進一步了解協定欄位的意義與選擇方式，請參閱協定手冊；規則順序可接著閱讀規則比對與 FINAL 預設策略說明。