Shadowrocket 快速入門
訂閱匯入與首次連線
先將現有資料加入 Home，再選擇 Global Routing，最後連線並驗證。首次設定請依序完成；遇到問題時，回到第一個未通過的步驟檢查。
畫面截圖取自 App Store 官方素材，供辨識頁面與欄位之用。App 內的實際版面可能有所調整，操作時請以目前介面上的用語為準。
Add Server / Subscribe：加入現有資料
訂閱連結與單一伺服器資料擇一匯入即可，不必重複加入相同內容。
開啟 Shadowrocket 後，先停留在 Home，暫時不要開啟連線開關。確認手邊資料的形式：若是用來更新伺服器清單的訂閱連結，請使用 Subscribe；若有伺服器位址、連接埠、協定類型與驗證資料，請手動輸入。這兩種方式都只是匯入資料，並不代表已建立連線，也無法自動確認服務是否可用。
手動填寫 Add Server
在 Home 點選右上角的新增按鈕，或清單中的 Add Server，進入新增頁面。先點選 Type，選擇與現有資料相符的協定，再填寫其他欄位。順序很重要：變更 Type 後，需要填寫的欄位也可能不同，因此不要先照著截圖填完，再任意切換協定。
Host 填入伺服器位址，Port 填入服務提供者給的連接埠。Password、Method 或其他驗證欄位，請依選取的 Type 與原始資料核對。截圖僅展示其中一種填寫頁面，並非所有協定都只有這些欄位。若資料還包含 TLS、傳輸方式或其他選項，也要一併確認；切勿以猜測值補上缺少的資訊。
儲存前請檢查位址前後是否多了空格、連接埠是否抄錯，以及驗證資料是否完整。儲存後返回 Home，確認 SERVER 清單中已出現對應項目。備註方便辨識，但備註文字本身不會決定連線方式；名稱相同也不代表使用相同的伺服器資料。
使用 Subscribe 匯入現有訂閱
若有訂閱連結，請在 Add Server 的 Type 中選擇 Subscribe，將完整連結貼到頁面顯示的 URL 欄位，再儲存。連結請向自己的服務提供者取得，不要把網頁介紹頁的網址當成訂閱連結，也不要刪除連結尾端的參數。返回 Home，等待訂閱請求完成，再確認是否出現伺服器清單。
匯入成功後，先展開對應群組，選取一個能辨識的項目，繼續後續步驟。若只看到訂閱名稱，沒有伺服器項目，請先檢查更新結果，不要反覆新增相同連結。訂閱更新用於重新取得清單；手動新增的伺服器則須依原始資料維護。更換匯入方式前，請保留一份自己的原始資料，避免誤刪後無法還原。
頁面底部的 Scan QR Code 與 Import from Cloud JSON 是其他匯入方式，只有在你已有相應格式的資料時才使用。首次連線不必把所有匯入方式都試一遍。訂閱連結與 QR Code 可能包含驗證資料，請勿直接公開截圖；名詞差異請參閱術語表中的訂閱與設定說明。
繼續條件：Home 中已有可選取的伺服器。接下來選擇請求的路由處理方式。
Global Routing：選擇處理方式
本頁統一使用設定(Config)、代理(Proxy)、直連(Direct)等名稱，括號內為 App 介面上的用語。
返回 Home，點選 Global Routing 查看目前的選擇。這裡決定請求的處理方式，與是否已新增伺服器是兩回事。匯入資料後若未確認這項設定，可能會遇到清單內容正常、連線開關也已開啟，但實際存取路徑不如預期的情況。
| 模式 | 處理方式 | 首次設定時的用途 |
|---|---|---|
| 設定(Config) | 依目前設定檔中的規則與相關設定處理請求。 | 使用現有規則方案前，請確認已選取所需檔案。 |
| 代理(Proxy) | 透過代理方式處理請求。 | 暫時用來確認所選伺服器是否能處理實際存取。 |
| 直連(Direct) | 透過直接連線方式處理請求。 | 用來確認目前網路能否直接存取目標。 |
使用 Config 前先確認設定檔
若已有需要使用的設定檔，請開啟底部的 Config，檢查檔案清單與目前選取的項目，再開啟檔案檢視內容。設定編輯頁面依 General、Rule、Hosts 等區段編排；Add Rule 用於新增規則。初次使用時，先確認選對檔案即可，不必為了連線而修改每個區段。
訂閱與 Config 檔案並不相同。訂閱通常用來提供伺服器清單；Config 檔案則負責規則與相關處理設定。匯入訂閱後，不應因此認定已切換至某個指定設定檔。若現有檔案包含策略或群組參照，也要確認它們能對應到實際可用的伺服器。這裡要確認的是「目前使用哪一份」，而不是「清單中是否曾儲存過某一份」。
設定(Config)會依規則決定處理方式，因此某個請求可能使用 PROXY，另一個請求則可能使用 DIRECT 或 REJECT。規則順序也會影響結果，不能只因檔案中有某條規則，就認定它一定會套用。首次連線時先保留現有設定；複雜規則的含義可參閱規則關鍵字術語表。
使用 Proxy 進行一次可控比較
若暫時沒有明確的規則方案，或想先區分伺服器問題與規則問題，可以先記下原本的 Global Routing 選擇，再暫時切換至代理(Proxy)，接著進行連線測試。驗證後請恢復日常使用的模式。不要把暫時測試的選擇當成永久設定，也不要以直連(Direct)下可正常存取的結果，證明代理伺服器可用。
繼續條件：已確認目前使用 Config、Proxy 或 Direct；若使用 Config，也能確認目前選取的檔案。
Home：選取伺服器並連線
先選取伺服器，再開啟頂端的連線開關；首次連線還須完成系統 VPN 設定授權。
選好路由方式後返回 Home，在 SERVER 清單中點選要使用的伺服器，並確認選取標記。不要把開啟編輯頁與選取伺服器混為一談：編輯頁用來修改資料，清單中的選取項目才是本次連線要確認的對象。若有多個群組，請先確認所選項目屬於預期的群組。
接著開啟 Home 頂端的連線開關。尚未連線時會顯示 Not Connected。首次建立連線時，系統可能會提示新增 VPN 設定；這是讓 App 建立系統網路隧道所需的授權步驟，不是購買流程，也不會自動補上伺服器資料。確認要求由 Shadowrocket 發出後，依系統提示允許，並完成裝置要求的驗證。
完成系統操作後返回 Home，查看頂端狀態是否從未連線變為已連線。若取消授權，請重新發起連線並查看提示，不要立即刪除訂閱。若裝置受組織管理，且相關設定無法操作，請先確認裝置管理限制；反覆切換 App 內的開關無法取代系統層級的授權。
在 iPhone 與 iPad 上，這一步的確認項目相同：所選伺服器、Global Routing 與連線狀態。螢幕較寬時，清單排列可能不同，但不必重新輸入另一套伺服器資料。切換 Wi-Fi 或行動網路後，連線狀況也可能改變；首次測試時盡量維持相同的網路環境，避免將網路變化誤認為設定變更。
連線狀態出現後，先不要繼續調整多個選項。系統顯示 VPN 狀態，只能代表隧道已建立，不能單獨證明遠端伺服器驗證成功、所有目標都能存取，或每條規則都已依預期處理。保持目前的伺服器與模式不變，進入下一步實際驗證，這樣發生問題時才有明確的比較基準。
繼續條件：已完成系統授權，Home 顯示已連線；並已確認伺服器與 Global Routing 的選擇。
Connectivity Test：驗證實際結果
請分別確認「隧道已建立」、「測試通過」與「實際存取符合預期」，不要以單一結果取代所有判斷。
保持連線開關開啟，在 Home 點選 Connectivity Test，等待 App 顯示本次測試結果。若測試失敗，先記下目前的網路、伺服器、Global Routing 與結果提示，再進行修改。清單測試與 Connectivity Test 都是診斷線索；兩者使用的測試目標與方法可能不同，不能只憑某次測試結果就對所有網站下結論。
再進行一次實際存取
切換至需要使用的 App 或瀏覽器，前往實際要確認的內容，檢查新的請求是否能完成。不要只看已開啟的舊頁面：頁面快取可能讓結果看起來正常，但實際上並未建立新的連線，無法據此判斷。可以重新載入目標頁面，或執行一項明確需要連網的操作，並確認是否完整完成。
若 Connectivity Test 通過，但實際目標仍無法存取，請先查看 Global Routing。在設定(Config)模式下，目標可能依規則使用 DIRECT、PROXY 或 REJECT；切換至代理(Proxy)比較，有助於判斷是否與規則有關。切換前先記下原設定，每次只變更這一項，並以同一個目標重新測試，完成後恢復所需模式。單一目標失敗也可能與目標服務本身有關，不能據此判定整體連線不可用。
記下可重複執行的檢查順序
首次成功後，記住「選取伺服器 → 確認模式 → 開啟連線 → Connectivity Test → 實際存取」的順序。日後更新訂閱或更換網路時，也依照相同順序驗證；比起同時變更協定、DNS 與規則，這樣更容易找出問題。若需記錄設定，只記下必要的選項與結果，不要將完整訂閱連結或密碼寫入公開筆記。
若只想了解 PROXY 與 DIRECT 的差異，請參閱術語表；若要追查特定規則、DNS 或某個 App 的異常，請前往問題診斷，依症狀繼續排查。本頁的驗證標準是所需的實際存取能依預期運作，而不是所有測試項目都必須呈現相同結果。
Settings：依失敗環節排查
先檢查資料與網路，再檢查連線與規則。每次只變更一項，變更後以相同目標重新測試。
訂閱未產生伺服器清單
返回訂閱項目，確認 URL 是否完整、是否貼上了網頁網址，以及原始連結是否仍在有效期限內。訂閱必須先透過目前的網路取得內容；清單為空時，沒有可供下一步使用的伺服器。查看更新提示後，再向自己的服務提供者確認連結狀態與內容格式，不要反覆建立相同訂閱。訂閱更新成功，只代表已成功取得清單，不代表其中每台伺服器都已通過連線驗證。
開關自動關閉或無法建立連線
先確認是否已完成系統授權，再確認 Home 中已選取伺服器。檢查 Type、Host、Port 與驗證欄位是否符合原始資料；若伺服器端要求額外的傳輸或 TLS 參數，也要完整填寫。保留原值後逐項修正，避免同時變更多個欄位。若目前另有 VPN 連線，請先停止該連線，再重新測試 Shadowrocket，以排除系統連線狀態互相衝突的影響。
測試逾時或結果不一致
開啟 Settings，確認 Test Method。不同方法檢查的環節可能不同；遇到逾時時，請一併參考實際存取結果，不要直接刪除伺服器。也可以在另一個可用的網路中使用相同伺服器重新測試，但切換網路後須再次確認連線狀態。若在同一網路中持續失敗，請先保留錯誤提示，再核對伺服器資料與服務狀態。
連線後部分內容無法使用
先短暫切換至 Global Routing 的代理(Proxy)進行比較。若 Proxy 正常而設定(Config)異常，請優先檢查目前的設定檔、規則順序與策略參照。若兩種模式都失敗，請優先回頭檢查伺服器與網路，不要立刻大幅修改規則。DNS 等問題須依具體錯誤進一步判斷，完整流程請參閱問題診斷中的依症狀排查。
關閉後又重新連線，或設定變更難以判斷
在 Settings 檢查 On Demand 是否已啟用，以及其條件是否符合目前的網路。按需連線可能讓手動關閉後的狀況較難觀察；首次排查時可先記下原設定，暫時停用相關條件，完成比較後再恢復。不要為了維持連線而直接修改 Proxy、TCP、UDP 下的所有選項；這些設定應依具體問題調整。
Diagnostics 可用來進一步查看診斷線索。準備向自己的服務提供者回報時，請說明問題發生在訂閱更新、建立連線或實際存取階段，並提供已完成的比較結果。分享任何記錄前，先移除伺服器驗證資料、完整訂閱連結與其他個人資訊。這樣既能保留排查所需資訊，也不會透過截圖公開存取資料。
完成標準：現有資料可正常使用，連線與實際存取結果符合預期。日常使用時依需求選擇模式；遇到明確問題後，再調整進階設定。
