Shadowrocket 使用說明
訂閱匯入與首次連線

STEP 01 / HOME

新增伺服器 / 匯入現有訂閱

開啟 Shadowrocket，先進入底部的 Home。這裡會顯示可選的伺服器及連線入口。點選右上角加號進入 Add Server，再依現有資料選擇 Type。訂閱與單一伺服器最後都需要在 Home 清單中形成可選取的項目，但填寫欄位並不相同。

已有訂閱連結：選擇 Subscribe

在 Add Server 中將 Type 設為 Subscribe，並將自己的完整訂閱連結貼到 URL。貼上後檢查連結開頭、結尾與查詢參數是否完整，避免包含聊天內容、換行或多餘空格。備註可填寫方便自己辨識的名稱，不會影響伺服器實際參數。確認後使用頁面上的儲存操作，返回 Home，等待訂閱內容讀取完成。

訂閱連結是用來取得及更新伺服器清單的網址，不是一般網站首頁，也不一定能在瀏覽器中直接顯示為可讀文字。請勿為了讓它「看起來像網址」而刪除其中的參數。連結可能包含個人存取憑證，不應公開貼到問答、截圖或共用文件中；需要排查時，描述錯誤提示即可。

返回 Home 後，檢查訂閱分組下方是否出現伺服器項目。只看到訂閱名稱但沒有伺服器，不能視為匯入完成；應先確認目前網路能讀取訂閱、連結仍有效，而且回傳內容可供辨識。訂閱更新失敗與某個伺服器連線失敗是不同階段的問題，清單尚未產生時，請勿反覆切換路由模式。

已有單一伺服器：依 Type 填寫

如果已有位址、連接埠及驗證資訊，請在 Add Server 的 Type 選擇資料所對應的通訊協定類型，再逐項填寫。位址與連接埠應分開輸入；驗證資訊可能是密碼，也可能是通訊協定要求的其他欄位。如有加密方式、TLS、傳輸方式或其他附加參數，請以原始資料為準，不要因名稱相似就替換選項，也不要套用其他通訊協定的欄位。

如果原始資料提供 QR Code，可以使用 Scan QR Code 讀取；完成後仍須檢查辨識出的 Type、位址和連接埠，不要只看到項目名稱就立即連線。手動輸入時尤其要注意數字與字母、全形標點，以及複製時尾端多出的空格。儲存後返回 Home，確認伺服器項目存在，再進行下一步。

STEP 02 / GLOBAL ROUTING

選擇 Global Routing 模式

在 Home 找到 Global Routing 並開啟。這裡決定請求要透過哪種路徑處理，與伺服器清單中的「選擇哪一台伺服器」是不同的設定。先了解 Config、Proxy、Direct 的差異，再依本次操作目的選擇；不要把切換模式當成修正錯誤參數的方法。

使用 Config 前，先確認設定

準備依規則分流時，進入底部的 Config，確認目前選取的是哪一份設定。匯入訂閱不代表同時取得適合自己的完整規則檔，伺服器清單與規則設定需要分別確認。如果已有設定檔，應先核對來源與內容，再選取使用；首次操作不必為了完成連線而隨意匯入不熟悉的設定。

Config 會依據目前設定判斷請求要交由 PROXY、使用 DIRECT，或執行其他規則動作。因此，同一台伺服器在 Proxy 下可以存取某個頁面，在 Config 下卻可能走另一條路徑。這不一定表示伺服器故障，還需要檢查該請求符合哪條規則。規則關鍵字與更詳細的比對邏輯，可繼續閱讀通訊協定參考及功能介紹。

使用 Proxy 與 Direct 進行單項比對

如果還不確定是伺服器還是規則有問題，可以暫時選擇 Proxy，搭配下一步的預設伺服器進行測試；需要確認目前網路能否直接存取時，則暫時選擇 Direct。測試結束後切回需要的模式。Direct 並不表示「仍透過所選伺服器，只是速度不同」，也不能用來證明代理路徑已生效。

選定後返回 Home，再確認一次 Global Routing 目前顯示的值。不要一次變更模式、伺服器、DNS 與設定檔：若結果有變化，就難以判斷是哪一項設定發揮作用。日常需要規則分流時使用 Config，前提是目前設定中的規則確實符合使用目的。

STEP 03 / VPN

選取預設伺服器並開啟連線

返回 Home，在清單中找到準備使用的伺服器，點選左側圓點將其設為預設伺服器。先確認選取狀態是否已變更，再操作頂端的連線開關。點選伺服器名稱可能會進入詳細資訊或其他操作，因此不要只憑「剛才點過這一列」就認為預設項目已切換成功。

訂閱中有多個項目時，先選擇一個參數完整、且確認仍可使用的伺服器完成首次連線。系統授權視窗出現時，不要連續點選其他項目。預設伺服器與 Global Routing 要一起檢查：伺服器決定代理路徑的目標，模式決定請求何時使用這條路徑，兩者缺一不可。

允許系統新增 VPN 設定

開啟 Home 頂端的連線開關。首次建立連線時，系統可能會提示 Shadowrocket 要求新增 VPN 設定。確認提示與目前操作相符後選擇允許，並依裝置要求完成密碼或其他身分驗證。這項系統授權用來建立本機網路設定，不是要求填寫伺服器密碼；伺服器驗證資訊應填入 Add Server 的對應欄位。

