Shadowrocket 入門指南：
匯入、連線與驗證

步驟 01 / 輸入連線資料

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

開啟 Shadowrocket，進入 Home，查看下方的 SERVER 分組。首次使用且尚未新增伺服器時，先點選 Add Server；若入口顯示為新增按鈕，進入後請確認頁面標題是否為 Add Server。接著依手上的資料選擇一種方式：明確列出的伺服器參數適合手動填寫；由使用者自己的服務商提供的訂閱網址，則適合透過 Subscribe 匯入，不必重複操作兩種方式。

手動填寫：先選 Type，再確認欄位

在 Add Server 中先選擇 Type，使其與資料中的協定一致，例如 Shadowsocks、VMess、VLESS 或 Trojan。Type 會影響後續需要填寫的欄位，因此不要先填完再任意更換協定。右側官方截圖展示包含 Host、Port、Password、Method 的表單；其他 Type 的欄位可能不同，請依相應協定資料填寫，不要照著截圖填滿所有項目。

Host 填入伺服器主機名稱或 IP 位址，Port 填入連接埠，Password 填入服務資料指定的密碼；若出現 Method，請選擇與伺服器一致的方法。主機名稱不要包含空格、網頁路徑或說明文字，連接埠也不要連同冒號一起貼上。協定要求的其他身分、傳輸與 TLS 參數也必須一致，不能因為頁面允許留白，就認定伺服器不需要這些資料。填寫完畢後儲存，回到 Home 檢查 SERVER 中是否出現剛才的項目。

已有訂閱：透過 Subscribe 匯入

如果取得的是訂閱連結，請在 Add Server 的 Type 中選擇 Subscribe，填寫介面要求的訂閱網址並儲存。請完整複製連結，尤其注意末尾參數是否缺漏，以及複製時是否帶入換行。儲存後回到 Home，等待內容取得完成，查看是否出現訂閱分組及其中的伺服器；若目前版本需要手動更新，請在該訂閱的操作入口執行更新。看到訂閱名稱不代表伺服器內容已成功取得，仍須檢查分組中的實際項目。

訂閱連結可能包含存取憑證，請勿放入公開截圖、聊天記錄或排錯文章。頁面中的範例網域也不是可用服務，不能取代使用者自己的資料。Add Server 底部的 Scan QR Code 可用來掃描使用者已有的伺服器 QR Code；Import from Cloud JSON 適用於相應格式的資料，不要將一般訂閱連結任意放入此入口。資料形式不同，應選擇相應的入口。

完成此頁後，請先確認 Home 至少有一個可選擇的伺服器，再繼續設定 Global Routing。此時先不要調整多個進階選項；若匯入失敗，請先檢查網址與網路，詳細問題可前往疑難排解繼續檢查。

步驟 02 / 決定如何處理請求

Global Routing：選擇分流模式

新增伺服器後，回到 Home 開啟 Global Routing。這裡決定請求採用哪一種整體處理方式，與選取哪台伺服器是兩回事：伺服器項目提供連線參數，Global Routing 則決定請求是否以及如何使用代理。先了解設定(Config)、代理(Proxy)、直連(Direct)三種模式，再開始連線，可避免將模式選擇問題誤認為伺服器參數錯誤。

• 設定(Config)：依目前設定檔中的規則決定策略。不同請求可能分別使用 PROXY、DIRECT 或 REJECT，並非所有請求都會經過代理。
• 代理(Proxy)：以代理方式處理流量，適合在基本連線排查時與 Config 對照。這不代表規則設定正確，也不能保證每個目標都可存取。
• 直連(Direct)：直接連線至目標，不經過代理伺服器。可用來確認目前的基本網路，但網頁能開啟並不能證明代理連線有效。

日常使用希望依規則分流時，請選擇 Config，然後開啟 Config 查看目前使用的設定檔。請注意，「清單中有檔案」與「已選取該檔案使用」並非同一件事；應確認目前生效的項目，再進入相應內容查看。官方截圖展示設定檔編輯頁的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段，初次使用先查看 Rule 即可，不必同時修改所有區段。

進入 Rule 後，請由上而下閱讀規則。具體條件應放在能夠比對到的位置，FINAL 通常放在末尾，為前面未命中的請求提供最終策略。以下僅為語法閱讀範例，並非要求覆蓋現有設定：第一條讓範例網域使用 PROXY，第二條讓指定的私有位址範圍使用 DIRECT，最後一條提供預設策略。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

如需透過 Add Rule 新增規則，請先備份原設定，再確認類型、比對內容與策略；儲存後確認仍選取要使用的檔案。首次驗證不建議直接匯入大量來源不明的設定；規則變更會改變請求路徑，讓問題更難定位。關於比對順序的說明，請參閱規則順序與 FINAL 說明。確認設定後，回到 Home 進行連線。

