Shadowrocket 使用教學

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

開啟 Shadowrocket，先停留在 Home，暫時不要開啟連線開關。確認手邊資料屬於哪一類：用於更新伺服器清單的訂閱連結，或明確列出協定、位址、連接埠及驗證資訊的一組伺服器參數。兩種資料的輸入位置不同；訂閱連結不能直接當作伺服器位址，單一伺服器的分享內容也不一定是訂閱。

已有訂閱連結：選擇 Subscribe

在 Home 點選右上角的新增入口，進入 Add Server，在類型選單中選擇 Subscribe，將自己的完整訂閱連結貼到 URL 欄位。填入方便辨識的名稱後儲存。貼上前後請確認連結沒有多出空格或換行，尤其要保留問號後的查詢參數；這些參數可能用於識別訂閱，刪除其中一段可能導致取得失敗。

儲存後返回 Home，等待訂閱內容載入完成。成功時應會看到訂閱群組及其中的伺服器項目；只出現訂閱名稱，不代表已取得可連線的伺服器。如果清單空白、出現錯誤或一直沒有內容，請先查看取得結果，不要反覆開啟連線開關。首次匯入通常也需要目前的網路能連線至訂閱網址。

請將訂閱連結視為敏感資訊，避免貼到公開留言區或截圖中。更新訂閱時會重新讀取遠端清單，可能新增、刪除或取代其中的項目。需要調整伺服器參數時，請先確認該項目是否由訂閱管理，以免手動修改在下次更新時被覆蓋。

已有伺服器資料：選擇相應協定

如果取得的是一組獨立參數，同樣進入 Add Server，但應選擇資料指定的協定類型，例如 Shadowsocks、Trojan 或 WireGuard。依欄位名稱填寫伺服器位址和連接埠，再填入該協定所需的密碼、識別碼或金鑰。不同協定的驗證欄位不能互換；不要只因位址相同就選擇其他協定。

如果資料也提供 TLS、SNI 或傳輸相關欄位，請逐項依原始資料填寫。伺服器位址用於建立連線，SNI 則用於 TLS 中識別服務名稱；部分設定中的兩者可能不同，不宜自行改成相同內容。若不清楚欄位用途，請先查閱協定技術參考，不要猜測填寫。

儲存並返回 Home 後，在 SERVER 清單中選取準備使用的項目，確認選取標記位於預期的伺服器上。已有多筆記錄時，名稱相似不代表參數相同；可用自訂名稱區分，但不要將密碼寫在名稱中。至此已完成伺服器資料準備，下一步還要決定流量採用哪種路由模式。

Global Routing：選擇連線模式

在 Home 找到並開啟 Global Routing。本教學先介紹三種基本模式：設定檔(Config)、代理(Proxy)、直連(Direct)。它們決定請求採用的策略，與「伺服器是否已匯入」是兩回事；清單中有伺服器，不代表所有請求都會使用它。

首次操作且尚未準備規則設定時，可先選擇代理(Proxy)，將測試範圍縮小至目前的伺服器與本地網路。這不是長期使用時必須選擇的模式，也不表示所有系統流量在任何情況下都會經過代理。選擇後返回 Home，再次確認目前選取的伺服器，避免實際測試到其他項目。

準備使用設定檔(Config)時，先前往 Config 頁面，確認已有預期的設定檔並將其選為目前設定，再返回 Global Routing 選擇設定檔(Config)。Config 頁面用於管理設定檔；路由選項中的 Config 則表示依設定檔規則處理流量。兩者名稱相關，但「檔案已存在」與「目前正在使用該檔案」不可混為一談。

也要區分伺服器訂閱與規則設定檔：透過 Subscribe 匯入的內容通常用於管理伺服器清單，不能因此認定分流規則也已準備好。如果資料只有連線參數，請先在代理(Proxy)模式下完成連線測試，再處理規則。若既有設定檔引用了策略名稱，也要確認這些名稱能對應到實際可用的策略。