完成授權後返回 Shadowrocket，檢查開關是否維持開啟，以及是否出現連線失敗提示。如果先前拒絕過授權，請重新嘗試連線並依系統提示處理；必要時前往系統設定中的 VPN 管理位置檢查現有設定。請勿為了排查而大量刪除裝置上的其他網路設定，尤其是由公司或裝置管理設定的項目。

系統顯示 VPN 狀態，只能說明本機 VPN 設定正在運作，不能單獨證明遠端伺服器可用，也不代表每個請求都經過代理。同樣地，開關維持開啟與瀏覽器能否正常存取，是兩項需要分別確認的結果。現在先保留目前的伺服器與模式，進入下一步驗證連線。

STEP 04 / CONNECTIVITY TEST

驗證連線能力與實際存取結果

保持連線開關開啟，在 Home 使用 Connectivity Test，查看目前伺服器的測試結果。測試需要一些時間，請先等結果穩定，不要在測試進行時連續切換網路或預設項目。如果清單中測試了多台伺服器，請分辨目前使用的預設伺服器與其他項目；其他項目測試成功，不代表目前連線成功。

Connectivity Test 用來檢查特定測試條件下的連線能力，並不能完整證明所有 App、所有網域或所有傳輸方式都正常。結果異常時，應搭配實際存取情況一起判斷；結果正常時，也仍須確認目前 Global Routing 的行為。不要只根據一個數值選擇伺服器，更不要把測試結果等同於實際下載速度。

再用瀏覽器實際傳送一次請求

切換到瀏覽器，瀏覽一個已知正常的頁面，確認頁面能夠載入。接著依需求測試另一個目標，避免只根據快取頁面判斷連線是否生效。測試時記錄目前網路、預設伺服器與 Global Routing，不必同時開啟大量 App；先讓結果可重現，再擴大測試範圍。

如果在 Proxy 下可以存取，但在 Config 下某個目標失敗，優先檢查目前設定的比對規則與 DNS 行為，不要急著刪除所有伺服器。如果在 Direct 下也無法瀏覽一般頁面，請先確認 Wi-Fi 或行動網路本身是否可用。切換網路前記下原本狀態，切換後再進行一次相同測試，避免將網路變更與伺服器變更混為一談。

區分三項完成標準

1. 本機已建立連線：頂端開關維持開啟，且已完成系統授權。
2. 伺服器可連線：目前預設伺服器的測試與實際代理請求結果一致且可解釋。
3. 規則符合預期：使用 Config 時，需要代理或直連的請求會依設定中的規則處理。

前兩項成立後，再處理第三項，排查範圍會更清楚。單次測試失敗不應直接歸因於通訊協定類型；實際網路、驗證參數、伺服器狀態與設定規則都可能影響結果。確認能穩定重現的現象後，再依下一節的順序定位問題。

STEP 05 / CHECKLIST

依失敗階段檢查，避免重複重新安裝

連線失敗時，先確認問題發生在哪個步驟，再修改對應設定。重新安裝會讓你重新進行匯入與授權，但不會自動修正訂閱失效、驗證錯誤或規則比對問題。每次只變更一個條件，進行相同測試並記錄變化，才容易縮小問題範圍。

清單空白：返回匯入階段檢查

如果 Home 沒有伺服器，先檢查是否已儲存 Add Server 中的內容。訂閱項目存在但分組內沒有伺服器時，核對 URL 是否完整、訂閱是否仍可正常讀取，並查看 App 顯示的錯誤提示。不要反覆新增相同連結，造成多個重複分組；保留一個可辨識的分組，確認更新結果即可。若涉及訂閱權限或回傳內容，請向現有服務的資訊提供者確認，不要公開完整連結。

開關無法維持開啟：檢查授權與本機狀態

如果開啟後立即關閉，先確認是否已允許系統新增 VPN 設定，並檢查目前裝置是否有其他正在運作的 VPN 設定。裝置受管理或系統設定有限制時，請依裝置管理規範處理。如果 App 顯示明確提示，記下提示原文，比只描述「無法連線」更有助於定位；不了解影響前，請勿刪除系統網路項目。

開關已開啟但請求失敗：核對伺服器參數

確認左側圓點選取的確實是準備使用的伺服器，重新核對 Type、位址、連接埠及驗證欄位。如果伺服器需要 TLS 或其他傳輸參數，也應逐項與原始資料核對。訂閱中有其他已知有效的項目時，可以只更換預設伺服器進行比對；如果全部都失敗，再檢查目前網路與訂閱狀態，不要同時修改所有項目的參數。

只有部分目標失敗：檢查模式與設定

先確認 Global Routing 是否誤設為 Direct，再確認 Config 中選取的設定。暫時切換到 Proxy 後重試相同請求，有助於分辨是代理路徑還是規則比對問題；測試結束後應恢復需要的模式。若只有網域存取異常而其他測試結果不同，再進一步檢查 DNS；不要一開始就同時更換多項 DNS 設定。更多分流與連線問題，請參閱常見問答與故障排查。

向資訊提供者回報時，可描述裝置系統、選取的通訊協定、失敗階段、錯誤提示，以及切換網路後的結果。密碼、完整訂閱連結及其他驗證資訊應妥善保密。首次連線穩定後，再依序整理伺服器備註、確認 Config、設定 On Demand；每新增一項設定都進行一次驗證，讓設定過程保持可追蹤。