Shadowrocket 快速入門
新增、連線與驗證
從既有伺服器資訊或訂閱連結開始，依序完成匯入、選擇 Global Routing 模式與檢查連線。首次操作請依序閱讀；已完成匯入者可直接前往連線步驟。
開始前：使用者已安裝 Shadowrocket，並備妥自己的訂閱連結或伺服器資訊。iPhone / iPad 版從 App Store 取得，價格為 $2.99 一次性付費；Mac（Apple 晶片與 Intel）/ Windows / Android / Linux 版可從本站下載頁免費安裝。本教學以 iPhone / iPad 介面為例，系統需求以 App Store 頁面標示為準。
客戶端一次性購買 ≠ 連線服務方案。本站不提供、不銷售、不推薦節點或訂閱；以下僅說明如何匯入與使用使用者已有的設定。尚未安裝時，請先閱讀下載指南。
01 · Add Server：新增既有伺服器
開啟 Shadowrocket 後進入 Home，找到 SERVER 區域中的 Add Server，或使用頁面上的新增按鈕進入編輯頁面。先確認手邊資料的類型：如果是一組伺服器位址、連接埠、密碼與協定參數，請依本步驟填寫；如果是用來更新伺服器清單的訂閱連結，請直接閱讀下一步 Subscribe。兩種方式是不同的匯入途徑，不必重複新增同一份資料。
進入 Add Server 後，先點選 Type，選擇資料中明確標示的協定，例如 Shadowsocks、VMess、VLESS 或 Trojan。Type 會決定下方顯示哪些欄位，因此不要先填寫密碼再任意切換協定。以 Shadowsocks 為例，Host 填寫伺服器網域名稱或 IP 位址，Port 填寫連接埠，Password 與 Method 分別對應密碼和加密方法。不同 Type 的驗證欄位並不相同，應以既有資料為準，不能將某種協定的欄位照搬到另一種協定。
Host 通常只填寫主機名稱，例如 example.com，不要連同路徑一起填入完整網頁網址；Port 是獨立的數字欄位。複製長密碼時，請留意前後空格和換行；Method 應與伺服器端完全一致。若資料包含 TLS、SNI 或傳輸相關參數，也要逐項對應，不要為了減少填寫項目而關閉必要選項。不確定參數含義時，請先向原資料提供者確認，不要連續嘗試不同設定值。
如果已有伺服器 QR Code，可以使用 Scan QR Code 讀取，再檢查辨識後的 Type、Host 與 Port。Import from Cloud JSON 是另一個設定匯入入口，不是填寫任意訂閱連結的位置；只有持有相應格式資料時才使用。確認欄位後，點選頁面的儲存按鈕，返回 Home，檢查 SERVER 中是否出現新項目。項目出現只代表已完成儲存，還不能證明連線成功；接下來仍須選擇模式、開啟連線並進行驗證。
02 · Subscribe：匯入既有訂閱
如果手邊有自己的訂閱連結，請在 Home 進入 Add Server，點選 Type 選擇 Subscribe，再將完整連結貼到 URL 欄位。訂閱連結用來取得一組伺服器資料，通常包含個人存取憑證；不要公開貼在留言、截圖或聊天群組中。填寫方便自己辨識的備註即可，不需要修改連結中的查詢參數，也不要用服務供應商的登入網頁網址代替訂閱網址。
儲存後等待訂閱請求完成，再回到 Home 查看對應群組。匯入成功後，群組下會出現可選取的伺服器項目；如果只有群組名稱而沒有項目，應先檢查更新是否完成，不要立刻開啟連線開關。部分訂閱可能回傳錯誤訊息或不支援的內容，此時請確認複製的是完整訂閱連結，並檢查連結是否仍有效。匯入訂閱不等於匯入規則檔案，下一步仍須另外確認 Config。
之後需要更新清單時，使用該訂閱群組對應的更新操作，等待請求完成後再查看項目變化。伺服器清單取決於訂閱回傳的內容，本機手動修改可能會在下次更新時被覆蓋。若要長期保留個人調整，請先確認內容屬於訂閱項目、獨立伺服器還是規則設定，避免混淆三者。已有單一伺服器且不使用訂閱的使用者，可略過本步繼續操作。
如果顯示更新失敗，先確認裝置目前的網路可以連線至訂閱網址，再核對連結是否缺少部分內容或包含空格。不要反覆刪除後重建相同訂閱，以免遺失原本用來比對的狀態。訂閱可以更新，也不代表其中每個伺服器都能連線；選取伺服器後仍須進行後續連線檢查。更多異常分類請參閱常見問題中的連線排查。
03 · Global Routing：選擇模式與規則
儲存伺服器後，返回 Home，點選 Global Routing 查看路由模式。三種模式分別為設定(Config)、代理(Proxy)、直連(Direct)。這裡決定請求的處理方式，不是選擇伺服器協定；變更模式不會替使用者補齊伺服器資料，也不會自動修復過期訂閱。初次使用時，請先了解目前模式再連線，避免開關已開啟，卻誤判連線路徑。
| 模式 | 作用與使用前提 |
|---|---|
| 設定(Config) | 依照目前選取的設定檔比對規則，分別使用 PROXY、DIRECT 等策略；前提是已有適用的設定。 |
| 代理(Proxy) | 以代理方式轉送由客戶端處理的請求，適合暫時比對伺服器連線，不代表規則檔案正在分流。 |
| 直連(Direct) | 以直連方式處理請求，可用來比對本機網路，但不能用來證明伺服器代理連線正常。 |
日常需要規則分流時，先進入 Config 頁面確認有設定檔且已選取，再返回 Home 選擇設定(Config)。開啟設定檔可看到 General、Rule、Hosts 等區段；初次操作只需檢查 Rule 的策略是否符合自己的用途，不必同時修改 URL Rewrite 或 HTTPS Decryption。這些功能不是首次連線的必要步驟，不應為了嘗試連線而額外啟用。
Rule 中的規則通常由上而下比對，命中後使用對應策略。PROXY 表示使用代理策略，DIRECT 表示直連，REJECT 表示拒絕；FINAL 用於前面規則都未命中時作為預設處理。不要只看到 FINAL 就認為所有請求都會走相同路徑，實際結果仍取決於前面是否已有符合的規則。既有設定正常運作時，請先保持原狀完成連線；規則寫法與優先順序另請參閱Config › Rule 手冊。
如果暫時沒有規則設定，可用代理(Proxy)比對已知可用的伺服器，驗證後再處理分流設定。選擇模式後返回 Home，確認 Global Routing 顯示剛選取的模式，再進行下一步。每次排查最多只變更一個條件，才能分辨問題來自伺服器還是規則。
04 · Home：開啟開關並允許 VPN 設定
返回 Home，在 SERVER 中點選本次要使用的伺服器，確認已顯示選取標記，再檢查 Global Routing。不要把「項目已新增」與「項目已選取」混為一談；清單中有多個群組時，更要確認目前選取的是哪一組。連線前記下本次使用的伺服器和模式，後續測試才能有明確的比對條件。
開啟頁面頂端 Not Connected 所在列的連線開關。首次使用時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定，請依提示選擇允許，並使用裝置密碼或系統要求的驗證方式確認。此權限用於讓系統建立由 App 管理的網路連線，不是再次購買客戶端。如果當時取消授權，返回 App 後重新開啟連線，再依系統提示處理即可。
授權後返回 Shadowrocket，觀察頂端狀態是否已切換。如果開關立即關閉，或狀態一直無法進入連線狀態，請先停止連續點擊，改至排查失敗原因。如果系統上已有其他正在運作的 VPN 連線，也要檢查是否發生衝突，排查期間不要讓多個 App 反覆接管連線。若裝置管理政策有限制，請先確認裝置是否允許建立或使用此類設定。
建立連線狀態後，仍須繼續驗證實際存取情形。系統 VPN 標示只代表相關網路連線處於作用中，不能證明所有目標都能開啟，也不能取代 DNS 與規則檢查。需要主動中斷時，返回頂端關閉開關；若關閉後又自動連線，下一步應檢查 On Demand，而不是直接刪除所有伺服器資料。
05 · Connectivity Test：驗證是否生效
在 Home 點選 Connectivity Test，等待測試完成。先查看所選伺服器是否有可用的測試結果，再開啟瀏覽器瀏覽平時使用的網頁，確認頁面是否確實載入完成。Connectivity Test 的結果會受測試方法與目標影響，不能完整證明整條存取路徑都正常：測試可連線，不代表網域解析、網站憑證、登入狀態和所有 App 請求都正常。
建議在相同的本機網路下，用同一個頁面進行前後比對。先記錄連線開啟時的結果，再視需要中斷連線後重新測試；不要同時切換無線網路、伺服器、模式和 DNS，否則即使恢復正常，也很難判斷是哪項設定發揮作用。使用設定(Config)時，不同網域可能分別走 PROXY 或 DIRECT；直連頁面能開啟，不能證明代理策略對應的伺服器可用。
如果測試失敗但網頁可以正常使用，先查看 Settings 的 Test Method，確認測試方式符合伺服器支援情況，不要只憑一次結果刪除項目。如果測試有結果但網頁無法開啟，則檢查網域解析和規則；必要時暫時用代理(Proxy)與設定(Config)進行比對，完成後恢復預期模式。比對過程中維持使用同一個伺服器，避免把伺服器差異誤認為規則差異。
驗證通過後，保留這組可重現的設定，再逐項加入自己的規則調整或 On Demand 條件。正常使用不需要頻繁更換測試方式，也不應把單次測試數值視為長期表現。若想進一步了解測試與網頁瀏覽結果為何可能不同，請參閱連線相關常見問題。
06 · Settings：依現象排查失敗原因
先關閉連線，確認裝置本身可以正常上網，並完成目前網路可能要求的登入。接著依照「資料是否正確、能否建立連線、請求如何路由、網域能否解析」的順序檢查。每次只修改一項，重新測試後記錄結果；不要一開始就重新安裝 App 或清除所有設定，以免失去用來定位問題的資訊。
訂閱匯入失敗，或伺服器無法測試
先核對完整訂閱連結、有效狀態和目前網路，再檢查單一伺服器的 Type、Host、Port 與驗證欄位。手動新增時，常見錯誤包括協定選擇不符、密碼多了空格或遺漏傳輸參數。訂閱可以更新但單一伺服器無法連線時，應分開檢查更新網址與伺服器連線，不要認為更新成功就代表伺服器一定可用。
開關立即關閉，或中斷後自動重新連線
開關立即關閉時，請檢查系統 VPN 設定授權是否完成，以及是否有其他 VPN 正在占用連線。中斷後自動重新連線時，請進入 Settings 查看 On Demand；排查期間可暫時將其關閉，再手動連線測試。On Demand 會依條件建立連線，無法修復密碼、伺服器位址或規則內容；確認一般連線正常後，再依實際網路條件設定。
已建立連線，但網頁無法開啟
先檢查 Global Routing 是否誤選直連(Direct)，或 Config 中的規則是否將目標交給不符合預期的策略。如果代理(Proxy)可以存取、設定(Config)不行，優先檢查規則命中情況與設定選擇。如果兩種模式都失敗，再配合 DNS 和伺服器參數繼續判斷。不要把所有存取失敗都歸因於 DNS，也不要一次貼上多組未知的解析位址。
DNS 的具體位置與選項可能隨設定和平台介面而異，調整前請先記下原本的值；不了解覆寫關係時，維持目前設定，並依照Settings › DNS 手冊逐項核對。Settings 中還有 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等項目，各有不同用途，不應全部啟用。初次使用時只處理與目前現象直接相關的項目。
提供排查資訊前，先整理重現條件
需要查看 Diagnostics 或分享記錄時，請先重現一次問題，記下本機網路類型、目前模式、發生錯誤的步驟，以及是否所有目標都失敗。分享前請遮蔽訂閱連結、密碼、個人伺服器資訊與可識別的存取記錄。描述「可以匯入但無法連線」或「已連線且測試有結果，但特定網頁無法開啟」，比只提供一張開關截圖更有助於判斷問題。更多情況請前往連線排查 FAQ，設定項目的含義則請參閱選項手冊。
