OFFICIAL MANUAL / FIRST CONNECTION

Shadowrocket 使用教學：匯入訂閱與首次連線

依序完成匯入、路由、連線、驗證與故障排除。先建立一次可驗證的連線，再調整規則與自動連線設定。

  • iPhone / iPad
  • 現有訂閱或伺服器資訊
  • 五步操作

STEP 01 / IMPORT

Add Server：新增伺服器或匯入訂閱

開啟 Shadowrocket，進入 Home。先確認手上的資訊是哪一種：用來更新伺服器清單的訂閱連結，或包含單一伺服器位址、連接埠與認證資料的資訊。兩者的填寫方式不同，不要只憑連結長短判斷類型；若不確定，先查看服務供應商提供的用途說明。首次操作時，先讓連線開關保持關閉，並完整儲存資訊。

已有訂閱連結：選擇 Subscribe

在 Home 點選右上角的新增入口，進入 Add Server。開啟 Type 選項清單，選擇 Subscribe，再將完整訂閱連結貼到 URL 欄位。備註可填入方便自己辨識的名稱。貼上後檢查連結首尾是否完整，尤其留意複製時是否夾帶空格、換行或聊天文字；不要手動刪改連結中的參數。

確認後，使用頁面上的儲存功能返回 Home，等待訂閱內容讀取完成。成功的判斷依據不是只出現訂閱名稱，而是訂閱下方已列出可選擇的伺服器。如果只有群組、沒有伺服器，先查看是否出現讀取錯誤，再更新該訂閱。不要反覆新增同一個連結來取代更新，否則之後很難分辨正在測試的是哪一組內容。

訂閱連結通常包含存取憑證，請像帳戶資料一樣妥善保管。不要將完整連結貼到公開討論區，也不要為了測試而提交給不明網頁。App 內的訂閱更新會向該連結取得目前的伺服器清單，這與透過 App Store 更新 Shadowrocket 是兩回事。之後清單有變動時，請更新原有訂閱，並再次確認所選伺服器仍在清單中。

已有單一伺服器資訊：依照對應協定填寫

如果取得的是單一伺服器參數，請先在 Add Server 選擇服務供應商明確指定的協定類型，再逐項填入伺服器位址、連接埠，以及該協定要求的認證欄位。例如 Shadowsocks 與 VLESS 的認證欄位不同，不能因為位址相同就互換 Type。TLS、傳輸方式或伺服器名稱等欄位，也應依原始資訊填寫，不要憑經驗自行啟用或停用。

如果已有用來匯入單一伺服器的 QR Code，可使用 Scan QR Code 掃描，並在儲存前檢查辨識出的 Type 與伺服器位址。QR Code 只是資訊載體，不保證參數一定有效；辨識失敗時，請回頭核對原始資訊，不要猜測連接埠或認證值來補齊內容。協定欄位的意思可參閱名詞解釋。

儲存後返回 Home，點選準備使用的伺服器，確認目前選取的是預期項目。此時只能確認「資訊已匯入用戶端」，尚未證明伺服器能成功連線。下一步先決定請求的路由方式，再開啟連線開關，避免還不清楚連線模式就直接判斷匯入是否成功。

Input
已有訂閱連結，或完整的伺服器參數。
Result
Home 中出現可選擇的伺服器，且已選取一個項目。
Next
開啟 Global Routing，確認本次測試使用的模式。

STEP 02 / GLOBAL ROUTING

Global Routing：選擇配置、代理或直連

返回 Home，點選 Global Routing 查看目前模式。此處決定如何處理請求，不是選擇伺服器所在地區，也不是訂閱更新開關。先記下目前的選擇，後續測試才能判斷差異來自伺服器還是路由設定。三種模式分別為配置 (Config)、代理 (Proxy)、直連 (Direct)。

Config
配置 (Config)：依據目前設定檔中的規則與策略處理請求，可能分別採用 PROXY、DIRECT 或 REJECT。
Proxy
代理 (Proxy)：讓由用戶端處理的請求經由代理路徑傳送，適合作為首次連線的比較測試。
Direct
直連 (Direct)：用於直接連線。在此模式下可以正常瀏覽，不代表代理路徑已驗證可用。