直連(Direct)可在排除故障時作為對照，但無法用來證明代理伺服器可用。切換到直連後若能開啟網頁，只能說明這次直接連線成功。更多關於規則順序、最終策略和情境設定的說明，請參閱代理模式說明；不熟悉的用語可繼續查閱術語手冊。

Home：開啟開關並完成授權

返回 Home，開啟頂端的連線開關前，快速確認目前選取的伺服器、Global Routing 及目前網路。如果仍在輸入密碼或編輯參數，請先儲存並離開編輯頁面。首次測試期間建議使用同一種網路，不要在連線時切換 Wi-Fi 與行動網路，否則發生問題時很難判斷是哪項條件改變所致。

開啟連線開關後，首次使用時可能會出現系統新增 VPN 設定的請求。這是 Apple 系統用來建立相關網路設定的授權流程。確認此次操作由 Shadowrocket 發起後，再依系統彈出視窗的提示允許，並完成裝置要求的身分驗證。系統設定授權與訂閱伺服器驗證是兩回事；前者通過不代表後者的參數正確。

如果剛才取消了系統請求，不必重新匯入伺服器。返回 App，再次主動開啟連線，並依系統實際提示操作。如果裝置由組織管理，相關權限可能受到管理政策限制；此時請確認裝置管理要求，不要試圖刪除不熟悉的管理設定。無法新增 VPN 設定屬於系統權限階段的問題，應與伺服器逾時分開排查。

授權完成後返回 Home，查看連線狀態是否維持。如果開關立即關閉、出現錯誤或狀態長時間不穩定，請先記下提示內容，不要快速連續切換。系統狀態列中的 VPN 標示會因裝置和系統的顯示方式而異；即使出現標示，也只代表相關網路設定處於連線狀態，不能取代下一步的實際連線測試。

為了讓首次測試可重複，暫時維持 On Demand 設定不變，先完成一次手動開啟、瀏覽及關閉的流程。如果先前已啟用按需連線，手動關閉後可能因符合條件而再次連線；若遇到此情況，請先檢查 On Demand 設定，再判斷開關是否異常。需要調整自動連線條件時，可等基本連線測試完成後再進行。

在 iPad 上也依相同順序操作：先確認選取的項目與路由模式，再完成系統授權。分割畫面或橫向顯示可能會改變內容位置，但不影響這些操作的先後關係。現在已建立連線，接下來要確認請求能否完成，以及結果是否符合所選策略。

Connectivity Test：確認連線是否生效

先在 Home 找到 Connectivity Test 並執行測試，查看目前伺服器的結果。測試結果會受測試方式、目標及當下網路影響；顯示可連線不代表所有網站都能開啟，單次逾時也不一定表示所有服務請求都會失敗。這項測試可提供初步線索，不宜作為唯一判斷依據。

接著開啟瀏覽器，造訪自己熟悉且有權瀏覽的 HTTPS 網頁，盡量送出新的請求，避免只根據快取頁面判斷。可重新整理頁面或開啟另一個頁面，觀察文字與圖片是否都能載入。如果只有部分資源載入失敗，請與整個頁面完全無法開啟的情況區分，不要立刻修改所有連線參數。

如果目前使用代理(Proxy)，先確認實際使用的仍是剛才選取的伺服器，再根據瀏覽結果檢查連線。如果目前使用設定檔(Config)，至少準備兩類測試目標：依自己的規則應直連的目標，以及應透過代理的目標。兩者都能開啟只是第一階段的驗證，還要確認各自採用的策略是否符合預期。

在 App 中查看連線或請求記錄的入口，檢查測試目標對應的網域、套用的策略及錯誤資訊。如果介面有提供符合的規則，也請一併確認。規則通常涉及比對順序與最終策略；某條規則存在於設定檔中，不代表本次請求一定會符合該規則。記錄比「頁面看起來能開啟」更能協助確認分流結果。

