Shadowrocket 首次連線教學

步驟一：新增伺服器或匯入訂閱

先讓 Home 顯示可選取的伺服器，再設定模式與連線開關。訂閱連結和單一伺服器資料是兩種不同的輸入方式：前者用來取得一組可更新的伺服器資料，後者用來儲存單一伺服器的詳細參數。依照手邊資料選擇一種方式即可，不必重複新增相同內容。

已有訂閱連結：選擇 Subscribe

開啟 Shadowrocket，進入 Home，點選右上角的加號，再進入 Add Server。在 Type 選擇 Subscribe，將自己的完整訂閱連結填入 URL。輸入方便辨識的名稱後，點選右上角 Done 儲存。返回 Home，等候訂閱資料取得完成，再檢查相應群組中是否出現伺服器項目。

複製連結時，請從原始內容完整複製，不要連同說明文字、空格或換行一起貼上，也不要手動刪除連結末尾看似複雜的參數。訂閱網址可能包含身分憑證，這些參數會影響存取權限。請只在自己的裝置上使用連結，勿將完整網址貼到公開留言、群組聊天室或排查截圖中。

若儲存後只看到訂閱名稱，沒有伺服器，請先確認目前網路能否取得訂閱資料，再嘗試更新該訂閱。服務商的網站網址不一定是訂閱網址；登入頁面、訂單頁面或一般說明頁面都不能作為 Subscribe 的輸入內容。若顯示網頁或錯誤訊息，請向自己的服務商確認連結用途，不要反覆更改協定設定。

已有單一伺服器資料：在 Add Server 填寫

如果拿到的是伺服器位址、連接埠、密碼或 UUID 等個別欄位，請從 Home 點選加號進入 Add Server，並在 Type 選擇資料中明確指定的協定，例如 Shadowsocks、VMess、VLESS 或 Trojan，而不是 Subscribe。依照原始資料逐項填寫伺服器位址、連接埠與驗證欄位；不同協定顯示的項目不同，不必依照其他協定的欄位補填資料。

請特別留意加密方式、TLS、Server Name、傳輸方式與路徑等額外參數。這些不是可任意填寫的備註，必須符合伺服器端的要求。位址與連接埠填寫正確，不代表整筆資料就已設定完成。不要為了消除提示而任意更換協定或關閉 TLS；若缺少必要資料，請先查閱自己的服務商提供的資訊。

如果已有相容的 QR Code，可使用 Scan QR Code 掃描；相機權限僅用於掃描。完成讀取後，仍應確認辨識出的協定、位址與連接埠，再進行儲存。QR Code 也可能包含連線憑證，請勿公開展示。手動填寫和掃描只是不同的輸入方式，後續選擇伺服器與連線的步驟相同。

返回 Home：選取預設伺服器

儲存成功後，在 Home 的伺服器列表中點選要使用的項目，確認左側的選取圓點亮起。看到一組伺服器名稱，只代表匯入成功，不表示所有項目都已通過測試，也不代表其中某一項已設為預設伺服器。首次操作可選擇名稱與用途明確的項目，避免同時切換伺服器和變更其他設定。

完成這一步的標準是：Home 中有伺服器項目、已選取需要使用的項目，而且可以開啟資料檢查參數。Subscribe 管理伺服器來源；Config 管理設定檔，兩者不可混為一談。若想了解這些名詞，請先查看概念速查，完成基本匯入後再進行下一步。

步驟二：選擇 Global Routing

伺服器決定代理連線使用哪個出口，Global Routing 則決定流量的處理方式。在 Home 點選 Global Routing，依目前用途選擇設定 (Config)／代理 (Proxy)／直連 (Direct)。首次驗證時，請先確認選擇的模式；否則即使連線開關已開啟，也可能把正常的分流結果誤判為連線失敗。

設定 (Config)：依目前設定檔判斷

設定 (Config) 會依目前使用的設定檔及其中規則處理連線。使用此模式前，請進入 Config，確認目前選用的檔案就是準備使用的那一份。檔案出現在列表中，不代表已經選取；也不要只根據檔名推測內部規則。若尚未準備好設定檔，建議先完成基本連線測試，再依完整手冊設定分流，會比一次匯入多份來源不明的設定檔更容易排查。

規則通常依序比對，目標可能套用 DIRECT、PROXY 或其他已設定的策略。例如 DOMAIN-SUFFIX,example.com,PROXY 表示比對相應網域後使用 PROXY；FINAL,PROXY 則為未符合前面規則的連線指定最終處理方式。這裡僅說明語法，首次設定時不必立即編輯規則，也不應據此覆蓋現有設定。