STEP 03 / CONNECT

Home：開啟連線開關並完成授權

在 Home 再次確認目前的伺服器與 Global Routing，接著開啟頂端的連線開關。首次連線時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。此提示表示 App 要建立用來處理網路流量的系統連線設定，不代表系統已驗證你填入的遠端伺服器。請閱讀提示，確認這是剛才主動觸發的操作後，再依系統要求允許並完成認證。

完成授權後返回 Shadowrocket，確認開關與連線狀態是否維持開啟。不同裝置顯示連線標示的位置可能不同，不要只憑狀態列上是否出現特定圖示來判斷。App 仍可能遇到認證失敗、連線逾時或伺服器無法連線；系統連線已建立與遠端代理路徑可用，是需要分別驗證的兩件事。

如果先前取消過授權，請返回 Home 再試著開啟，並留意系統是否再次顯示提示。若開關立即恢復關閉，先閱讀 App 的提示，再檢查系統 Settings 中相關 VPN 設定的狀態，以及裝置是否受到限制。使用受管理的裝置時，請遵守裝置管理規範，不要為了完成教學而任意刪除既有管理設定。

連線保持開啟後，先不要切換多個伺服器，也不要同時變更 Global Routing。接著進行下一步，取得一次測試結果。若要停止測試，請返回 Home 手動關閉開關，並確認 App 顯示已中斷連線；若連線會自動重新建立，請檢查是否啟用了 On Demand 或其他自動連線條件。

STEP 04 / VERIFY

Connectivity Test：驗證連線與規則結果

連線開啟後，在 Home 使用 Connectivity Test 測試現有伺服器。等待本次測試完成，先查看目前選取的伺服器是否有回傳結果。測試數值只反映特定測試方式和當下網路條件下的單次結果，不等於網頁載入速度，也不代表能持續正常使用。測試逾時值得進一步檢查，但不能只憑一次逾時就認定所有實際請求都會失敗。

先測試實際存取，再查看規則命中情況

開啟瀏覽器，瀏覽一個平常能正常使用、內容較簡單的頁面，並等待新的請求完成。不要只查看已開啟的舊頁面，因為快取內容可能在斷線時仍然顯示。接著再測試另一個不同的頁面，記錄是全部失敗、部分失敗，還是載入速度較慢。不要將單一網站本身的故障直接歸因於 Shadowrocket。

返回 App 查看連線記錄，或 Data 中可用的相關資訊，找到剛才請求的目標，核對實際採用的策略與路徑。若記錄中有顯示符合的規則，請進一步確認是否符合預期：例如預期直連的目標應命中 DIRECT，預期透過代理的目標則應使用目前伺服器或設定檔中的對應策略。只看到流量計數增加，無法證明某個特定請求一定經由代理傳送。

如果剛才使用 Proxy 且實際瀏覽正常，可切換至配置 (Config)，再瀏覽同一組頁面。比較結果時，請維持相同的伺服器與本機網路。若只有 Config 模式出現差異，優先檢查目前設定檔、規則順序與策略選擇，不要立即重新匯入訂閱。規則可能會將請求分配至不同於 Home 目前所選的策略，需搭配實際記錄判斷。

將驗證結果分成三個層次

第一層是「用戶端已連線」，透過開關與 App 狀態確認；第二層是「伺服器路徑可用」，搭配測試與實際瀏覽確認；第三層是「規則符合預期」，透過相同目標的命中記錄確認。三個層次不能互相取代。只完成第一層時，不應直接認定訂閱有效；完成第二層後，仍須確認配置 (Config) 是否依預期分流。

若要與原有網路狀況比較，先記下目前的路由模式，再手動中斷連線、重新瀏覽相同頁面，最後恢復連線後再測一次。每次只變更一個條件，測試結果才有參考價值。完成後選擇適合日常使用的模式，不必為了追求更低的測試數值而一直切換伺服器。