測試時每次只變更一項條件。例如伺服器和目標保持不變，只切換路由模式；或維持模式與目標不變，只切換本地網路。記錄變更前後的結果，才能了解哪項條件影響連線。若一次同時更換伺服器、網路與設定，即使恢復瀏覽，也很難留下可供下次排查參考的結論。

如果需要了解 DOMAIN-SUFFIX、GEOIP 或 FINAL 的意思，請先閱讀規則關鍵字與介面用語。初次使用不必立刻編寫規則；先保留可正常運作的基本設定，再逐項加入需求，通常更容易維護。

常見失敗原因：依序縮小排查範圍

遇到問題時，先判斷失敗發生於匯入、授權、連線或瀏覽階段。不要一開始就刪除所有設定，也不要將每次失敗都歸咎於伺服器。保留目前可還原的資料，記下網路類型、路由模式、測試目標與提示內容，再依照以下順序檢查。

無法取得訂閱，或匯入後清單空白

先確認本地網路能正常連線，再檢查訂閱連結是否完整且仍有效。伺服器若回傳登入頁面、錯誤提示或一般網頁，即使網址可以開啟，也不代表回傳內容適合匯入。請向自己的服務提供者確認連結用途與有效狀態；不要公開連結，也不要任意刪改驗證參數。如果原有清單仍可使用，請先保留，以免無法重新取得時失去所有記錄。

清單中已有伺服器，但連線逾時或驗證失敗

重新開啟該項目的編輯頁面，對照原始資料檢查協定、位址、連接埠及驗證欄位。連接埠沒有固定的通用值，密碼大小寫及前後空格也可能影響驗證。若設定使用 TLS，請再檢查 SNI、憑證驗證及裝置日期和時間；時間明顯錯誤可能影響憑證有效性判斷。不要將降低憑證驗證要求當作預設解法；不確定參數時，請回頭核對原始資料。

如果同一設定只在某一種本地網路下失敗，可在條件允許時改用另一種網路重測，同時維持伺服器與路由模式不變。測試結果只能說明兩種網路條件下有所差異，仍需搭配錯誤資訊判斷。若持續驗證失敗或伺服器端拒絕連線，請聯絡自己的服務提供者確認伺服器狀態；在 App 中反覆儲存通常無法修復伺服器端問題。

已建立連線，但網站瀏覽結果不符預期

先查看 Global Routing。若選取直連(Direct)，本次瀏覽原本就不會依代理策略處理；若選取設定檔(Config)，請確認目前啟用的是預期設定檔，並查看請求套用的策略。在代理(Proxy)模式下可以瀏覽、但在設定檔(Config)模式下失敗時，通常應優先檢查規則、策略引用及相關 DNS 條件，而不是立刻更換所有伺服器參數。

如果所有目標都無法瀏覽，請先回頭檢查基本網路與伺服器連線；如果只有單一目標失敗，則檢查該目標的比對規則、解析結果及服務狀態。若已自訂 DNS 設定，請先記下原值，再逐項測試，不要同時加入多個來源不明的設定。網域解析與連線路徑的關係較複雜，可繼續閱讀協定參數與技術參考；本頁先維持最小排查範圍。

如何留下可供複查的結果

排查記錄只要保留現象與必要條件即可，例如：「Wi-Fi 下使用代理(Proxy)，目標頁面的正文無法載入，Connectivity Test 逾時。」分享記錄前，請遮蔽訂閱連結、密碼、金鑰及其他驗證資訊。還原至上一次正常運作的設定後，再逐項重試修改；如果無法判斷修改的影響，請先停止繼續疊加設定。

完成本頁流程後，應能清楚說明匯入了哪些資料、目前選取哪台伺服器、使用哪種路由模式，以及如何驗證請求。後續需要設定分流時，請閱讀代理模式；需要核對協定欄位時，請閱讀技術參考。將連線驗證與進階設定分開處理，日後更新訂閱或更換裝置時，也能沿用相同的檢查順序。