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

開啟 Shadowrocket 後進入 Home，找到 Add Server，也可以透過頁面上的新增入口進入同名頁面。不要只憑網址外觀選擇匯入方式：訂閱網址用來取得一組伺服器資訊，單一分享連結通常描述一台伺服器；Host、Port、Password 等參數則需依相應的 Type 填寫。先確認既有資料的類型，避免把訂閱網址誤填到 Host。

已有訂閱：使用 Subscribe

在 Add Server 中開啟 Type，選擇 Subscribe，將自己已有的完整訂閱網址填入相應欄位。複製時請保留網址結尾的參數，並檢查開頭與結尾是否多了空格、換行或說明文字。可填寫方便辨識的備註，以區分不同訂閱；備註只供本機辨識，不會改變遠端訂閱內容。確認後儲存，等待用戶端取得內容，再返回 Home 查看結果。

例如，https://example.com/sub?token=xxxx 僅為網址格式示例，無法用於實際連線。操作時請使用自己已有的網址。若儲存後只看到訂閱名稱，卻沒有可選的伺服器，請先確認訂閱是否已成功取得內容；不要連續重複新增相同網址。訂閱網址必須能透過目前網路存取；匯入尚未完成時，反覆切換連線開關無法補齊伺服器清單。

已有參數：先選 Type，再填寫欄位

手動新增時，請先選擇與資料相符的 Type，再填寫 Host 與 Port：Host 填伺服器網域或網址，Port 填服務端指定的連接埠。以截圖中的欄位為例，也要核對 Password 與 Method。不同協定會顯示不同欄位，這組欄位並非所有協定通用；例如需要 UUID、TLS 或傳輸設定的連線，請依既有資料核對相應項目。

不要憑經驗更換 Method，也不要只因為「看起來比較安全」就自行啟用與服務端不一致的選項。連接埠、驗證資訊與傳輸設定必須相互吻合；即使 App 允許儲存，也不代表遠端能接受這些參數。填妥後對照原始資料檢查一次，再儲存並返回 Home。

QR Code 與單一分享連結

已有 QR Code 時，可使用 Scan QR Code，並依系統提示授予這次操作所需的相機權限。辨識後先核對類型、網址與連接埠，再確認儲存。若要從剪貼簿匯入，請先只複製完整分享連結，再使用 App 提供的相應匯入功能；出現剪貼簿存取提示時，依實際需要確認。Import from Cloud JSON 適用於相應格式的資料，不應用來取代任意訂閱網址的匯入方式。

確認伺服器已出現在 Home 後，開啟 Global Routing。首次使用先認識三種常用模式：設定(Config)、代理(Proxy)、直連(Direct)。這裡改變的是連線處理方式，不是伺服器資料。切換模式不會自動修正錯誤密碼，也不會補上缺少的訂閱內容。

設定(Config)：使用目前設定檔中的規則

選擇 Config 時，連線會依目前使用的設定檔規則處理。部分目標可能交由 PROXY，部分可能使用 DIRECT，也可能命中 REJECT。因此，開啟連線後仍有部分請求直連，不一定表示設定失效；需依目標命中的規則判斷。進入 Config 查看目前設定檔，確認實際使用的是哪個檔案，而不只是確認某個檔案已儲存在清單中。

截圖中的設定編輯頁面包含 General、Rule、Hosts 等區段。可在 Rule 中查看規則；需要新增時才使用 Add Rule。首次連線不必逐段修改這些設定，尤其不應為了測試一般連線而更動 URL Rewrite 或 HTTPS Decryption。先保留用途明確的設定，基本連線成功後再逐項了解規則。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

代理(Proxy)：先確認伺服器是否可用

選擇 Proxy 後，用戶端可處理的連線會交由代理。首次排查時，這種模式能減少規則選擇造成的變數：先選取一台伺服器，再用同一個目標檢查連線。若在 Proxy 下可以正常存取，切回 Config 後卻失敗，應優先檢查設定檔與規則命中情況，而不是立即刪除訂閱。Proxy 不代表所有 App、所有系統流量都必然採用相同處理路徑；驗證時仍應觀察實際請求。

直連(Direct)：直接連線至目標

選擇 Direct 時，連線會直接存取目標，不透過伺服器轉送。此模式適合用來比較：目前網路能否直接開啟相同目標。若 Direct 可存取、Proxy 卻失敗，排查重點應放在所選伺服器或其參數。不要把 Direct 當成「自動選擇較快伺服器」的設定。選好模式後返回 Home，接著選取伺服器並開啟連線。

返回 Home，在 SERVER 群組中找到剛匯入的伺服器，點選項目左側的選取圓點，並確認標記位於目標伺服器旁。開啟項目的編輯頁面，不等於將該項目設為目前伺服器。即使清單中有多筆資料，首次檢查只需選取其中一筆，並記下備註，方便之後在相同條件下重新測試。

