Shadowrocket 入門指南

已有訂閱連結：選擇 Subscribe

開啟 Shadowrocket 的 Home，找到 Add Server，進入後點選 Type，再選擇 Subscribe。將已有的訂閱連結完整貼到對應的 URL 欄位，填寫方便自己辨識的備註後儲存。此處需要的是可回傳訂閱內容的連結，而非服務商的登入頁面或介紹頁面。連結末端的參數可能用於驗證，複製時請勿刪除，也不要額外加入引號、空格或換行。

儲存後返回 Home，檢查 SERVER 中是否出現訂閱群組和伺服器項目。如果 App 顯示請求失敗，或只出現群組但沒有項目，請先不要繼續連線。確認連結仍有效、內容格式可供辨識，以及目前網路能否取得訂閱內容。取得訂閱和連線至伺服器是兩個不同環節；訂閱儲存成功，不代表其中每台伺服器都能連線。

之後更新訂閱時，請使用對應群組的更新功能，更新後重新確認目前的選擇。遠端內容可能會變更項目名稱或移除舊項目，因此請確認先前選取的伺服器仍然存在。為免難以辨識，首次操作不必重複匯入同一個連結；先確認一個群組，再管理其他設定。

已有單一伺服器：先確認 Type

如果取得的是一組位址、連接埠和驗證欄位，而非訂閱連結，請在 Add Server 的 Type 中選擇與伺服器實際使用的協定相符的選項。接著填寫 Host、Port，以及該協定要求的 Password、Method 或其他驗證欄位。截圖僅呈現一種欄位組合，不能據此認定所有協定都使用相同欄位。Type 選錯時，即使位址和密碼正確，也可能無法建立有效連線。

Host 請填入伺服器提供的主機名稱或位址，Port 則填入對應的連接埠；不要將完整網頁網址直接填入 Host。Password、金鑰等內容通常區分大小寫，貼上後請檢查前後是否有空格。只有在相應協定需要時，才依原始資訊選擇 Method，不要只憑名稱相近來猜測。遇到 TLS、SNI、傳輸方式等額外欄位時，請依原始設定填寫；不熟悉的欄位可參閱名詞速查，協定參數的設計取捨則請參閱協定詳解。

若有受支援的 QR Code，可使用 Scan QR Code，並依系統提示授予相機權限。Import from Cloud JSON 是另一種輸入方式，不要將一般訂閱連結直接當成對應的 JSON 位址使用。無論採用哪種方式，儲存後都請返回 Home，確認項目名稱和類型符合預期。確認清單中已出現伺服器後，才能進行下一步；這只代表資訊已儲存，尚未驗證連線。

返回 Home，點選 Global Routing，先查看目前選取的項目。入門時請先分清三種模式：設定（Config）／代理（Proxy）／直連（Direct）。不要只看連線開關的狀態，就判定請求一定經過哪條路徑；模式不同，即使選擇同一台伺服器，存取行為也可能不同。

設定（Config）：依目前規則處理

選擇設定（Config）時，App 會依據目前設定中的規則處理請求。進入 Config，確認已選取準備使用的設定檔，再查看 Rule 中是否有符合需求的規則。設定檔除了可能包含規則，也可能包含 DNS 等設定，因此匯入伺服器訂閱和選擇規則設定是兩件不同的事。已有訂閱不代表已取得適合自己的完整規則設定。

截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定編輯頁面中的不同區段。首次連線不必逐一啟用或修改。尤其不要為了讓一般連線正常運作而隨意調整 HTTPS Decryption；這並非基本連線的必要步驟。若只想確認規則，請先查看 Rule，了解內容後再使用 Add Rule；編輯前請保留原始設定，以便還原。

規則關鍵字須保留原文。例如 DOMAIN-SUFFIX,example.com,PROXY 表示比對指定的網域後綴並採用對應處理方式；FINAL,DIRECT 則是在未符合前面規則時使用的一種預設處理方式。這些片段僅供辨識語法，並非建議直接覆寫個人設定。規則順序、處理方式與目前使用的伺服器都會影響結果。遇到不熟悉的關鍵字，請先查閱說明，不要只複製單一規則，就期待取得完整設定。

代理（Proxy）與直連（Direct）：用來區分連線路徑

代理（Proxy）會透過代理路徑處理請求，排查時可用來確認已選取的伺服器是否能正常供實際存取使用；直連（Direct）則透過直連路徑處理請求，可用來比較本地網路的狀況。兩者是路由方式，不會新增伺服器，也不會替你修正錯誤的驗證資訊。排查完成後，請切回實際需要的模式，不要長期保留暫時測試的設定。

首次操作時，可以先釐清自己的需求：已有可信的規則設定並希望依規則處理，就選擇 Config 並確認目前使用的設定；若只想區分伺服器路徑和本地路徑，可分別在 Proxy 和 Direct 下進行相同的存取測試。每次只切換一個選項，並記下目前的選擇，避免同時更換伺服器、規則和 DNS，導致無法判斷是哪項設定造成變化。準備就緒後返回 Home，進入連線步驟。

在 SERVER 選取要使用的項目

返回 Home，在 SERVER 中點選這次要使用的伺服器，確認選取標記位於預期的項目上。如果剛更新過訂閱，請特別確認目前選取的項目是否有所變動。伺服器名稱只是方便辨識的標籤，無法證明位址、驗證資訊和遠端狀態正確；首次測試請盡量固定使用一個項目，避免在不同項目間來回切換。

