Shadowrocket
匯入與連線教學
準備現有設定 → 選擇模式 → 連線 → 驗證 → 排查問題
本頁以 iPhone 與 iPad 為操作裝置，依首次使用的順序說明操作位置、確認事項，以及何時進行下一步。截圖為 App Store 官方截圖，實際介面請以裝置上顯示的內容為準。
STEP 01 / IMPORT
新增伺服器與匯入訂閱
先確認手上的資料類型：只有一個完整網址、用於更新伺服器清單的，通常是訂閱；包含協定類型、伺服器位址、連接埠與驗證資料的，則適合逐台新增伺服器。兩種方式不必重複操作。已有訂閱時，建議優先匯入訂閱，方便日後從同一來源更新清單；只有伺服器參數時，再逐項填寫。
已有訂閱：選擇 Subscribe
開啟 Shadowrocket，進入 Home，點選右上角的新增按鈕或清單中的 Add Server。在新增頁面點選 Type，選擇 Subscribe，將自己的完整訂閱連結填入對應的 URL 欄位，再儲存。截圖顯示的是單一伺服器表單；切換 Type 後，輸入欄位會依類型變更，請勿將訂閱網址填入截圖中的 Host 欄位。
貼上前後請確認連結完整，特別留意問號後的參數、結尾字元，以及從通訊 App 複製時可能一併帶入的空格或換行。訂閱網址通常包含存取憑證，請勿貼到公開留言或截圖中。儲存後返回 Home，等待內容載入完成，確認訂閱群組下方已出現伺服器，而不只是新增了一個訂閱名稱。
若清單仍是空的，請先確認訂閱是否更新成功、網址是否有效，以及目前的網路能否存取該網址。更新失敗與伺服器連線失敗是不同階段：前者尚未取得清單，反覆開啟連線開關無法解決。錯誤訊息的詳細說明請參閱疑難排解。
已有伺服器參數：填寫 Add Server
在 Add Server 中，先選擇與資料相符的 Type，再填寫 Host 和 Port。截圖中的 Password、Method 是該類型欄位的範例；其他協定可能會顯示不同的驗證或傳輸欄位。請勿為了填滿表單而猜測欄位，也不要將某種協定的密碼直接套用到另一種協定。
Host 請填寫伺服器網域名稱或位址，Port 則填入對應的連接埠；其餘欄位請依自己的服務提供者或伺服器設定逐一確認。使用 Trojan 等含 TLS 設定的類型時，也應核對伺服器名稱等相關參數，不能只確認位址和密碼。QR Code 資料可透過 Scan QR Code 辨識，但辨識完成後仍須確認 Type 與目標伺服器是否正確。
儲存並返回 Home 後，請在 SERVER 清單中確認新項目已出現。接著先選取要使用的伺服器；清單中有項目只代表資料已儲存，不表示連線已建立。完成這一步後，再決定要以哪種模式處理這些請求。
STEP 02 / ROUTING
選擇 Global Routing
返回 Home，點選 Global Routing。此處可決定請求採用哪種連線策略，不是用來選擇訂閱來源。首次使用請先了解三種模式：設定檔(Config)/代理(Proxy)/直連(Direct)。應依本次要測試的目標選擇模式，不要認定某種模式永遠較合適。
設定檔(Config)：依目前設定檔處理
Config 會依目前設定檔中的規則決定請求的路由方式。進入 App 的 Config 頁面，確認已有並選取要使用的設定檔；若服務提供者提供的是伺服器訂閱，請勿因此推斷規則設定檔也已一併匯入。伺服器清單與設定檔用途不同：前者提供連線目標，後者則定義如何處理請求。
右側官方截圖顯示設定檔編輯頁中的 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 區段。首次連線不必逐一修改。尤其不要將訂閱連結貼進 Rule，也不要為了完成教學而啟用與目前需求無關的處理功能。
例如，下方規則表示「符合 example.com 及其子網域時使用 PROXY，其他請求則使用 DIRECT」。這只是協助理解局部語法，不是可取代現有檔案的完整設定，也不代表所有網站都應採用相同策略。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT在 Config 模式下，部分請求直接連線、其他請求使用代理，可能正是規則預期的結果。若要調整比對順序、策略名稱或預設規則，請參閱規則與設定參考大全，不要在首次連線時一次修改整份設定檔。
代理(Proxy)與直連(Direct)
Proxy 會將一般請求交由所選代理處理，可用來暫時縮小排查範圍：先確認伺服器本身能否完成連線，再返回 Config 檢查規則差異。Direct 則採用直接連線，不會透過所選代理伺服器存取；因此，即使連線開關已開啟，也不能只憑這點判定正在使用該伺服器。
選好模式後返回 Home，確認 Global Routing 顯示的模式與剛才選擇的一致。若只想測試代理連線，可以先記下原本模式，暫時選擇 Proxy；測試結束後再恢復預計長期使用的 Config。接著再開啟連線，避免混淆「資料儲存」、「模式選擇」與「建立連線」這幾個步驟。
STEP 03 / CONNECT
開啟連線開關與系統授權
現在返回 Home，再次確認 SERVER 中已選取要連線的伺服器，而不只是開啟該項目的編輯頁。接著檢查 Global Routing，最後開啟頂端的連線開關。右側截圖中的 Not Connected 表示尚未連線，截圖不代表目前裝置的狀態。
首次建立連線時，系統會詢問是否允許新增 VPN 設定。請閱讀系統提示，確認這是由本次操作觸發後，依指示允許並完成裝置密碼或系統要求的身分驗證。這是授權 App 設定系統網路連線，與輸入伺服器密碼是兩回事；系統驗證須在系統介面中完成，請勿填入 Add Server 的 Password 欄位。
若剛才取消了系統授權，請返回 App 重新發起連線，確認是否再次出現提示。尚未完成授權時，請勿將開關自動關閉誤判為訂閱失效，也不要立即刪除所有伺服器。先完成授權，再觀察後續狀態，就能避免許多不必要的修改。
返回 Home 確認連線狀態
完成授權後返回 Shadowrocket，查看頂端狀態是否已不再顯示 Not Connected、開關是否維持開啟，以及是否出現錯誤提示。系統中的 VPN 標示可協助確認通道狀態，但無法指出特定網頁採用哪種策略，更不能證明所有伺服器欄位都正確。
若開關立刻關閉，請先記下提示內容，確認 App 已取得系統授權，再檢查是否有其他作用中的 VPN 連線影響測試。不要連續快速切換開關，也不要在連線尚未穩定時同時更新訂閱、變更模式與修改設定，否則難以確認是哪個步驟改變了結果。
開關維持開啟後，先保持目前選取的伺服器與模式不變，再進行下一步驗證。如需停止這次連線，返回 Home 關閉相同的開關即可。首次測試完成前，暫時不必啟用 On Demand，以免按需連線條件讓手動測試的狀態難以判斷。
STEP 04 / VERIFY
驗證連線與實際存取
驗證可分為三個層次：伺服器測試是否有結果、實際網頁是否能完整載入，以及請求是否依預期策略處理。三者彼此相關，卻不能互相取代。只看開關是否開啟或某個測試數值，很容易忽略解析、驗證、規則或目標網站本身的問題。
先用 Connectivity Test 檢查連線狀況
在 Home 點選 Connectivity Test，等待測試完成，再查看所選伺服器的測試結果。此功能可協助找出目前無法連線的目標，但結果會受測試方法與網路環境影響。數值較低不代表所有網頁都能開啟；測試失敗也須配合實際存取情況判斷，不能直接認定整份訂閱內容都已失效。
若同一訂閱中有多台伺服器，可在網路、模式與設定檔維持不變的情況下，改選另一台再測。這樣是一次比對一個變數，而非同時改變整套使用條件。請勿為了追求特定測試數值而頻繁修改協定欄位；參數是否正確，應以自己的伺服器資料為準。
再透過實際請求確認存取結果
保持連線開啟，切換至瀏覽器，瀏覽日常使用且有權存取的網頁，確認頁面不只顯示標題，也能載入內文。接著再以另一個平常使用的目標交叉測試。若只有單一網站無法存取，也可能是網站本身、帳號狀態或對應規則造成，不能直接推斷整體連線失敗。
若使用 Config，請配合 App 內的請求記錄，確認目標網域、命中的規則及所用策略。預期透過代理的請求應採用相應的代理策略；預期直接存取的請求則可能命中 DIRECT。記錄中顯示的內容以目前 App 為準；請勿將 Direct 模式下成功存取，視為代理伺服器已通過測試。
如有需要，可先記下目前設定，暫時切換至 Proxy 後重試相同目標，再恢復 Config。若 Proxy 成功、Config 失敗，請優先檢查規則、策略引用與解析差異；若兩種模式都失敗，則優先檢查伺服器資料與網路。測試完成後，恢復預期的日常模式，並保留已確認可用的設定，作為後續排查基準。
STEP 05 / DIAGNOSE
連線失敗的排查順序
遇到問題時，先明確記錄現象：是訂閱更新失敗、開關無法維持開啟、Connectivity Test 沒有結果，還是只有網頁無法開啟。不同現象發生在不同階段。請依下列順序逐項檢查，每次只變更一項設定，再依第四步的方法重新測試，避免在沒有依據時重建所有內容。
先檢查本機網路，再確認連線資料
關閉 Shadowrocket 連線，確認目前的 Wi-Fi 或行動網路能否正常存取網頁。若本機網路本身無法使用，請先處理網路登入、訊號或網路存取權限。接著返回 Home，確認選取的仍是預計測試的伺服器；若近期訂閱內容有變動，請先更新既有訂閱並檢查結果，勿反覆新增相同網址，造成重複項目。
若使用單一伺服器方式，請返回 Add Server，逐項核對 Type、Host、Port 與驗證資料。複製內容多出空格、連接埠填錯或協定選擇不符，都可能造成資料儲存成功但連線失敗。含 TLS 或額外傳輸設定的伺服器，也須核對對應參數。請勿任意關閉驗證來略過錯誤，應先確認伺服器資料與裝置時間無誤。
測試有結果，但網頁無法開啟
先記下目前的 Global Routing，比較同一請求在 Proxy 與 Config 下的結果。若只有 Config 失敗，請檢查目標命中的規則、策略是否引用可用的伺服器，以及 FINAL 預設規則是否符合預期。若兩種模式都失敗，則再檢查伺服器是否有效、解析狀況與實際存取路徑；即使測試顯示數值，也不能排除這些可能。
DNS 問題與規則問題可能有相似的表現。可搭配錯誤提示與請求記錄，確認是否已解析出位址、是否發生連線逾時，以及是否命中 REJECT。請勿直接用網路上的整段 DNS 設定覆蓋現有檔案；先保存原設定，再針對確認的原因做最小幅度修改。詳細說明請參閱連線與解析疑難排解。
先在 Settings 檢查，避免一次改太多
進入 Settings，可看到 Test Method、On Demand、Diagnostics，以及 Proxy、TCP、UDP 等相關項目。Test Method 會影響測試方式，比較結果時應保持一致；On Demand 與條件式連線有關，手動排查時請先確認它是否會重新觸發連線。請勿將 Settings 中的 Proxy 項目與 Global Routing 的 Proxy 模式混為一談。
若需進一步定位問題，請依 Diagnostics 中實際提供的項目檢查。記錄錯誤發生時間、目前網路、所選模式與重現步驟，比只寫「無法連線」更有幫助。聯絡自己的服務提供者前，請遮蔽訂閱網址、驗證欄位及其他存取憑證，只提供與問題相關的狀態和錯誤資訊。
若另一台伺服器在相同條件下可用，而目前伺服器持續失敗，可先保留可用的測試結果，再向自己既有服務的提供者確認故障目標。若所有目標都異常，請繼續檢查本機網路、系統授權與目前設定。完整問題分類請參閱疑難排解，規則寫法與檔案結構請參閱設定大全；首次匯入、連線與驗證流程至此完成。
