Shadowrocket 訂閱匯入與首次連線
依照「匯入 → 選擇路由 → 連線 → 測試 → 排查」的順序操作。先完成一次可重複驗證的連線，再調整規則與自動連線設定。
操作前提：已從 App Store 安裝 Shadowrocket，並備妥自己的訂閱連結或伺服器資料。本網站不提供、不銷售，也不推薦節點或訂閱。App 一次性買斷 ≠ 線路方案，購買 App 不等於取得連線服務。
尚未安裝時，請先閱讀App Store 正版取得說明，確認開發者為 Shadow Launch Technology Limited，且 App ID 為 932747118。系統需求請以 App Store 頁面標示為準。
以下主要說明 iPhone 和 iPad 的操作流程，介面名稱保留英文。請先閱讀符合手邊資料類型的匯入方式，不必同時使用兩種新增方式。按鈕位置可能因介面配置而異，請依名稱辨識。
Add Server：新增伺服器或匯入訂閱
先確認手邊的資料類型。訂閱通常是一組完整連結，讀取後可產生多個伺服器項目；單一伺服器資料則包含協定、位址、連接埠與驗證參數。兩者的輸入方式不同，不能將訂閱連結填入伺服器位址欄，也不要只因連結看起來像網址，就直接在瀏覽器中公開開啟。訂閱連結可能包含個人存取憑證，請比照密碼妥善保管。
已有訂閱連結：選擇 Subscribe
開啟 Shadowrocket 的 Home，點選右上角的新增按鈕進入 Add Server。在 Type 中選擇 Subscribe，再將自己的完整訂閱連結填入 URL。可填寫方便辨識的名稱，避免多個訂閱混在一起。貼上後先檢查連結開頭和結尾是否有空格或換行，確認連結未被通訊 App 截斷，也沒有一併複製說明文字。
儲存後返回 Home，等待讀取訂閱。若只看到訂閱名稱，沒有可選取的伺服器項目，請開啟該訂閱的操作選單並更新，同時留意錯誤訊息。判斷匯入成功的標準不是「按得下儲存按鈕」，而是訂閱下方已出現實際伺服器。此時先選取其中一個，不要在尚未確認匯入結果前，連續重複新增相同連結。
更新訂閱時，裝置目前使用的網路必須能取得訂閱內容。讀取失敗不一定代表連結已失效，也可能是基本網路、網域解析或回傳格式有問題。請先保留原連結並記下錯誤訊息，再依排查問題逐項檢查。訂閱中項目的名稱僅供辨識，不能單憑名稱判斷是否可用。
已有單一伺服器資料：依協定填寫
同樣從 Home 進入 Add Server，在 Type 中選擇與現有資料相符的協定，例如 Shadowsocks、VMess、VLESS 或 Trojan。接著逐項填寫伺服器位址、連接埠及相應的驗證資料。不同協定所需欄位各不相同，密碼與 UUID 不能互相替代；不要因為欄位名稱看起來相似，就套用其他協定的資料。
若現有資料明確列出 TLS、Server Name、傳輸類型、Host 或 Path 等參數，請一併核對。伺服器位址與 TLS 驗證用的名稱可能不同，應依照原始資料填寫，不要自行改成相同值。填寫位址時也要區分「主機名稱」和「完整網址」：欄位只要求主機名稱時，不要額外加上路徑。儲存後返回 Home，確認項目已出現，再點選該項目。
若持有自己的伺服器 QR Code，可從 Home 的掃描入口使用 Scan QR Code。掃描完成後仍應檢查協定與重要參數，不要把「掃描成功」當成「連線已確認」。若 iPad 因視窗配置而有不同的入口位置，仍可依 Add Server、Type、Subscribe 等名稱尋找。
本步完成條件：Home 中至少有一個實際伺服器項目，且已選取該項目。接著決定請求要採用的路由方式，不要立刻修改大量 Settings 項目。
Global Routing：Config、Proxy 與 Direct
在 Home 點選 Global Routing，選擇本次連線要採用的模式，分別為Config、Proxy 和 Direct。此選擇會決定請求的處理方式，但不會自動補上伺服器參數，也不會修復已失效的驗證資料。首次操作時，應分開確認「伺服器是否能連線」和「規則是否符合預期」。
Config：依目前設定檔比對規則
Config 會依目前使用的設定檔決定請求採用哪種策略。進入 Config 頁面，確認已選取要使用的設定檔，再返回 Home，於 Global Routing 中選擇 Config。匯入伺服器訂閱與選擇規則設定檔是兩件不同的事：訂閱中有多個伺服器，不代表目前設定檔已依預期進行分流。首次使用既有設定檔時，至少要確認其來源、用途與策略引用。
常見規則策略包括 DIRECT、PROXY 和 REJECT。選擇 Config 後，部分請求直接連線可能正是規則所設定的結果，不能因此判定連線失效。若不確定某個網域為何採用目前策略，請先在驗證步驟查看對應請求，再核對規則順序。關於規則依序比對的詳細說明，請參閱新手到進階手冊；本頁先完成基本連線流程。
Proxy：檢查所選伺服器的連線路徑
若要先確認現有伺服器是否可用，可暫時選擇 Proxy，減少規則分流對測試結果的影響。此模式會以代理方式處理進入 App 處理範圍的請求，但不代表裝置上的所有活動都會採用完全相同的路徑。測試時仍要指定明確目標，並查看實際請求結果。確認伺服器可用後，可切回 Config，再檢查日常使用的規則。
Direct：對照基本網路連線
Direct 會讓相關請求直接連線至目標，不經由所選代理伺服器。此模式適合用來對照基本網路是否正常，但不能證明伺服器已連線。選擇 Direct 後網頁若能開啟，只能表示這次直接連線成功。要測試所選伺服器，請切回 Proxy 或套用明確代理規則的 Config，再重新測試實際連線。
選擇完成後，記下目前模式與伺服器名稱。後續若測試失敗，每次只變更一個條件再重試，才能判斷問題出在伺服器還是規則；不要在同一輪測試中同時切換伺服器、修改 DNS 並更換設定檔。
Home：啟用連線並授權 VPN 設定
返回 Home，再次確認已選取的伺服器與 Global Routing 模式，然後開啟頂端的連線開關。首次建立連線時，系統可能會提示允許 Shadowrocket 新增 VPN 設定。這是授權 App 建立系統網路連線設定的步驟，與訂閱是否有效是兩個不同環節。請先確認提示是由剛才的主動操作觸發，再依系統指示完成確認與裝置驗證。
完成授權後返回 Shadowrocket，檢查開關與連線狀態。若先前選擇取消，連線通常無法繼續；重新開啟連線開關並依提示操作即可。若沒有再次出現提示，可前往裝置 Settings 中與 VPN 相關的設定檢查現有設定。不同系統版本的設定階層可能不同，請依裝置實際介面尋找，不必為了尋找固定路徑而反覆刪除設定。
建立連線後，系統中的 VPN 標示可作為狀態參考，但只能表示相關網路設定正在運作，無法證明伺服器驗證、DNS 和目標頁面存取都正常。有時 App 顯示連線中，實際目標請求仍會失敗，因此還需要完成下一步。也不要因狀態變化較慢就快速連續切換開關，請等本次連線結果明確後再決定是否重試。
若裝置同時啟用了其他 VPN 連線，或有公司、學校管理的網路設定，可能會影響本次連線。請先確認目前實際啟用的是哪個連線，並遵守裝置管理規範。不要任意移除用途不明的管理設定。首次測試時也建議先不要設定 On Demand，以免手動中斷後又因自動連線條件而重新連線，造成觀察結果混淆。
本步完成條件：已完成系統授權，且 Shadowrocket 顯示連線正在運作。接下來以實際連線測試確認結果，不要用開關位置取代測試。
使用 Connectivity Test 並檢查實際連線
先在 Home 使用 Connectivity Test 初步檢查現有伺服器。測試結果只能反映該測試方式下的連線狀況，不能取代完整的頁面存取測試。顯示回應時間，不代表所有網域、協定和目標都能連線；若出現逾時，也要搭配測試方式與實際使用情況判斷，不要只憑一次結果就刪除所有項目。
接著開啟瀏覽器，前往自己有權存取且內容清楚可辨的頁面。保持相同伺服器和路由模式，嘗試重新整理並開啟頁面中的另一個連結，確認看到的不是快取內容。若只有某個目標失敗，再選另一個明確目標進行對照。先區分「所有連線都失敗」和「只有一個網站失敗」，兩者的排查方向不同。
在 Data 中核對本次請求
返回 Shadowrocket，在 Data 中查看目前可用的流量與請求紀錄。先依剛才的存取時間和目標網域找出請求，再根據紀錄中實際提供的策略、錯誤或連線資訊判斷。若使用 Config，請確認該請求是否依預期採用 PROXY、DIRECT，或被 REJECT。流量總量增加不足以證明目標頁面已成功載入，因為背景 App 也可能產生請求。
若紀錄沒有提供足夠細節，請勿自行推測套用的規則。可先使用 Proxy 對照伺服器路徑，再切回 Config，以相同目標重新測試。若 Proxy 可存取，但 Config 結果不符預期，應優先檢查目前設定檔、規則順序與策略引用，而不是重新填寫所有伺服器資料。若兩種模式都失敗，再檢查伺服器參數、基本網路與解析環節。
若要對照直接連線，可暫時切換至 Direct 或停止目前連線，以相同目標進行測試，再恢復先前的設定。對照測試會改變網路路徑，因此只應存取適合直接連線的目標，並在操作前確認自身的存取需求。記錄結果時，請寫明「目標、模式、是否成功」，不要只寫「網路不通」。
完成首次測試後，可切換一次 Wi-Fi 或行動網路再測，有助於找出只在特定網路發生的問題。若裝置目前無法使用行動網路，略過此步即可。日常使用前請確認已恢復所需的 Config 或其他模式；訂閱更新後若伺服器名稱或項目有所變動，也要重新確認所選伺服器與策略引用。
訂閱失敗、連線失敗或網頁無法開啟
排查時先保留目前設定與錯誤訊息，再依照以下順序逐項確認。每完成一項，只修改直接相關的內容，並以相同目標重新測試。直接重新安裝會改變原有的伺服器選擇、設定檔與授權狀態，反而難以判斷真正原因，不建議一開始就這麼做。
訂閱已儲存，但沒有伺服器項目
返回 Add Server 中的訂閱編輯入口，確認 Type 為 Subscribe，且 URL 是完整的既有連結。檢查是否複製了頁面標題、漏掉連結尾端參數，或混入空格與換行。接著確認基本網路是否正常，再更新一次訂閱並記下錯誤訊息。若回傳的是登入頁面或說明頁，而非 App 可讀取的訂閱內容，請向既有服務的管理方確認連結用途與格式。
不要將完整訂閱連結貼到公開討論區，也不要為了測試而任意刪除其中的參數。部分參數用於識別個人訂閱資格，修改後即使網址仍可開啟，也不一定會回傳正確內容。若既有服務資料說明連結已更換，請更新原有訂閱紀錄，避免多筆舊紀錄造成後續誤選。
伺服器已出現，但無法正常連線
先確認實際選取的是預期伺服器，再核對協定、連接埠、驗證資料與 TLS 等參數。不要透過停用憑證驗證來掩蓋名稱或憑證問題，應先檢查 Server Name、伺服器位址與裝置時間是否正確。接著暫時使用 Proxy 測試相同目標：若仍失敗，優先檢查伺服器連線狀況與參數；若 Proxy 正常而 Config 異常，再檢查設定檔與規則。
連線開關無法維持啟用，或尚未完成系統授權
查看系統 VPN 設定中的目前連線狀態，確認新增設定的授權已完成，並留意是否有其他連線正在切換。若裝置受管理，請先確認管理限制。若手動中斷後又自動連線，請檢查是否已設定 On Demand 觸發條件；這與「開關失靈」是不同問題。調整前先記下原有條件，避免一併改變日常所需的自動連線行為。
Connectivity Test 有回應，但網頁仍無法開啟
先比較不同目標的實際存取結果，再查看 Data 中是否有對應失敗目標的紀錄。可能的問題環節包括網域解析、規則選擇、伺服器連線至目標，以及目標本身的回應。證據不足時，不要直接將問題歸因於 DNS。確認是解析錯誤後，先檢查目前設定檔採用的 DNS 設定，避免同時更換多個解析位址，導致結果無法比較。
若只有在某個 Wi-Fi 下失敗，請先確認該網路是否需要完成正常的網路登入驗證；若切換至其他可用網路後恢復，應繼續檢查原網路條件。若只有單一 App 失敗，可先用瀏覽器開啟同一服務中可存取的頁面進行對照，區分 App 工作階段、目標服務與用戶端連線問題，不要立刻修改所有規則。
保留必要的排查紀錄，再進行後續調整
記錄裝置類型、目前網路、Global Routing 模式、所選伺服器的自訂名稱、失敗目標與錯誤狀況即可。若要分享診斷紀錄，請先移除完整訂閱連結、密碼、UUID、個人位址及其他驗證資料；只遮住名稱並不代表憑證已移除。完成修改後，重新依序確認「選擇伺服器 → 連線 → 存取目標 → 查看紀錄」，確保結果可重現。
完成入門教學的標準：已匯入既有資料，能說明目前 Global Routing 的選擇，完成連線授權，並透過實際存取確認結果。接著可閱讀新手到進階完整手冊，了解 Config 規則、On Demand、Data 與日常維護；功能範圍請參閱功能介紹。
日常更新 App 請透過 App Store 完成。更新 App、更新訂閱與更換規則設定檔是三種不同操作；請分別完成並進行測試，方便在出現變化時準確找出原因。