Shadowrocket
快速上手

這個階段的目標是讓 Home 中出現可選取的伺服器項目，暫時不必開啟連線開關。先判斷手邊資料是哪一種：會更新伺服器清單的訂閱連結，或是單一伺服器的協定、位址和連接埠等參數。兩種資料的填寫方式不同，請勿把整個訂閱連結填入 Host，也不要把單一伺服器位址當成 Subscribe 連結。

已有訂閱連結：Type 選擇 Subscribe

進入 Home，點選右上角 + 開啟 Add Server，點選 Type 並選擇 Subscribe。返回新增頁面後，在對應的連結欄位貼上向你的服務商取得的完整連結，再儲存。貼上前後不要加入空格或換行；若連結經由通訊 App 轉傳，請留意是否只複製到顯示文字，或遺漏了末尾的參數。

儲存後返回 Home，等待讀取訂閱內容。成功取得內容後，清單中會出現對應的群組或伺服器項目。先檢查清單是否為空，再確認項目是否可以選取。若只看到訂閱紀錄卻沒有伺服器，請勿急著重複建立相同訂閱；先確認基本網路可用、連結仍有效，以及服務商提供的內容格式是否符合匯入方式。

已有單一伺服器資訊：依協定填寫欄位

同樣從 Home 的 + 進入 Add Server，在 Type 中選擇資料指定的協定。截圖展示的是包含 Host、Port、Password、Method 的新增頁面；其他 Type 的欄位可能不同，請以切換後的實際介面為準。Host 填入伺服器位址，Port 填入連接埠，Password 與 Method 等內容請依現有參數準確填寫，不要自行替換成名稱相似的項目。

若參數還包含 UUID、TLS、傳輸方式或路徑，也請逐項核對。伺服器名稱僅供辨識，不能取代連線參數。頁面中的 Scan QR Code 可用來讀取現有的對應 QR Code；Import from Cloud JSON 是另一種資料匯入方式，不應將任意文字或一般訂閱連結當成該格式匯入。只需選擇符合現有資料的其中一種方式，不必每種方式都操作一次。

進入下一步前：返回 Home，確認 SERVER 中有目標項目，並能明確辨認準備使用的項目。若清單為空，請先停留在本步排查匯入問題，不要試圖透過修改 Global Routing 解決資料未讀入的狀況。

有了伺服器項目後，再決定請求應如何處理。在 Home 點選 Global Routing，先了解設定 (Config)、代理 (Proxy)、直連 (Direct) 這三種模式。這裡選擇的是請求處理方式，不是重新匯入伺服器；切換模式也不會自動修正錯誤的位址、密碼或已失效的訂閱。

• 設定 (Config)：依目前設定檔中的規則決定請求採用哪一種策略，適合已準備好規則、希望區分不同請求路徑的情況。
• 代理 (Proxy)：讓通常由此模式處理的請求使用代理路徑，可用來比對目前選取伺服器的可用性；不能將它理解為所有系統請求都必定經過相同路徑。
• 直連 (Direct)：使用直連路徑。若預期請求應透過代理伺服器處理，請先確認沒有誤選此項。

日常使用 Config 前，請進入底部的 Config，確認目前選取的是預期設定檔。訂閱通常用來提供或更新伺服器清單，設定檔則負責規則及相關設定；匯入 Subscribe 不代表已同時匯入預期規則。截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定編輯區段，初次上手不需要逐項修改。

理解規則時，可以先記住「由上而下比對，依符合的策略處理」。例如 DOMAIN-SUFFIX 用於網域後綴比對，GEOIP 用於相應的 IP 地理資料比對，FINAL 用於前面的規則都未符合時進行最終處理；PROXY、DIRECT、REJECT 是不同的處理策略。這些規則說明了為什麼選取同一台伺服器時，不同請求仍可能採用不同路徑。

先保留現有設定，不要為了測試連線而任意新增 Add Rule，更不要在不清楚用途時啟用 HTTPS Decryption。若要進一步了解模式與比對方式，請閱讀代理模式說明；App Store 取得、正版核驗和帳號問題則整理在正版指南。完成模式選擇後，返回 Home 準備開啟連線。