代理 (Proxy)：確認代理路徑

代理 (Proxy) 會將整體路由模式設為使用代理，適合在首次設定時確認所選伺服器能否支援實際連線。在 Home 選好伺服器後，選擇 Proxy，再依下一步開啟連線。這能減少首次測試時分流規則造成的干擾，但不代表所有請求在任何情況下都一定經由遠端伺服器；系統流量、排除項目及相關設定仍可能影響實際路徑。

若在 Proxy 模式下測試與網頁瀏覽正常，切換回 Config 後只有特定目標異常，應優先檢查該目標比對到的規則或策略，不必立即重新匯入整組訂閱。這項對照有助於區分「伺服器無法使用」與「分流結果不如預期」。

直連 (Direct)：不可作為代理成功的依據

直連 (Direct) 會以直連方式處理流量，不會將所選代理伺服器作為一般連線路徑。可用來對照裝置原本的網路狀態，但在 Direct 模式下能開啟網頁，並不能證明剛匯入的代理伺服器有效。同樣地，開啟 App 的連線開關與使用代理是兩回事，不能只看開關狀態就下結論。

完成這一步後，記下所選模式，以及 Config 下目前使用的設定檔。後續每次重新測試時，盡量保持這兩項不變。規則優先順序、策略與設定欄位的詳細說明，請參閱完整手冊；此處先確認測試目的與所選模式一致。

步驟三：開啟連線並允許 VPN 設定

返回 Home，再確認一次預設伺服器的選取狀態與 Global Routing。確認無誤後，開啟頁面頂部的連線開關。首次建立連線時，系統可能會提示允許 Shadowrocket 新增 VPN 設定；這是 App 接入系統網路處理功能所需的授權，不代表訂閱已驗證成功。

在系統提示中確認要求來自 Shadowrocket，然後選擇允許，並依照裝置提示完成身分確認。授權期間請勿反覆切換 App 或連續點擊連線開關。完成後返回 Home，等待連線狀態更新；若先前取消授權，可再次發起連線，並依系統提示完成操作。

在 iPhone 和 iPad 上，系統提示的版面、驗證方式與狀態顯示位置可能不同，請以裝置實際畫面為準。若要確認系統中的設定，可在系統 Settings 中尋找 VPN 相關項目，確認是否存在 Shadowrocket 設定。不要為了解決一次連線失敗，就刪除用途不明的裝置管理設定。

也請確認裝置上是否有其他正在使用的 VPN 連線。多個設定同時爭用連線時，可能發生剛連上就中斷、開關自動復原或狀態不符預期等情況。請先確認目前啟用的是哪個設定，再進行測試；受管理的裝置若限制新增 VPN 設定，應遵守裝置管理規範，不能透過修改伺服器參數解決系統限制。

完成這一步的標準是系統連線已建立，而不是所有目標都能正常使用。連線狀態正常只代表本機網路處理已啟動，還需要在下一步確認遠端連線與實際網頁存取。若開關始終無法保持開啟，請先停在此階段檢查授權與系統狀態，不要繼續更改 DNS 或規則。

步驟四：Connectivity Test 與實際連線

建立連線後，在 Home 找到 Connectivity Test 並執行一次，等待結果顯示。此測試用來觀察目前條件下的連線狀況，請記錄結果是成功、逾時或其他錯誤，不要只記下延遲數字。列表中的延遲測試與連線後實際存取網頁是兩種不同的判斷；伺服器有回應，不代表驗證、傳輸與目標存取等環節都正常。

先測試連線，再開啟實際目標

測試結束後，開啟瀏覽器前往自己需要使用的正常網頁。先選擇網址明確、平時能確認狀態的目標，不要同時開啟大量頁面。若網頁先前已開啟，請重新整理並確認內容確實重新載入；看到快取內容不能證明目前連線路徑可用。一次只測試一個目標，方便將瀏覽器結果與 App 紀錄對照。

Connectivity Test 成功但特定網頁無法開啟，可能是測試目標與該網頁的存取條件不同，也可能與 DNS、規則比對或目標服務本身有關。反之，測試目標暫時無法連線，也不必直接判定所有伺服器都失效。請一併參考測試結果與實際存取情況，不要只憑單次測試下結論。

使用 Config 時，進一步確認分流

若使用設定 (Config)，至少分別測試一個預期直連的目標，以及一個預期使用代理的目標。在 App 的連線紀錄中查看相應請求與策略結果，並對照目前設定檔中的規則順序。網頁能開啟，只能證明該次存取成功，不能單憑這點確認使用了預期路徑；還需配合比對紀錄判斷。

