Shadowrocket 使用教學

開啟 Shadowrocket 後，先停留在 Home，找到 Add Server 或頁面上的新增入口。準備資料時，先分清兩種情況：訂閱連結用於一次匯入一組伺服器；單一伺服器資料則須逐項填寫。兩者用途不同，請勿將訂閱連結填入伺服器的 Host，也不要將伺服器位址當成訂閱連結提交。

已有訂閱：選擇 Subscribe

進入 Add Server，開啟 Type 並選擇 Subscribe，將向自己的服務商取得的完整訂閱連結填入 URL。如需填寫備註，可使用容易辨識來源的名稱。貼上後請確認連結前後沒有空格、換行或缺漏字元，再儲存並等待內容載入完成。連結中的認證參數屬於私密資料，請勿貼到公開討論區，也不要放進展示用截圖。

儲存後返回 Home，查看相應群組中是否出現伺服器。若只有訂閱名稱、沒有伺服器項目，就不能視為匯入成功；請查看頁面提示，確認訂閱內容是否已成功載入。若要更新現有項目，請使用該訂閱群組的更新功能，完成後再確認項目是否有變化。更新訂閱與更新 App 是兩回事：前者讀取自己的訂閱內容，後者透過 App Store 完成。

手動新增：依 Type 核對欄位

若持有單一伺服器資料，請在 Type 中選擇資料指定的協定，再填寫 Host、Port 與認證欄位。截圖展示的是包含 Password、Method 的表單；其他協定可能使用不同欄位，請勿照著截圖填入不存在的參數。位址通常填寫服務商提供的網域或 IP，連接埠填入對應數值，加密方式與認證資料都應逐項核對。

若持有適用的 QR Code，可使用 Scan QR Code 掃描，再確認辨識出的協定與欄位；Import from Cloud JSON 是另一種匯入方式，並不代表任何文字都能讀取。儲存前請確認資料格式與匯入方式相符。若不確定欄位含義，可先查閱術語表；協定參數的詳細說明請參考協定參考，不要反覆猜測填寫來嘗試連線。

新增完成後，在 SERVER 中選取準備測試的項目，確認選取標記位於目標伺服器旁。此時先不要大量修改其他伺服器，也不必急著啟用 On Demand；下一步先確認請求將採用哪種路由方式。

返回 Home，點開 Global Routing。這裡設定連線請求的整體處理方式，不是選擇伺服器協定的地方。先記住三種模式：設定檔 (Config)／代理 (Proxy)／直連 (Direct)。若要依設定檔中的規則分別處理不同網站，請選擇 Config；若只想確認所選伺服器能否處理代理請求，可暫時使用 Proxy；Direct 用於直接連線，不代表正在使用所選的代理伺服器。

使用 Config 時，須搭配目前啟用的設定檔判讀。開啟 Config 頁面，確認實際使用的設定檔，再查看其中的 Rule。匯入訂閱不代表已取得符合需求的分流規則；訂閱中的伺服器項目與設定檔負責不同工作。前者提供連線目標與參數，後者決定請求採用的策略。

先查看現有 Rule，再決定是否修改

官方截圖中的設定編輯頁包含 General、Rule、Hosts 等區段，以及 Add Rule。初次使用時先查看 Rule，不必同時修改每個區段。尤其是 URL Rewrite 與 HTTPS Decryption，並非建立基本連線的必要步驟，不應為了讓開關顯示已連線而隨意啟用或新增內容。

規則會依序比對，因此判斷結果時，須同時查看規則順序與最終策略。以下兩行僅用來說明「指定網域走代理，其餘直連」的寫法，其中 example.com 是教學用網域，並非實際服務位址。若已有適用的設定檔，請先維持原狀進行驗證，避免直接以範例覆蓋現有規則。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

DOMAIN-SUFFIX 在此用來比對網域後綴，PROXY 指定代理策略，FINAL 則是在前面的規則都未命中時作為預設策略。選擇 Config 後，若目標命中 DIRECT，不會因為開啟頂端連線開關就自動改走代理。排查時可暫時切換至 Proxy，比較同一目標的結果；比較後請恢復原本的路由模式，避免長期保留測試設定。

此步只需選對模式，並了解目前使用的設定檔來源。更多規則關鍵字請查閱術語表；若要了解協定參數、傳輸設定與路由規則的差異，請接著閱讀協定參考。接著返回 Home，使用剛才選取的伺服器建立連線。

返回 Home 後，先確認 SERVER 中目前選取的伺服器，再檢查 Global Routing 是否為剛才選擇的模式。伺服器新增成功不代表已選取；若有多個群組，請查看選取標記確認目標，不要只看清單最上方的名稱。確認這兩項後，再開啟頁面頂端的連線開關。