返回 Home，在 SERVER 群組中選取要使用的伺服器。訂閱群組名稱與實際伺服器項目可能同時出現在清單中，請確認選取的是目標項目，而不是只展開了群組。若剛更新過訂閱，原有項目可能有所變動，連線前請再次確認選取狀態。

確認 Global Routing 後，開啟 Home 頂端的開關。首次連線時，系統可能要求允許新增 VPN 設定；先確認提示來自目前操作中的 Shadowrocket，再依系統要求確認，可能需要輸入裝置密碼或進行身分驗證。授權尚未完成前，請勿連續切換開關。授權結束後返回 App，查看頂端原先的 Not Connected 狀態是否改變，以及開關是否維持開啟。

若開啟後又立即關閉，先檢查系統授權是否完成，再查看是否有明確錯誤提示。此時問題不一定出在伺服器線路：App 尚未建立本機連線設定、系統操作遭取消，或裝置上的連線設定互相影響，都可能導致連線未真正開始。先記下提示原文，不要一次修改多個欄位。

頂端顯示已連線，代表連線設定已啟用，但不能只憑這一點判定伺服器和所有目標請求都正常。伺服器參數錯誤、遠端無法連線或規則選擇不符，都需要進一步驗證才能區分。下一步會分別檢查項目連通性和實際存取結果。

初次上手時，建議暫時保留 On Demand 的現有設定，不要同時新增自動連線條件。這樣在手動切換開關前後，狀態變化會比較容易觀察。若要結束這次檢查，請先在 Home 手動關閉；稍後若又自動連線，再到 Settings 檢查 On Demand 的觸發條件。

排查時請依照「基本網路 → 資料是否正確 → 目前模式 → 特定請求」的順序。每次只變更一項，完成後返回驗證步驟重複相同測試；若結果沒有改善，先還原原值，再檢查下一項。這樣能保留可用設定，也方便說明問題發生在哪個環節。

匯入後沒有伺服器項目

先在關閉連線的狀態下確認基本網路可用，再檢查連結是否完整、Type 是否選為 Subscribe，以及連結是否仍在有效期限內。訂閱狀態和存取限制請向你的服務商確認。不要透過修改 Host 或任意更換連結參數來「修復」訂閱，也不要不斷新增相同紀錄；請先保留一筆方便核對的訂閱，再檢查更新狀態。

有項目，但連線或測試失敗

手動新增的伺服器，請逐項核對 Type、Host、Port 及驗證欄位；需要 TLS 或特定傳輸參數時，也要和現有資料比對。訂閱匯入的項目則先更新並重新選取。確認系統時間正確，並分別比較 Wi-Fi 與行動網路的結果。若只有某個項目失敗，可用現有的另一筆紀錄進行比對，但不要混用名稱相似的參數。

已連線，但只有部分 App 異常

先檢查 Global Routing 與 Config，再確認失敗目標預期符合的是 PROXY、DIRECT 還是 REJECT。若只有特定請求類型異常，請先記錄現象，再檢查相關設定；不要同時調整 DNS、TCP、UDP 等多項內容。Settings 中出現這些設定項目，不代表初次使用時都需要變更；保留已知設定通常更容易找出差異。

自動重新連線或測試結果難以判讀

在 Settings 查看 On Demand，確認是否設有符合目前網路的自動連線條件。手動關閉後又出現連線狀態，請先確認此項，而不是反覆刪除伺服器。測試結果與實際存取不一致時，查看 Test Method，確認目前測試的項目，再於相同網路重新執行一次。

仍無法找出原因時，可以進入 Diagnostics 查看可用的診斷資訊。記錄錯誤原文、發生步驟與可重複的操作即可；對外分享前，請移除完整訂閱連結、驗證資訊、QR Code 及其他個人資料。診斷資訊可用來縮小問題範圍，但不能取代服務商對伺服器狀態的確認。

最後應能將問題歸納至明確環節：資料未讀入、系統授權未完成、伺服器連線失敗，或請求路徑不符。匯入問題請返回第 01 步，規則問題請返回第 02 步；不要在沒有紀錄的情況下從頭修改所有選項。