Data 可協助觀察連線期間的流量變化，但流量增加不代表規則正確，也不能據此確認所有 App 的連線路徑。首次驗證的重點仍是：所選伺服器明確、Global Routing 明確、Connectivity Test 有結果、實際目標可連線；使用 Config 時，也能說明相應策略。

若四項都符合預期，即可維持目前設定正常使用。此時不必為了追求更低的測試數字而頻繁切換伺服器，也不必立即更換 DNS。記下目前成功的設定組合，日後遇到異常時，就能與這次的網路、模式及伺服器狀態比較。

步驟五：依失敗階段排查

先區分「內容未匯入」、「系統連線未建立」和「連線後存取異常」。這三個階段需要檢查的項目不同。每次只變更一項，修改後用相同目標重新測試；若同時更換伺服器、DNS 和設定檔，即使恢復正常也很難找出原因，之後還可能再次遇到相同問題。

訂閱沒有內容：檢查輸入與取得過程

返回 Subscribe 項目，確認 URL 是否完整、是否誤貼服務商網站網址，以及目前網路能否取得訂閱資料。留意連結是否已由原服務商重設、失效或更換。更新失敗時，保留原有可用資料，先確認錯誤提示，再決定是否重新匯入；重複建立相同訂閱通常無法解決原始連結的權限問題。

若新訂閱的伺服器列表與預期不同，請先確認訂閱來源及服務是否有效。請勿在公開場合傳送完整 URL 尋求協助。可描述「更新後內容為空」、「顯示驗證失敗」等狀況，再請自己的服務商確認帳戶與訂閱狀態。

無法開啟連線開關：檢查系統授權

若開啟開關後立即復原，請確認是否取消了新增 VPN 設定的系統提示，以及裝置是否允許該設定建立連線。返回 Home 再次發起連線，留意系統提示是否被遮住或尚未確認。此階段尚未建立系統連線，反覆更換訂閱中的伺服器通常不是有效的第一步。

若狀態顯示異常，也請確認目前啟用的 VPN 設定與裝置管理限制。一般網路可正常使用，只能排除部分基本網路問題，不能取代 Shadowrocket 所需的系統授權。

已連線但測試失敗：確認伺服器與網路

先檢查 Home 中實際選取的伺服器，是否就是剛才填寫或準備測試的項目，再核對位址、連接埠、密碼或 UUID、TLS 與傳輸參數。伺服器名稱相似時特別容易選錯。若現有訂閱中還有自己確認可用的項目，可以維持其他設定不變，只切換該項目進行對照，不必重新匯入所有內容。

接著確認裝置原本的網路可正常使用；必要時，可改用自己允許的其他網路重新測試。切換網路後，仍使用相同伺服器與相同目標，結果才有比較意義。測試失敗也可能與伺服器端狀態有關；客戶端的連線開關無法證明服務商端的驗證與服務仍然有效。

只有部分目標失敗：檢查規則與 DNS

若 Proxy 模式正常、Config 模式異常，請返回 Config 確認目前使用的檔案，以及目標比對到的策略。檢查是否符合優先順序較前面的 DIRECT 或 REJECT 規則，不要只檢查最後一條規則。修改規則前先儲存原設定，每次只改一處並重新測試，確認該目標的處理方式確實有所變更。

若錯誤提示與網域解析有關，再檢查目前的 DNS 設定，不要把所有問題都歸因於 DNS。變更前先記下原始值，並使用自己理解且有明確依據的設定；僅因網頁無法開啟就接連更換多個解析位址，反而會增加變因。DNS、IP-CIDR 與 FINAL 等概念可先參閱概念速查，再依完整手冊進一步處理。

仍未恢復：整理基本排查紀錄

聯絡自己的服務商前，請整理使用的協定、Global Routing 模式、問題發生的步驟、Connectivity Test 結果，以及更換網路後結果是否相同。可以附上已移除敏感資料的錯誤文字，但不要包含完整訂閱連結、密碼、UUID、QR Code 或身分參數。提供具體錯誤，比只說「無法連線」更有助於找出問題。

完成首次設定後，日常操作可保持簡單：需要時更新現有訂閱、確認預設伺服器與目前設定，再開啟連線並驗證實際存取。App Store 負責取得與更新 App，Subscribe 負責更新現有伺服器列表，Config 負責設定檔；三者用途不同，不必因一次線路異常而重新購買 App。