Shadowrocket
訂閱匯入與首次連線

01 新增伺服器或匯入現有訂閱

先確認手上的資料是哪一種：訂閱連結、單一伺服器分享資料，或需要逐項填寫的伺服器參數。不同資料的匯入方式不同，不必將同一份資料逐一嘗試所有入口。訂閱通常用來取得及更新一組伺服器項目；單一伺服器資料則用來建立一筆連線設定。訂閱也不等於規則設定檔，匯入成功後仍須在下一步檢查 Global Routing。

已有訂閱連結：Add Server → Subscribe

開啟 Shadowrocket，進入 Home，點選右上角的新增按鈕，進入 Add Server。在 Type 中選擇 Subscribe，再將自己的完整訂閱連結貼到 URL 欄位；也可填寫方便辨識的備註。連結請保持原樣，尤其不要刪除問號後的參數，並確認前後沒有多出空格、換行或聊天訊息中的說明文字。確認後使用頁面右上角的儲存功能，返回 Home 等待匯入結果。

匯入完成後，Home 應會顯示相應的群組或伺服器項目。請先確認項目確實出現，而非只看訂閱名稱是否已儲存：儲存了網址不代表遠端內容已成功讀取。若只看到群組，卻沒有可選項目，請先檢查目前網路能否讀取連結、連結是否仍有效，以及提供者回傳的內容是否為可辨識的訂閱格式。不要為了讓清單顯示項目而任意修改連結參數。

已有單一伺服器資料：依 Type 填寫參數

如果取得的是伺服器位址、連接埠、密碼與協定參數，請在 Home 開啟 Add Server，並先選擇正確的 Type。例如資料使用 Shadowsocks，就選擇對應類型再填寫；不要只因位址與連接埠相同，就改選其他協定。不同 Type 會顯示不同欄位，請逐項對照手上的資料，填寫驗證資訊、加密方式及適用的傳輸設定。未提供的選用參數不要自行猜測填入。

若已有 QR Code，可使用 Scan QR Code 讀取自己的伺服器分享資料，並依系統提示授予相機權限。匯入後仍應開啟項目，核對 Type、位址與連接埠；掃描成功不代表伺服器一定可用。若手動填寫，儲存後返回 Home，確認新項目已出現，再點選其中一項作為目前使用的伺服器。首次測試只選一項，避免尚未記錄結果就反覆切換。

訂閱連結與伺服器驗證資料可能包含存取憑證。排查問題時，請勿將完整連結、密碼或 QR Code 公開；記錄問題時可保留錯誤提示與欄位名稱，並隱去實際資料。匯入完成後，接著要決定如何處理請求，而不是立刻修改所有 Settings。想了解訂閱、伺服器項目與設定檔的差異，請先參閱術語手冊。

02 選擇 Global Routing 模式

返回 Home，開啟 Global Routing。首次使用時，先了解三種模式：配置(Config)、代理(Proxy)與直連(Direct)。這項選擇決定整體路由方式；Home 中選取的伺服器，則決定需要使用伺服器時採用哪一組連線資料。兩者處理的是不同問題，不能因為已選取伺服器，就認定請求一定會經由該伺服器。

配置(Config)：先確認目前使用的規則檔

配置(Config)會依目前設定檔中的規則處理請求。若已有可信來源提供的規則設定，請進入 Config，核對目前實際啟用的檔案，而不只是確認檔案出現在清單中。接著返回 Global Routing，選擇 Config。規則可能將不同請求交由 PROXY、DIRECT 或 REJECT 處理，因此不同目標在同一時間出現不同結果，不一定代表連線失效。

若目前只有訂閱連結，還沒有準備好規則檔，請勿假設匯入訂閱後就已設定好所需的分流。先確認 Config 目前的內容及來源，再決定是否使用這套規則。規則依序比對，較前面的比對結果會影響後續處理；首次連線時無須逐條編輯，先保留可追溯的原始設定。規則關鍵字與策略的詳細說明，請參閱術語手冊。

代理(Proxy)與直連(Direct)：辨別請求處理路徑

