首次連線時，請確認已選取伺服器、系統允許新增 VPN 設定，且連線測試與實際使用結果都符合預期。本文適用於已有服務商與訂閱的 iPhone、iPad 使用者，依序操作 Home → Global Routing → 連線開關 → Connectivity Test，並說明「開關已開啟」、「測試有結果」和「目標 App 可用」是三種不同的判斷。
一、先準備伺服器資料，客戶端購買不等於連線服務
Shadowrocket（小火箭）是 Apple 平台上的付費客戶端，唯一取得管道為 App Store。安裝前可前往正版核對頁確認官方圖示、開發者 Shadow Launch Technology Limited 與 App ID 932747118。本文主要說明 iPhone、iPad 的首次連線，系統需求請以 App Store 頁面標示為準。
客戶端買斷 ≠ 線路服務方案。本網站不提供、不販售也不推薦節點或訂閱。開始前，請先備妥自己的服務商與可用訂閱，或完整的伺服器連線參數。單純完成購買與安裝，不會讓 Home 清單自動出現可連線的伺服器。
- 已有訂閱：在 Home 點右上角「+」進入 Add Server，將 Type 設為 Subscribe，輸入自己的訂閱網址並儲存；更新完成後，確認清單中是否出現伺服器項目。
- 已有單一伺服器：在 Home →「+」→ Add Server 中，選擇服務商指定的 Type，並依原始資料填入 Address、Port 及相應的驗證欄位。
- 確認協定：Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 所需欄位各不相同。請勿只憑伺服器名稱猜測 Type，也不要將某種協定的密碼填入另一種協定的驗證欄位。
- 妥善保管憑證：訂閱網址、Password、UUID 和金鑰可能具有服務存取權限。回報問題時請遮住這些資料，只保留協定類型、問題現象與錯誤訊息即可。
二、在 Home 選定預設伺服器，再完成系統授權
匯入完成後，先點選 Home 中準備使用的伺服器項目。查看資訊或編輯參數，與選定預設伺服器是兩回事；請以清單目前的選取標記為準。若訂閱中有多個名稱相同的項目，也要確認所屬群組，避免測試的項目與實際選取的項目不同。
選取伺服器
進入 Home，點選一個已有的伺服器，確認選取標記顯示在該項目上。首次測試期間請固定使用這個項目，不要同時切換多個候選項目。
確認路由
前往 Home → Global Routing，記下目前模式。若要先排除規則的影響，可暫時選擇 Proxy；若已有確認過的設定，也可使用 Config，但要先了解測試目標會符合哪一條規則。
開啟連線
返回 Home，開啟頂端的連線開關。首次連線時，系統可能會要求新增 VPN 設定；確認這是由目前操作觸發的要求後，選擇允許，並依裝置提示完成驗證。
檢查連線狀態
完成授權後返回 Home，確認開關與連線狀態是否維持開啟，不要只看點擊當下的短暫變化。若開關立刻關閉，請先處理系統授權或連線錯誤，不要直接開始調整規則。
執行連線測試
在 Home 使用 Connectivity Test，查看目前測試方式下所選伺服器的結果；接著開啟實際需要使用的網站或 App，確認實際連線也能完成。
系統授權表示允許建立 VPN 設定，不代表服務商驗證已成功。裝置顯示 VPN 狀態，也不能單獨證明伺服器驗證、TLS 握手、DNS 解析與目標存取都正常。請繼續完成下文的測試流程。
三、認識 Global Routing 的四種模式
Global Routing 會決定連線建立後，如何處理進入隧道的流量。初次排查時，應盡量減少變因：若還不確定規則會套用哪種策略，先用 Proxy 測試所選伺服器，再返回 Config 檢查日常分流設定。此處的建議僅適用於首次連線排查，不代表所有情境都應長期使用同一模式。
Proxy
建議讓進入隧道的流量依代理模式處理，先用來確認所選伺服器，減少 Config 分流規則對判斷的影響。但這不能取代正確的伺服器驗證與傳輸參數。
適用情境：首次連線排查、暫時排除規則變因。
Config
依目前啟用設定中的規則決定處理方式。規則可指定 DIRECT、PROXY 或設定中定義的策略，不能簡化成「所有網域都透過所選伺服器」。
適用情境：已確認 Config 的日常分流設定與規則測試。
Direct
以直連方式處理。此時網站能開啟，只能表示直連路徑可能正常，不能據此確認已使用預設伺服器。
適用情境：對照基本網路狀況，區分直連與代理路徑。
Scene
依已設定的場景處理。結果取決於實際場景與符合條件；尚未設定或確認的場景，不適合作為首次測試的固定基準。
適用情境：已有明確的場景設定，並能確認目前符合結果。
四、查看 Connectivity Test，別把延遲當成完整結論
在 Home → Connectivity Test 中確認目前的測試方式，再查看清單中對應項目的測試結果。不同測試方式驗證的範圍不同：TCP 探測主要反映與伺服器位址及連接埠的連線狀況；透過代理進行的測試，還會涉及相應協定與測試目標。比較結果前，請確保伺服器、測試方式和目前網路都相同。
| 顯示的狀況 | 可以代表什麼 | 下一步 |
|---|---|---|
| 顯示毫秒數值 | 目前測試方式完成了一次測量，不代表所有目標都能存取。 | 保持選取該伺服器，再測試實際網站或 App。 |
| 出現 timeout | 在測試等待時間內未收到所需回應，單憑這一點無法判定故障環節。 | 確認位址、連接埠與目前網路，並在相同條件下重試。 |
| TCP 有結果，實際存取失敗 | 連接埠可以連線，但驗證、協定握手、DNS 或目標路徑仍可能有問題。 | 檢查 Type、驗證欄位、TLS 與傳輸參數，再檢查路由。 |
| 一個項目失敗，其他項目成功 | 問題較可能集中在該項目或其伺服器端路徑，但仍須確保測試條件相同。 | 單獨檢查該項目，不要同時修改所有伺服器。 |
延遲較低不代表頻寬有保障，單次成功也不代表持續可用。測試目標與實際 App 使用的網域、連線方式和伺服器可能不同。若測試成功但 App 仍無法使用，請記錄該 App 的問題現象並繼續排查，不要反覆挑選延遲數值最低的項目。
分開驗證：測試請求與實際請求
Connectivity Test
- 固定使用一台伺服器和一種測試方式。
- 記錄結果是數值、timeout 或其他原始訊息。
- 切換 Wi-Fi 與行動網路時重新測試，不要混用兩次結果。
實際網站或 App
- 保持連線，再重新發出請求。
- 區分網頁載入、登入與媒體載入失敗。
- 在 Config 中確認目標實際符合的規則與策略。
測試與實際存取都符合預期，才算完成首次連線驗證；兩者不一致時，請依失敗環節繼續檢查。
五、連線失敗時，先檢查這三項
第一項：系統授權與連線是否維持
若 Home 開關無法維持開啟，先確認首次 VPN 設定要求是否已允許，以及裝置是否受到管理政策限制。若裝置上還有其他正在使用的 VPN 設定，請先確認目前生效的是這次建立的連線。不要把「系統不允許建立連線」誤當成伺服器延遲問題。
- 返回 Home，重新觸發一次連線並完整閱讀提示，不要快速連續切換開關。
- 前往系統設定檢查 VPN 狀態，確認沒有切換到其他設定。
- 若連線會自動重新建立，請檢查 Settings → On Demand 中目前的啟用狀態與條件；先記下原設定，再決定是否暫時關閉以手動測試。
第二項：所選伺服器與訂閱參數
若連線狀態能維持，但測試失敗，請確認目前選取的具體項目。訂閱更新可能會變更伺服器位址或驗證參數；更新已有的訂閱後，請確認該項目仍存在且已正確選取。更新訂閱與切換 Config 檔案是兩種不同操作，前者不會自動修正後者的規則問題。
- 確認 Add Server 中的 Type、Address、Port 與服務商提供的原始資料一致。
- 確認 Password、UUID 或金鑰等欄位符合該協定，不要跨協定套用參數。
- 使用 TLS 時，確認服務商要求的伺服器名稱；使用特定傳輸方式時，確認相應的路徑與主機欄位。
- 不要透過關閉憑證驗證來掩蓋握手錯誤，也不要在原因未明時批次修改所有項目。
第三項：Global Routing、規則與 DNS
若使用 Proxy 時實際存取成功，但切換至 Config 後同一目標失敗，排查重點應轉向目前 Config 的符合順序、策略與 DNS 設定。這只能協助縮小範圍，不能憑一次結果就判定故障來源。以下僅為規則語法示意，並非要求取代現有設定的完整檔案：
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXYDOMAIN-SUFFIX,example.com,PROXY符合 example.com 及其子網域；排在前面的規則若先符合，可能會改變最終處理方式。IP-CIDR依 IP 網段進行比對；範例中的no-resolve用來避免為這條 IP 規則主動解析網域。GEOIP依 IP 地理位置資訊比對，不能簡單視為網域後綴判斷。FINAL是前面的規則都未符合時採用的最後處理方式，請確認其指向的策略符合預期。
DNS 解析失敗時，代理連接埠可以連線，但網站網域仍可能無法存取。請先記錄與解析相關的錯誤，並確認 Config 中現有的 DNS 設定；不要只為了排查一次故障，就同時更換 DNS、伺服器、規則與協定。每次只調整一項，才能判斷是哪項變更影響結果。
六、完成首次連線後的檢查
確認連線成功後，請恢復日常使用的 Global Routing 模式，再次開啟同一個目標測試。若先前暫時使用 Proxy，切回 Config 後仍須確認目標符合的規則與策略。On Demand 控制的是依條件建立連線，不能取代伺服器驗證，也無法修正錯誤的分流規則；若需要自動連線，請再前往 Settings → On Demand 個別確認條件。
- 確認預設項目：在 Home 保留明確選取的伺服器，避免混淆已測試的項目與目前的預設項目。
- 確認路由：記下 Global Routing 目前的模式；使用 Config 時，確認啟用的是預期的設定。
- 確認實際存取：分別測試網站、登入或其他所需操作，不要以一次測試取代所有使用情境的檢查。
- 保留排查紀錄：記錄使用 Wi-Fi 或行動網路、測試方式、錯誤原文與變更過的設定，並隱藏訂閱憑證。
若後續只有某個網路連線失敗，可使用相同伺服器與測試方式進行比較；若只有特定目標失敗，請從該目標的規則與解析路徑繼續檢查。更多分層排查方法請參閱問題診斷；介面用語與規則關鍵字可查閱術語表。