Shadowrocket 首次設定與連線

開啟 Shadowrocket，進入 Home，找到 SERVER 分組和 Add Server 入口。如果目前尚未新增項目，清單為空並不代表安裝有問題，只表示尚未儲存連線資料。接著依現有資料選擇一種方式：有協定、位址、連接埠等個別欄位時，手動新增；有完整訂閱連結時，透過 Subscribe 匯入。首次操作只需完成其中一種方式，不必重複輸入。

已有伺服器資料：依 Type 填寫

點按 Add Server 後，先選擇 Type，再填寫該類型要求的欄位。截圖顯示的表單包含 Host、Port、Password、Method；Host 填入伺服器網域或 IP，Port 填入對應連接埠，Password 與 Method 則依原始資料確認。切換 Type 後，欄位可能隨之變動；請勿將某種協定的欄位套用到另一種協定，也不要只憑名稱猜選項。

逐項複製資料時，請檢查前後空格、換行與標點，尤其確認連接埠與伺服器資料一致。位址欄位通常只需填入主機名稱，不應連同完整網頁路徑一起輸入。不同協定可能還需要 UUID、SNI 或傳輸相關參數，這些資料應以你現有的伺服器資料為準；若缺少欄位，請先向原資料提供者確認，再繼續操作。欄位詳細說明請參閱協定技術參考。

已有訂閱連結：透過 Subscribe 匯入

在 Add Server 中選擇 Subscribe 類型，填入方便辨識的名稱，再將完整訂閱網址貼到對應的 URL 欄位。複製時請保留原網址的查詢參數，不要只截取網域，也不要把訂閱網址填入 Host。儲存後，等待取得訂閱內容，再返回 Home 確認是否出現對應分組或伺服器項目。儲存訂閱記錄不代表已成功取得項目，請以清單中的實際內容為準。

如果現有資料是 QR Code，可使用 Scan QR Code，並在需要時允許存取相機；掃描後仍須檢查辨識出的類型與欄位，再行儲存。Import from Cloud JSON 是另一種匯入入口，與 Subscribe 不同，一般訂閱連結不應填入該入口。請依現有資料的格式選擇對應方式，避免因為「貼得進去」就誤以為「格式正確」。

訂閱網址可能包含存取憑證，請像密碼一樣妥善保管。排查問題時，不要將完整網址貼到公開頁面或截圖中。匯入完成後，先選擇明確要使用的伺服器，再進入下一步選擇 Global Routing；此時暫勿修改進階選項，也不必一次測試所有項目。

返回 Home，點按 Global Routing，確認目前使用的模式。教學中的三種名稱為設定檔 (Config)、代理 (Proxy)、直連 (Direct)，對應介面中的 Config、Proxy、Direct。不要只憑頂端開關是否開啟，就判定請求一定經由所選伺服器；模式與規則仍會影響實際處理路徑。

日常需要依規則處理時，請選擇 Config，再進入 Config 頁面檢查目前使用的設定檔。匯入訂閱主要是取得伺服器清單，不代表已替你選好或設定完成一套規則。若你另有設定檔，請先確認來源與用途，再依 App 內的入口匯入並選擇；若手上沒有現成檔案，先查看目前已有的設定，不要任意覆寫原有內容。

在 Config 中確認 Rule

官方截圖顯示的是設定檔編輯頁，可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段，以及 Add Rule。首次設定時，請優先查看 Rule，確認規則是否符合自己的使用需求。General 等其他區段各有用途，完成首次連線不必逐一修改，也不需要同時啟用所有進階功能。

規則由上而下比對，命中第一條後便停止。PROXY 表示交由對應的代理策略處理，DIRECT 表示直接連線，REJECT 表示拒絕；前面的規則都未命中時，FINAL 是最後套用的預設項目。較精確的例外規則通常應排在適用範圍較廣的規則之前。若只想完成初次驗證，保留現有設定並記下原始內容即可，暫時不必新增大量自訂規則。

若要區分伺服器問題與規則問題，可暫時選擇 Proxy 作為比較，再存取同一個目標；測試後恢復原本預計使用的模式。這種比較方式不適合作為長期設定建議；同一次比較也不要更換伺服器、規則與網路，否則無法判斷單一原因。規則排列的詳細說明請參閱規則順序與 FINAL 預設策略。

完成前兩個步驟後返回 Home，在 SERVER 分組中點選本次要使用的伺服器，並確認所選項目符合預期。訂閱下有多個項目時，請勿把分組名稱當成目前使用的伺服器名稱；應確認實際選取的項目。若看不到任何可選項目，請返回第一步檢查匯入結果，不要反覆開關連線。