代理(Proxy)會將一般請求交由目前選取的伺服器處理，適合首次排查時暫時減少規則分流造成的變數。若不確定 Config 是否影響目標存取，可記下原本的模式，暫時選擇 Proxy，再以相同目標進行對照測試。這是檢查所選伺服器的方法之一，不代表日常使用都必須維持 Proxy，也不保證任何目標都能連線。

直連(Direct)會讓一般請求直接連線至目標，不經由所選的代理伺服器。這可用來觀察目前網路的直接連線情況，但不能據此確認伺服器運作正常。若測試時使用 Direct，即使 Home 已選取伺服器，也不應將網頁成功開啟解讀為該伺服器已生效。選好本次使用的模式後，返回 Home，記下所選伺服器與 Global Routing；下一步再開啟連線開關。

03 開啟連線開關並完成授權

在 Home 再次確認目前選取的伺服器與 Global Routing，然後開啟頁面頂端的連線開關。首次建立連線時，系統可能會顯示新增 VPN 設定的授權提示。這一步是允許 Shadowrocket 在系統中建立所需的網路設定，不是新增另一份訂閱，也不會替你補齊伺服器參數。確認提示是由剛才的操作觸發後，允許新增並依系統要求完成裝置認證。

若先前選擇不允許，連線通常無法繼續。返回 Shadowrocket 再次嘗試開啟，並確認系統是否重新顯示授權提示；也可前往系統 Settings 查看 VPN 設定狀態。不要為了嘗試恢復而一次刪除多個用途不明的設定；若裝置受管理，應先確認是否受到組織政策限制。App 尚未取得所需權限時，反覆更換伺服器無法解決權限問題。

完成授權後返回 Home，確認開關能否維持開啟，並等候連線狀態穩定。若開關剛開啟就立即關閉，先保留當時的提示內容，再檢查所選項目是否完整、系統設定是否已建立，以及是否有其他 VPN 連線正在使用。即使開關維持開啟，仍須繼續確認；系統顯示 VPN 狀態，只能表示系統連線設定處於相應狀態，不能單獨證明伺服器驗證、目標存取與規則比對都正確。

這一輪先維持手動操作，不要同時啟用 On Demand 或修改多個 Settings 項目。若要更換伺服器，建議先關閉連線、選擇另一個項目，再重新開啟，讓每次測試的條件都清楚一致。iPad 也依 Home、伺服器選擇、Global Routing、連線開關的順序檢查；介面配置可能因裝置與 App 顯示方式不同而異，但核對項目不變。

開關能維持開啟後，接著確認實際請求。先不必在意測試數值高低，優先核對「選取的項目、路由模式、實際存取結果」是否相符。

04 確認連線是否如預期生效

先在 Home 使用 Connectivity Test 測試已有的伺服器，並留意目前採用的測試方式。測試有回應，只表示在該測試條件下取得結果，不代表每個網站、每種協定或每條規則都會成功；測試逾時也須一併考量測試目標與目前網路。首次確認時，請同時記錄測試結果與網頁存取結果，不要只憑單一數值下結論。

依相同順序完成三項確認

1. 確認 Home 目前選取的正是剛才測試的伺服器。訂閱更新或手動切換後，請再次確認選取狀態，避免測試的是一項，實際連線卻使用另一項。
2. 開啟平時可正常瀏覽的頁面，確認裝置的基本網路請求可以完成；再前往本次需要確認處理路徑的目標。可重新整理頁面或開啟新頁面，避免只看到先前快取的內容。
3. 返回 Shadowrocket，參考 Data 中可檢視的連線記錄，並搭配目前的 Global Routing 與 Config 規則判斷處理結果。記錄顯示的細節可能不同，請以實際介面內容為準；不要只因缺少某個欄位就認定發生異常。

若使用配置(Config)，兩個目標可能分別符合 DIRECT 與 PROXY，須搭配規則解讀結果。需要比較時，暫時切換至代理(Proxy)，維持伺服器與目標不變，再測試一次。若 Proxy 可以存取、Config 不行，下一步應優先檢查規則與對應策略，而非立即重新輸入伺服器密碼。對照完成後，請恢復原本預定使用的模式，避免將測試設定留作日常配置。