再次核對 Global Routing。若要檢查基本連線，可先使用上一步介紹的 Proxy；若已有明確的設定檔並要依規則使用，則選擇 Config。接著開啟 Home 頂端的連線開關。尚未連線時，頁面可能顯示 Not Connected；操作後觀察開關與連線狀態是否改變，不要只點一下就立刻切換到其他 App。

首次出現 VPN 設定提示時

首次連線時可能會出現系統新增 VPN 設定的提示。這是讓 Shadowrocket 在裝置上建立網路連線所需的系統授權，不是訂閱匯入提示。確認目前操作的是 Shadowrocket 後，依系統流程允許設定，並使用裝置要求的身分驗證方式完成確認。若先前取消了提示，返回 App 重新發起連線；系統提示尚未完成時，請勿反覆點選開關。

完成授權後返回 Home，確認連線開關是否維持開啟。系統 VPN 狀態表示相關網路設定已啟用，但不代表遠端伺服器一定可用。密碼錯誤、連接埠無法連通或規則指向錯誤，都可能要等後續請求才會顯現。因此，本步的目標是完成「選取項目、允許設定、維持連線」這三個動作；實際存取結果留待下一步驗證。

連線後先維持設定不變

開啟開關後，先不要同時更換伺服器、修改規則或切換網路。先用目前條件完成一次測試；若失敗，再依序調整單一變數。iPad 也採用相同的檢查順序，頁面配置以裝置實際顯示為準。App 購買紀錄與伺服器資料是不同內容；更換裝置後，即使已重新取得 App，仍須確認訂閱或伺服器資訊是否已匯入。

訂閱已儲存，但沒有伺服器

先返回訂閱資料，檢查網址是否完整，以及目前網路能否存取該訂閱。訂閱網址中的參數可能用於身分識別，少複製一段就可能導致取得失敗。請區分「儲存訂閱記錄」與「成功取得伺服器內容」：前者只是本機儲存操作。若既有資料明確提供有效期限或使用狀態，請核對自己的紀錄；不要把一般網頁網址當成訂閱，也不要將錯誤頁面的內容當作連線參數。

先修正原有項目，再重新取得內容，避免連續新增造成清單重複。若需確認回傳內容格式、更新方式或整理多筆訂閱，請參閱訂閱與伺服器管理手冊；完成後返回本頁的第三步繼續連線。

開關無法維持開啟

確認是否仍有系統 VPN 設定提示尚待處理，以及裝置身分驗證是否已完成。若系統網路設定中還有其他正在啟用的 VPN 設定，先確認目前使用的是哪一項，再返回 Shadowrocket 重試。受管理的裝置也應檢查裝置管理政策是否限制相關設定。此時先處理系統設定能否啟用的問題，不必立刻修改伺服器密碼或 Rule。

開關已開啟，但請求逾時

返回 Home 檢查選取標記，確認目前使用的是準備測試的伺服器，而非其他舊項目。手動新增的項目請再次核對 Type、Host、Port、驗證資訊，以及資料要求的 TLS 與傳輸選項。若是訂閱項目，優先重新取得既有訂閱內容，避免直接修改大量由遠端管理的欄位。接著使用 Proxy 對相同目標重新測試，判斷問題是否與規則無關。

若要改用自己已有的另一台伺服器，請保留原項目，每次只更換選取項目。必要時可在 Wi-Fi 與行動網路之間進行一次比較，但請記下網路變更；若同時更換網路與伺服器，就無法判斷結果對應的原因。

Proxy 可用，但 Config 下部分目標失敗

檢查目前實際使用的 Config 檔案與 Rule 順序，確認目標是否交由預期的 PROXY 或 DIRECT 處理。網域規則與網址規則的比對條件不同，目標解析後的連線也可能影響判斷。首次排查不必重寫整份設定；先找出與失敗目標相關的規則，再檢查後備規則。規則關鍵字、比對範圍與設定整理方式，請參閱訂閱手冊中的設定相關說明。

測試結果與瀏覽器顯示不一致

進入 Settings 查看 Test Method，確認目前的測試方式，再對照第四步的實際存取結果。Diagnostics 可用來查看進一步的診斷資訊，但閱讀記錄時需一併考量測試時間、目標與錯誤內容，不能只憑單一詞語判斷原因。分享診斷內容前，請移除訂閱網址、驗證參數及其他個人資訊；完整訂閱網址不應作為公開排查資料。

On Demand 與依條件連線的行為有關。若連線狀態會隨網路環境變化，請檢查自己是否設定了相關條件；尚未了解作用前，不要同時修改 Proxy、TCP、UDP 等設定。先建立可重複的手動連線結果，再處理自動連線需求。Settings 中的 Language 或 Today Widget 也無法修復伺服器驗證錯誤。