首次建立連線時，系統可能會提示新增 VPN 設定。請確認目前操作來自剛開啟的 Shadowrocket，再依系統提示允許，並完成裝置密碼、Face ID 或 Touch ID 認證。此程序讓 App 透過系統網路延伸功能處理流量，不會取代伺服器認證，也不會自動補上訂閱或密碼。請勿將系統授權成功誤認為遠端伺服器已驗證通過。

曾拒絕授權：重新觸發提示

若先前取消了系統提示，請返回 App 再次嘗試開啟連線，確認系統是否重新要求授權。若仍無法開啟，請前往系統設定中的 VPN 相關頁面查看設定狀態；設定位置可能因系統版本而異，可使用系統設定搜尋。若不確定某項設定的用途，請先確認所屬 App，避免刪除其他仍在使用的設定。

完成授權後返回 Home，確認頂端是否仍顯示 Not Connected，以及開關是否維持開啟。若開關立刻恢復關閉，請先處理 App 顯示的錯誤或系統權限問題，不要連續快速點按。每次操作後等待狀態穩定，並記下錯誤提示的關鍵文字，方便後續判斷失敗環節。

截圖中的 Home 同時包含 Global Routing、Connectivity Test 與 SERVER，可用來確認功能入口的位置。狀態切換成功只代表本機連線流程已建立，無法證明所有網站都能連線，也不能確認請求命中了預期規則。完成此步後，還須執行測試並實際開啟目標，才能判斷設定是否符合使用需求。

首次驗證時，請盡量維持裝置網路穩定，暫時不要同時切換 Wi-Fi、行動網路和多台伺服器。若切換網路後發生問題，先記錄切換前後的狀態，再單獨重試。On Demand 可依條件觸發連線，建議先確認手動連線、斷線與重新連線都正常，再依需求設定。

發生問題時，先歸納具體環節：訂閱載入失敗、伺服器新增後無法連線、連線已開啟但請求失敗，或只有部分目標異常。不要同時刪除訂閱、更換設定檔、調整 DNS 和修改協定參數。保留目前設定，一次只變更一項，再重做第四步的驗證，才能判斷是哪次變更造成影響。

訂閱內容空白或更新失敗

先確認裝置本身可以連上網路，再檢查訂閱連結是否完整，尤其留意複製時是否漏掉認證參數。若現有訂閱失效或內容空白，請向自己的服務商確認有效狀態與支援格式。重複建立相同訂閱通常無法修復載入錯誤，反而容易產生多個難以辨識的群組。更新後請確認伺服器項目確實有所變動，不要只看訂閱名稱仍顯示在清單中。

開關無法維持開啟

先確認系統 VPN 設定是否已獲准，再檢查目前選取的伺服器項目是否有效。若 App 明確提示參數錯誤，請返回 Add Server，對照原始資料核對 Type、Host、Port 與認證資訊。部分協定還有傳輸或 TLS 相關欄位，請依資料要求填寫，不要因名稱相近就互相替代。若需了解欄位之間的關係，請先閱讀協定參考再進行調整。

連線已開啟，但無法依預期完成存取

先檢查 Global Routing。Direct 不會使用所選的代理伺服器；在 Config 模式下，目標可能依規則採用直連或拒絕策略。若記錄顯示命中 REJECT，請確認這是預期的封鎖設定，還是規則範圍過廣，不要直接更換伺服器。只有部分網域失敗時，再分別檢查網域解析、規則比對與目標回應；不要只因單一頁面異常就重設所有設定。

開啟 Settings，查看 Test Method 與 Diagnostics，利用可用的診斷資訊確認失敗環節。頁面中的 Proxy、TCP、UDP 等項目各有用途，並非通用的「修復開關」。若不清楚某個選項會造成什麼變化，請先保留原值，弄清楚用途後再測試。初次使用不必逐一修改所有設定。

回報問題前，整理可重現的條件

記錄裝置網路類型、目前路由模式、問題是否影響所有目標、測試方式，以及錯誤提示中的關鍵文字。分享截圖或診斷內容前，請遮蔽訂閱連結、伺服器認證欄位與其他私密資料，只保留排查所需資訊。比對變更前後同一目標的結果，會比只說「無法連線」更有助於判斷問題。

手動連線與實際瀏覽都穩定後，再考慮設定 On Demand 或更細緻的規則。之後每次更新訂閱、更換設定檔或變更路由，都可依循「確認項目 → 核對模式 → 建立連線 → 驗證請求」的順序。介面詞彙請參閱術語表；購買、重新安裝與已購項目還原問題，請前往App Store 已購項目還原說明，不要與連線參數排查混為一談。