Shadowrocket 使用教學：
匯入、連線與驗證

開啟 Shadowrocket，進入 Home，在 SERVER 區域附近找到 Add Server；也可透過介面中的新增入口進入相同編輯頁面。先查看 Type，再開始填寫。Type 會決定後續顯示的欄位，不要只因某個表單較短就任意選擇協定。訂閱連結是用來取得項目清單的網址；單一伺服器資訊通常包含協定、位址、連接埠及相應的驗證參數，兩者用途不同。

已有訂閱連結：選擇 Subscribe

在 Add Server 的 Type 選擇 Subscribe，將自己已有的完整訂閱連結填入 URL。貼上後檢查連結前後是否有空格或換行，也要確認沒有只複製到部分網址。查詢參數也是連結內容的一部分，請勿為了縮短文字而刪除。可在備註欄標記不同設定來源，但備註僅供本機辨識，無法修正錯誤連結。確認後使用目前頁面的儲存或完成按鈕，返回 Home 並等待清單載入完成。

儲存成功不代表清單已成功載入。返回後應確認訂閱下方已出現實際伺服器項目，而不只是訂閱名稱。若清單空白或出現取得失敗提示，先確認網路能否連線至訂閱網址、連結是否仍有效，再向原有服務提供者確認訂閱狀態。此時反覆開關連線並不能補上缺少的項目。訂閱內容更新時，可使用該訂閱的更新功能重新取得；更新前請保留需要的本機備註，並確認沒有選取已移除的舊項目。

已有單一伺服器資訊：逐項填寫相應欄位

若取得的是伺服器參數，請在 Type 選擇與資料一致的協定，再填寫 Host、Port 等欄位。Host 填入伺服器網域名稱或位址，不要填入整段訂閱連結；Port 填入資料所列的連接埠。以 Shadowsocks 為例，Password 與 Method 都必須和伺服器端設定一致。其他協定可能有不同的驗證、TLS 或傳輸欄位，請依原始資料逐項填寫，不要將一種協定的參數套用到另一種表單。

核對時特別留意數字與字母、密碼前後的空格，以及 TLS 相關名稱是否與原始設定一致。若資料未提供某個欄位，先確認該協定是否要求填寫，不要照著網路上的其他範例猜值。頁面底部的 Scan QR Code 可用來讀取自己有權使用的設定 QR Code；Import from Cloud JSON 適用於相應格式的資料，並非將任意文字轉成可用設定的通用入口。初次使用時，建議一次採用一種匯入方式，較容易找出錯誤。

儲存後返回 Home，確認 SERVER 中出現可辨識的項目，並點選這次要使用的伺服器。訂閱可能包含多個項目，完成匯入不代表目前選取的項目一定正確。此時應已選好一台伺服器；接著再決定哪些請求要使用它。Subscribe 與 Config 的差異可參閱名詞速查。

返回 Home，點選 Global Routing，了解設定 (Config)／代理 (Proxy)／直連 (Direct) 的差異。此處選擇的是處理請求的整體方式，不是伺服器協定，也不是訂閱類型。切換後返回 Home，確認目前顯示的名稱，避免以為已選取新模式，實際上仍停留在上一種模式。

設定 (Config)：依目前設定檔比對規則

Config 會依據目前設定檔中的規則，決定請求採用的策略，例如 DIRECT、PROXY 或其他已定義的策略。使用前請進入 Config，確認目前使用的檔案，再查看其中的 Rule。不要只憑檔名判斷內容，也不要把「清單中有這個檔案」當成「這個檔案目前正在生效」。若規則引用特定策略或伺服器，也要確認目前設定中有相應項目。

截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定檔的不同區段。初次連線不必逐段編輯，也不需要為了連線而啟用所有相關功能。先使用自己了解且有權使用的設定，保留原始副本，確認基本請求可以通過後，再逐項新增所需規則。Add Rule 用於新增規則，不是新增伺服器的入口；伺服器項目仍應在 Home 管理。

規則順序會影響結果。若目標請求先符合 DIRECT，後面更具體的 PROXY 規則可能就不會再檢查。因此，「已選取伺服器但網站仍走直連」不一定是伺服器儲存失敗，也可能是 Config 的比對結果。此處先了解選擇與核對方式；規則關鍵字與更完整的設定說明，請參閱Settings 與規則參考，避免初次連線時同時修改複雜設定。

代理 (Proxy)：檢查所選伺服器的代理連線

Proxy 會讓通常由此模式處理的請求使用代理連線，可暫時排除規則選擇造成的干擾。它適合用來釐清一個較明確的問題：不依賴目前分流規則時，所選伺服器能否連上目標？這不是「解決所有問題」的開關，也不會自動修正密碼、連接埠或 TLS 欄位。完成比對後，若日常使用需要依規則分流，請切回 Config 並繼續核對規則。

直連 (Direct)：作為直連比對

Direct 使用直接連線，不應期待請求在此模式下透過所選伺服器代理。若要比較直連與代理的表現，可使用相同的目標位址，只切換模式後重新送出請求。每次只變更一個條件，才能判斷差異來源。選擇完成後，記下目前模式與伺服器名稱；接下來的連線與驗證都以此狀態為起點。