若 Connectivity Test 有回應，但網頁持續無法載入，也不能簡單歸因於速度太慢。驗證資料、傳輸參數、DNS 解析、目標本身與規則都可能影響實際請求。先觀察是所有目標都失敗，還是只有單一目標異常，再決定檢查範圍。單一頁面載入失敗，不足以概括整體連線狀態；同樣地，單一頁面載入成功，也不能證明所有分流都符合預期。

確認通過後，記下可重複的檢查條件：使用哪個伺服器、哪種 Global Routing、哪個目標，以及連線時使用的網路。日後修改 Config 或啟用 On Demand 時，可用相同條件再次測試。記錄中無須保存密碼或完整訂閱連結，只要留下可辨識項目與操作順序的資訊即可。

05 依失敗環節排查常見問題

遇到問題時，先找出流程停在哪一步：資料未匯入、伺服器測試沒有結果、開關無法開啟，或開啟後存取結果不如預期。每次只變更一項，再重做剛才的測試。若同時修改訂閱、伺服器參數、Global Routing 與 DNS，往往會失去原有線索，也難以判斷是哪項調整真正有效。

訂閱已儲存，但沒有伺服器項目

先確認 URL 是自己的完整訂閱連結，再確認目前網路能否讀取。登入頁面、錯誤頁面或格式不符的內容，即使能載入，也不代表是可匯入的訂閱。若先前已有可用項目，更新失敗時不要立刻全部清除；保留現有記錄，核對連結是否有效及服務狀態。需要詢問原提供者時，可說明錯誤提示與發生環節，但不要公開完整連結。更多說明請參閱常見問題中的訂閱匯入分類。

項目已存在，但 Connectivity Test 逾時

開啟該項目，依原始資料逐一核對 Type、伺服器位址、連接埠、驗證資料與傳輸參數，並留意數字、大小寫及複製時帶入的空格。若項目由訂閱管理，手動修改的內容之後可能會在更新時變動，請先確認目前資料的來源。再用自己已有的另一個伺服器進行對照；若只有一項失敗，優先檢查該項資料與服務狀態；若全部失敗，也要檢查裝置目前的網路是否正常。

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

先確認系統新增 VPN 設定的提示是否已允許，再查看項目是否缺少必要欄位。若裝置正在使用另一個 VPN 連線，先確認其用途，並結束不需要的連線，再嘗試使用 Shadowrocket。受管理裝置的限制應依管理規範處理，無法靠修改伺服器資料解決。不要將「開關無法維持開啟」和「開關已開啟但網頁無法載入」視為同一種故障；兩者應優先檢查的項目不同。

連線已開啟，但所有頁面都無法載入

先關閉連線，確認目前的 Wi-Fi 或行動網路本身可以正常存取，再重新連線並以相同目標測試。若 Direct 下可用、Proxy 下失敗，優先檢查所選伺服器與驗證參數；若 Proxy 下可用、Config 下失敗，則著重檢查設定檔、規則比對與相關策略。DNS 也可能影響結果，但不要一開始就改用不熟悉的位址；先保留目前設定，確認問題是否只發生在網域名稱解析階段。

只有部分目標異常，或連線後狀態又改變

部分目標異常時，記下目標與目前模式，檢查是否符合預期的 PROXY、DIRECT 或 REJECT。訂閱更新後，項目名稱或可用項目可能改變，也要重新確認目前選取的項目。若狀態會隨 Wi-Fi 切換、鎖定螢幕或開啟 App 而改變，請再檢查 On Demand 的觸發條件；先停用自動觸發進行手動對照，不要直接重置所有設定。若要系統性檢查規則順序、DNS、耗電或更新後異常，請接著閱讀故障排除手冊。

本篇首次使用流程到此完成。日常使用無須每次重新新增伺服器：先確認目前項目與 Global Routing，狀態有變化時再依本頁對應步驟檢查。遇到不熟悉的介面用語，可查閱術語手冊；購買、還原已購項目與安裝相關問題，請參閱正版購買與安裝說明。