Connection
開關維持開啟，App 連線狀態穩定。
Request
新發起的實際頁面請求能夠完成。
Routing
請求記錄中的規則、策略與路徑均符合預期。

STEP 05 / TROUBLESHOOT

常見問題：從最早未通過的步驟開始檢查

排查時，先確認「哪一步最早沒有得到預期結果」。如果 Home 中還沒有可用項目，就先處理匯入；如果尚未完成授權，就先處理系統連線；如果已連線但部分頁面無法開啟，再檢查存取與規則。不要一次重設設定、重新匯入訂閱又切換網路，這會破壞比較條件，也可能覆蓋原本正確的資訊。

訂閱沒有內容，或匯入時出現錯誤

重新核對完整 URL 與訂閱用途，確認是否誤填服務說明網頁的網址，以及複製時是否漏掉參數。讀取訂閱需要目前的網路可連上該連結；App 能開啟不代表訂閱網址一定可連線。若出現認證或內容格式錯誤，請保留錯誤訊息，並向你的服務供應商確認連結狀態與適用格式。不要公開完整連結，也不要在原因不明時任意修改其中的認證參數。

單一伺服器匯入失敗時，先檢查 Type，再依序核對位址、連接埠、認證、TLS 與傳輸設定。欄位缺漏和欄位填錯是不同問題；成功儲存也不代表填入的值正確。QR Code 辨識出的內容同樣需要核對；若缺少必要資訊，請回頭查看原始說明以取得正確值，不要直接套用常見預設值。

開關可以開啟，但實際請求失敗

先確認目前選取的伺服器仍在已更新的清單中，再分別使用 Connectivity Test 和實際頁面進行測試。若有多個現有伺服器，可只切換伺服器進行一次比較，並維持相同的路由模式。接著在可行時切換 Wi-Fi 與行動網路，重複相同測試。如此可判斷問題是否隨伺服器變化，或只在某種本機網路下發生。

如果所有測試都失敗，請檢查伺服器位址是否能解析、連接埠與認證資訊是否相符，並留意 App 顯示的錯誤類型。連線逾時與認證失敗的排查方向不同：前者應檢查網路連通性，後者則應優先核對憑證與協定。不要用單一的「連線失敗」概括所有狀況，也不要把反覆點擊開關當成解決方法。

Proxy 正常，Config 模式下部分網站異常

先在 Config 確認目前使用的設定檔，再查看失敗目標的符合記錄。檢查是否命中預期規則、策略是否指向可用伺服器，以及是否被分配為 DIRECT 或 REJECT。若涉及網域解析，也要分辨是網域解析失敗，還是解析後連線失敗。首次排查時不建議同時更換多組 DNS 設定，請先保留目前狀態並記錄線索；相關術語可參閱名詞解釋。

如果只有少數目標失敗，而其他請求正常，應優先檢查該目標、符合的規則與使用的路徑，不要立刻刪除所有設定。若只是速度較慢，請分別比較簡單頁面與實際服務請求，並盡量在相近時間測試。單次延遲結果無法涵蓋頻寬、伺服器負載、目標服務回應速度與本機網路品質等差異。

整理可重現的資訊，再繼續處理

記錄裝置類型、本機網路、Global Routing 模式、目前協定、發生故障的步驟，以及 App 顯示的原始錯誤。分享記錄前，請遮蔽訂閱 URL、伺服器認證資料與其他個人資訊，只保留判斷問題所需的內容。清楚說明「同一台伺服器在 Proxy 下可用，但 Config 下某個目標失敗」，通常比反覆重新安裝更能縮小問題範圍。

至此，首次使用的完整流程應為：資訊可匯入、伺服器可選取、連線可建立、實際請求可完成，且規則結果能夠解釋。若要進一步處理特定錯誤，請參閱常見問題；App Store 商店地區、購買與換機還原方式，另請參閱取得指南。本教學介紹手動連線的基本流程；之後調整 On Demand 或複雜設定時，也應遵循每次只變更一項條件的驗證方式。