接著確認 Global Routing 顯示的目前模式。若要使用 Config，請確認前一步已檢查設定檔；若正在使用 Proxy 或 Direct 進行比較測試，請記下這次測試的模式。確認後開啟 Home 頂端的開關。尚未連線時，截圖中的頂端區域會顯示 Not Connected；開啟後請等待 App 更新連線狀態，不要快速連續點按開關。

確認系統提示後完成授權

首次建立連線時，系統可能會詢問是否允許新增 VPN 設定。這項權限可讓 Shadowrocket 依照所選設定處理裝置的網路請求。確認提示對應的是 Shadowrocket 後，選擇允許，並依系統指示完成身分驗證。如果暫時拒絕或取消，這次連線可能無法繼續；返回 App 重新發起連線，再確認系統提示即可，不必因此重新匯入訂閱。

授權不代表購買了伺服器服務，也不表示伺服器已通過驗證。系統顯示 VPN 狀態，只能說明相關連線或設定已啟用，不能據此判定所有頁面都能正常存取。若先前使用過其他 VPN 設定，請先確認是否仍有運作中的設定或系統管理限制；不了解用途時，請勿刪除由工作或學習環境管理的項目。

狀態穩定後再開始存取

返回 Home，觀察頂端的連線狀態是否維持穩定。若開關立即關閉、反覆嘗試或出現錯誤提示，請先保留提示內容，前往最後的故障排查章節處理，不要繼續疊加修改。若狀態穩定，可先執行 Connectivity Test，再開啟平時需要使用的目標頁面。iPad 也依照相同步驟操作；控制項位置以目前 App 版面為準，重要介面名稱維持一致。

首次建立連線前，建議先讓 On Demand 維持在明確且可控制的狀態，不必急著新增按需條件。確認手動連線、斷線和驗證都能重現後，再了解自動觸發條件。如此一來，遇到連線自行恢復時，便能分辨是手動操作的結果，還是按需功能所致，減少排查時的變數。

訂閱匯入失敗：先確認能否取得內容

若在匯入或更新階段失敗，請先檢查 URL 是否完整、訂閱是否仍有效，以及目前網路能否連上訂閱網址。若回傳的是登入頁面、錯誤頁面或不支援的內容，即使瀏覽器能開啟該網址，也不代表 App 能將其辨識為訂閱。請勿將完整連結提供給不熟悉的檢測頁面；訂閱連結本身可能含有存取憑證。若需確認內容狀態，請向既有服務商查詢，不必先修改所有連線設定。

清單有伺服器但無法連線：確認欄位與權限

清單中有項目但連線失敗時，請先確認 Type、Host、Port 和驗證欄位，再檢查該協定要求的額外參數。不要隨意更換 Method、TLS 或傳輸方式來碰運氣。若設定來自訂閱，請先更新並確認項目仍有效；若是手動輸入，請逐項核對原始資訊。尚未完成系統 VPN 授權時，請返回連線步驟處理權限；若是驗證錯誤，則應檢查伺服器欄位，而非反覆申請權限。

連線穩定但無法開啟頁面：區分 DNS 與規則問題

連線維持正常但無法開啟目標時，請使用相同目標比較 Proxy 和 Config 的結果。如果只有 Config 異常，請檢查目前選取的設定是否正確、Rule 是否將目標交由不適合的方式處理，以及 DNS 是否能完成解析。網域解析失敗和遠端連線失敗是不同環節，不要一遇到逾時就同時修改 DNS、規則和伺服器。更多名詞說明請參閱DNS 與網路術語，常見狀況則請參閱常見問答與故障排除。

若只有部分頁面或 App 出現異常，記錄具體目標和發生條件，會比籠統地說「全部都無法連線」更有幫助。若所有測試都異常，請先確認本地網路本身可正常使用，再透過另一個有權使用的網路進行比較。切換網路會改變測試條件，因此切換後請重新記錄結果，不要混用上一輪的測試結論。

測試結果不一致或連線自行恢復：檢查 Settings

進入 Settings，先查看 Test Method，確認 Connectivity Test 使用的方法，再比較相同方法下的結果。On Demand 可能依條件觸發連線；如果手動斷線後又重新連線，請檢查現有的按需條件，不要只是不斷關閉開關。首次排查時，請先確認手動操作能穩定重現，再設定自動行為。

若要進一步找出問題，可查看 Diagnostics 中目前提供的診斷項目。Settings 中的 Proxy、TCP、UDP 等設定與實際連線行為有關，但並非通用的「修復按鈕」。請保留預設值或已驗證的設定，只有在了解原因時才進行調整。每次變更後都重複相同測試；若沒有改善，請還原原值，避免累積難以追查的修改。

保留必要記錄，並遮蔽敏感資訊

記錄問題時，只需保留故障發生步驟、目前模式、協定類型、錯誤提示，以及「本地網路是否可用、其他項目是否也失敗」等判斷資訊。分享截圖或診斷內容前，請遮蔽完整訂閱 URL、驗證參數、Password、金鑰和個人位址。請勿為了尋求協助而公開整份設定檔。

至此，首次操作的完整流程為：資訊已儲存、模式已確認、權限已完成、實際存取已驗證。若問題仍未解決，請依故障環節繼續閱讀常見問答；需要了解不同協定參數時，再參閱協定詳解。入門階段不必一次修改所有進階設定。