步驟 03 / 建立系統連線

在 Home 開啟連線

回到 Home，在 SERVER 中選擇準備使用的伺服器，並確認選取標記位於預期項目上。訂閱中可能有多個名稱相近的項目，不要只記住清單位置；更新後清單可能變動，應重新確認目前的選擇。接著檢查 Global Routing 是否為剛才決定的模式，避免上次排錯留下的 Direct 設定影響本次判斷。

點選 Home 頂端的連線開關。首次建立連線時，系統可能會要求允許新增 VPN 設定；請閱讀提示，確認操作是由剛開啟的 Shadowrocket 發起後，依裝置要求完成授權或身分驗證。此系統權限用於建立網路通道，不會替使用者產生伺服器資料。如果拒絕提示，App 可能無法進入正常連線狀態，需要重新觸發連線並完成授權。

完成授權後返回 Home，查看頂端狀態是否從 Not Connected 轉為已連線。若開關短暫變化後又關閉、系統提示未完成，或狀態持續不如預期，都不應直接改動 DNS。請先確認授權確實完成、目前網路可用，並檢查是否有其他 VPN 連線影響本次連線。排查時先停用其他連線，再單獨測試 Shadowrocket，不要同時改變多個網路條件。

開啟連線開關只表示系統連線流程已建立至相應階段，不代表所有伺服器、網域或 App 都已通過驗證。下一步仍須執行 Connectivity Test，並在瀏覽器中檢查實際請求。若要停止使用，請回到 Home 關閉頂端開關；首次驗證階段先以手動開關控制，結果穩定後再考慮 On Demand。

步驟 05 / 每次只修改一項條件

依失敗狀況檢查 Settings

前四個步驟仍未得到穩定結果時，請先依狀況定位，再進入 Settings。這裡可以查看 Language、Test Method、On Demand、Diagnostics 以及 Proxy、TCP、UDP 等項目。它們各有不同用途，沒有適用於所有連線的統一設定方式；不要因為某個開關可以調整，就認為首次使用必須開啟。

沒有匯入內容：先檢查訂閱取得過程

回到 Home 檢查訂閱網址是否完整，以及分組是否已取得伺服器內容。若基本網路無法連線至訂閱網址，即使儲存訂閱名稱也無法取得清單。若使用者自己的服務資料已變更，請重新確認網址與有效狀態；匯入成功後，也要確認選取的不是舊項目。不要為了排查而刪除所有設定，請先保留原有記錄以便比較變化。

可以匯入但連線失敗：確認參數與網路

開啟相應項目的編輯頁面，逐項比對 Type、Host、Port 與身分資訊是否符合原始資料。密碼中的大小寫、末尾空格以及協定專屬參數都可能影響結果。先在目前網路測試，再於條件允許時切換另一種網路重新測試；若狀況隨網路改變，請優先檢查網路環境。不要同時修改伺服器欄位與設定規則，否則無法判斷是哪項變更造成影響。

測試與瀏覽結果不同：檢查測試方式與解析

在 Settings 查看 Test Method，確認本次使用的測試方式，再回到 Home 重新執行 Connectivity Test。不同測試方式檢查的環節不同，因此結果不能直接混在一起比較。測試正常但網頁無法開啟時，請分別檢查網域解析、目標可連線性與規則比對；將修改範圍維持在最小，避免同時更換 DNS、規則與伺服器。

連線自動恢復或反覆變動：檢查 On Demand

若關閉連線後又自動開啟，請先檢查 On Demand 是否已啟用，以及條件是否符合目前網路。首次排查時可暫時關閉自動觸發功能，使用 Home 的開關手動重複測試。問題處理完成後，再依自己的網路使用習慣設定 On Demand；它控制連線觸發條件，不會修正填錯的伺服器資料。

仍未解決：整理可重現的資訊

透過 Diagnostics 查看目前版本提供的診斷資訊，記錄失敗發生的步驟、目前模式、測試方式，以及是否只影響單一目標。分享資訊前，請遮蔽訂閱連結、密碼和個人存取記錄。單項參數、系統授權及其他失敗情況，請前往疑難排解依分類繼續檢查；App Store 取得與已購項目復原問題，則請閱讀安裝指南，不需要在網路排錯時重新購買用戶端。

排查完成後，回到步驟四再進行一輪驗證，並恢復預期的 Config、伺服器選擇與自動連線設定。保留一份已驗證可用的設定備份，後續調整時逐項記錄修改內容；遇到新問題時，就能回到已知狀態，而不必從頭猜測。