接著再次查看 Global Routing。確認伺服器與模式後，開啟 Home 頂端的開關。官方截圖中的 Not Connected 表示截圖拍攝當時尚未連線，不是需要輸入的內容。啟動時請留意狀態變化；若開關立即關閉或出現錯誤，先記下提示，不要連續快速切換開關，才能更容易判斷問題發生在哪個階段。

首次連線時確認系統授權

首次啟動時，系統可能會提示新增 VPN 設定。這是系統允許 App 建立相應網路連線所需的授權步驟，與驗證既有伺服器帳號不同。確認發起 App 為 Shadowrocket 後，依系統提示確認；若系統要求驗證裝置身分，請依裝置本身的驗證流程完成。未確認授權時，App 通常無法建立連線。

若剛才取消了授權，可返回 Home 再次嘗試開啟連線，並留意系統提示。若裝置受管理政策限制，請依裝置管理要求處理，不要藉由修改無關設定來規避限制。同時留意裝置上是否有其他正在建立的 VPN 連線，以免將連線切換造成的變化誤判為伺服器故障。

完成授權後返回 Home，等待連線狀態穩定，再進行驗證。系統顯示連線已建立，只代表本機連線流程已進入相應階段，無法保證遠端驗證、目標存取與規則運作都正確。此時先不要變更 App 設定，使用下一步的測試分別確認這些環節。

訂閱沒有項目：先檢查輸入資料與取得條件

如果已儲存 Subscribe，但 Home 沒有出現預期項目，請先確認 URL 是否完整，是否包含空格、換行或說明文字，再確認目前網路是否能取得訂閱內容。訂閱網址能在瀏覽器中開啟，不代表傳回的內容一定適用於目前的匯入方式；若顯示的是登入頁面或錯誤說明，也無法解析成伺服器清單。網址狀態、有效期限與內容問題，請向你現有服務的資訊提供者確認。

已新增伺服器但無法連線：檢查資料與授權

手動新增時，返回項目編輯頁，逐一比對 Type、Host、Port 與驗證欄位。特別留意協定類型選錯、連接埠填錯、密碼複製不完整，以及 TLS 相關名稱與原始資料不符。不要為了「先連上」而任意關閉憑證驗證；遇到憑證提示時，應先檢查裝置時間、伺服器名稱及設定是否一致。若開關無法維持開啟，請確認是否已授權系統設定 VPN。

測試與存取結果不同：確認 Test Method

進入 Settings 查看 Test Method，確認 Connectivity Test 目前採用哪種方式判定結果。測試目標、連接埠是否可達及實際網頁存取，是不同層次的驗證，不應將測試結果視為速度保證。官方截圖中的 Settings 還包含 Diagnostics、Proxy、TCP、UDP 等項目，分別用於不同設定或診斷；本次排查只需進入與問題相關的項目，不要逐一嘗試不熟悉的開關。

只有部分目標異常：檢查規則與 DNS

若 Proxy 模式正常、Config 模式異常，請先檢查 Rule 的比對順序、目標是否命中 REJECT，以及是否被範圍較廣的 DIRECT 規則提前匹配。若出現網域無法解析的提示，則另外檢查 DNS 設定；更換伺服器不一定能解決名稱解析問題。規則與協定概念詳見技術參考；目前先還原到能重現問題、也方便比較的最精簡設定。

設定持續變動：留意 On Demand

Settings 中的 On Demand 與連線觸發條件有關，不等同於 Global Routing 的規則策略。若網路切換後，連線出現非預期的啟動或狀態變化，請檢查是否啟用了相關條件，並記下原設定後再進行比較。初次使用時，若尚未確認手動連線正常，先不要新增自動觸發條件，以免無法判斷變化是來自伺服器、規則還是觸發設定。

若需使用 Diagnostics，請保留錯誤提示、發生時間與重現步驟。分享診斷資訊前，請移除訂閱網址、密碼、驗證資料及個人存取記錄；保留錯誤類型與必要背景資訊即可。不要一開始就清除所有設定，否則往往也會失去有用的比較依據。

若以上檢查仍無法找出問題，請前往疑難排解，依「匯入失敗、連線失敗、部分存取失敗」等實際階段繼續查找。結束本次排查前，請還原暫時修改的 Global Routing 或測試設定，並再次存取目標確認結果。之後每次調整都依照「記錄原值 → 修改一項 → 重新驗證」的順序進行。