返回 Home，確認 SERVER 中選取的項目，並確認 Global Routing 是剛才選擇的 Config、Proxy 或 Direct。若剛才更新過訂閱，再檢查一次所選項目是否仍存在。初次測試時盡量維持網路穩定，不要在開啟連線的同時切換 Wi-Fi、修改設定或更新訂閱，以免無法判斷是哪個步驟影響結果。

開啟 Home 頂端的連線開關。首次建立連線時，系統可能會提示是否允許新增 VPN 設定。閱讀提示，確認是目前開啟的 Shadowrocket 發出的操作後，依系統要求允許並完成裝置驗證。此授權是讓 App 建立相應的本機網路連線；與購買 App、填寫訂閱連結及驗證伺服器密碼是不同步驟，彼此不能取代。

若先前取消授權，請返回 App 再試一次，並留意系統提示是否再次出現。不要為了通過授權而提供與目前裝置驗證無關的帳號資訊。若裝置受組織管理，相關限制可能會影響 VPN 設定的新增，請依裝置管理要求處理，不要不斷刪除現有設定。系統設定路徑可能隨系統版本不同，請以裝置實際顯示為準。

完成授權後返回 Home，等待連線狀態變更。官方截圖中的 Not Connected 表示截圖拍攝時尚未連線，並非要求 App 維持此狀態。實際操作時請確認開關維持開啟，且狀態變為已連線；若開關立即關閉或持續無法建立連線，請先查看本頁的常見問題，檢查授權與參數，不要把「連線尚未建立」當成規則錯誤處理。

連線狀態成立，只代表本機連線流程已進入相應狀態，無法單獨證明某個網站是透過 PROXY 連線，也不保證遠端服務可用。反之，看到系統 VPN 圖示，也不能據此判斷每個請求的最終策略。接下來需透過 Connectivity Test、實際瀏覽與請求記錄交叉驗證。完成初次驗證前，先不要新增 On Demand 等自動化設定。

清單沒有內容：先檢查訂閱取得

若 Home 中尚未出現可選的伺服器，請檢查 Subscribe 的 URL 是否完整、訂閱請求是否回傳錯誤，以及自己已有的訂閱是否仍可使用。確認取得完成後再選取項目。訂閱取得失敗與伺服器連線失敗應分開處理；不要混用伺服器的 Host 與訂閱 URL，也不要將含有驗證參數的連結貼到公開討論區。請向原有服務提供者確認資訊是否有效，App 購買紀錄無法取代這項確認。

項目存在但無法瀏覽：重新檢查 Type 與驗證欄位

開啟該項目的編輯頁，依原始資料逐項核對 Type、Host、Port 與驗證欄位，再檢查該協定所需的傳輸與 TLS 參數。只修改已確認不一致的欄位，儲存後使用相同目標重新測試。不要把關閉憑證驗證當成通用排錯方式；憑證名稱、系統時間與設定資料應分別核對。若所有欄位均一致但仍無法連線，請記錄目前網路與錯誤狀況，再判斷是否需要伺服器端狀態資訊。

連線開關無法維持開啟：檢查授權與自動連線條件

若連線尚未建立就自動關閉，先確認系統是否允許新增 VPN 設定，以及是否有其他已啟用的網路設定影響目前連線。Settings 中的 On Demand 用來依條件觸發連線，無法修正錯誤的伺服器參數。若已設定 On Demand，排查時先確認目前條件是否會觸發自動連線或改變預期行為；完成基本手動連線驗證後，再依實際需求設定。相關說明請參閱On Demand 參考。

測試與實際瀏覽結果不一致：檢查測試方法與請求記錄

Settings 中的 Test Method 會影響測試方式。比較前後結果時，請維持相同的測試方法；更換方法後結果有所不同，不應立即解讀為伺服器效能改變。若需進一步分析，可查看 Diagnostics 相關入口，並參考 Log 中的實際錯誤。Language、Today Widget 等設定並非修正驗證失敗的必要步驟；Proxy、TCP、UDP 下的設定也不宜在缺乏明確依據時一次修改多項。

若只有某個網域無法連線，優先檢查該請求命中的規則、DNS 結果與目標本身的狀態；若所有請求都失敗，先回頭檢查連線與參數。尤其是 Proxy 可用、Config 不可用時，應先找出設定差異，而非立即重新填寫訂閱。每次修改後，都以步驟四的基準重新驗證；確認改善可重複出現後，再保留這項修改。

分享排錯資訊前：移除敏感內容

可以記錄問題發生的步驟、目前模式、使用的協定、錯誤訊息及是否能穩定重現，但不要公開完整訂閱連結、密碼、驗證識別資訊或含有個人資料的設定檔。截圖與記錄也可能包含這些內容，分享前請逐項檢查。保留原始設定副本，避免連續嘗試修改後失去可還原的起點。更多情境說明請參閱疑難排解；需要逐項了解 Settings 時，再前往選項手冊。