Shadowrocket 使用教學

開啟 Shadowrocket 後先停留在 Home，暫時保持連線開關關閉。查看下方的 SERVER 分組：如果尚未有自己的伺服器項目，請開啟 Add Server。先確認手上的資料是哪一種：可用來更新伺服器清單的訂閱連結，或單一伺服器的協定、位址、連接埠與驗證參數。兩者的填寫方式不同，請勿將訂閱連結填入 Host。

已有訂閱：選擇 Subscribe

在 Add Server 中開啟 Type，選擇 Subscribe，再將完整的個人訂閱連結填入對應的 URL 欄位。連結應來自你已有的服務資料，複製時請保留完整路徑與查詢參數；聊天紀錄或文件中的換行、前後空格及中文標點，都可能造成讀取失敗。備註可用來辨識訂閱，可依用途自行填寫，但不會改變連線參數。

儲存後返回 Home，確認是否出現對應的訂閱分組與伺服器項目。如果只有分組名稱而沒有項目，請先確認連結是否完整，再嘗試更新該訂閱。成功匯入代表用戶端已讀取伺服器資料，不代表每台伺服器都能連線，也不代表服務仍在有效期限內。接著要實際選取一個項目，而不是只選取分組標題。

已有參數：依 Type 手動填寫

如果取得的是單台伺服器的資料，請在 Type 中選擇相符的協定，再逐項填寫。例如 Shadowsocks 常見欄位包括 Host、Port、Password、Method。Host 填寫主機名稱或位址，Port 填寫連接埠；Password 與 Method 必須與原始資料一致，請勿只因名稱相似就自行替換。其他協定可能有不同的驗證、傳輸或 TLS 參數；若不確定欄位含義，請先查閱名詞解說，不要套用其他協定的填寫方式。

QR Code 或分享連結也能用來匯入既有參數。在 Add Server 中，Scan QR Code 可用來掃描自己的 QR Code；透過剪貼簿匯入時，請先複製完整分享連結，再依 App 顯示的提示操作，儲存後重新確認 Type 與位址。Import from Cloud JSON 適用於相應格式的資料，並非通用的訂閱連結匯入入口。若資料格式不符，請改用 Subscribe 或手動填寫。

在 iPad 上，內容區寬度與清單排列可能和 iPhone 不同，但仍請先找到 Home、SERVER 與 Add Server。匯入完成後至少確認三件事：項目確實出現、類型與資料相符、需要使用的項目可以選取。先不要反覆大量新增相同訂閱；重複項目會增加後續判斷難度。確認好一組資料後，再前往 Global Routing。

新增伺服器後返回 Home，開啟 Global Routing。這裡決定請求採用哪種路由策略，與 SERVER 中選擇哪台伺服器是兩項不同設定。首次操作時請記下目前選項，避免連線失敗時同時更換伺服器與模式，導致無法判斷是哪個步驟影響結果。

配置 (Config)：依設定檔比對

選擇配置 (Config) 時，請求會依目前使用的設定檔及其中的規則處理。進入 Config 後，先確認實際選用的檔案，再查看 Rule 等區段。將檔案匯入 Config 清單，不代表它已成為目前生效的設定；請依 App 顯示的選用狀態確認。若已有確認可用的設定檔，先沿用原檔即可，首次連線前不必額外加入複雜規則。

規則通常包含比對條件與動作。PROXY 表示依相應的代理策略處理，DIRECT 表示直接連線至目標，REJECT 表示拒絕符合條件的請求；規則也可能引用特定策略名稱，需配合檔案內容確認。規則依序比對，因此較前面的條件可能先決定結果。FINAL 用來處理前面未符合的請求，其動作同樣會影響最終路徑。了解這些差異，才能判斷為何連線已開啟，部分存取仍採用直連。

代理 (Proxy) 與直連 (Direct)

代理 (Proxy) 會透過代理路徑處理請求，有助於區分「伺服器連線是否可用」與「規則是否符合預期」這兩類問題，但無法保證每個目標都能存取。直連 (Direct) 則使用直接連線路徑；如果目前目標需要透過代理連線，選擇直連 (Direct) 後無法開啟，並不能據此判定伺服器參數有誤。排查完成後，請恢復適合日常使用的模式。

初次驗證時，可先明確選擇一種模式，再以同一目標進行測試。已有可信任的設定檔並希望依規則使用時，請選擇配置 (Config)；若要暫時排除規則的影響，請記下原設定後切換至代理 (Proxy) 進行比較。不要因一次延遲測試成功，就長期使用不符合需求的模式，也不要將三種模式誤認為三台不同伺服器。

右側截圖呈現 Config 編輯畫面中的 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption。首次連線不需要逐項編輯這些區段，也不必為了完成本教學調整 HTTPS Decryption。確認目前設定符合預期後即可繼續。規則關鍵字與比對條件的詳細含義，請參閱規則與介面名詞解說；檔案管理請參閱訂閱指南。

確認路由模式後返回 Home，在 SERVER 分組中點選要使用的伺服器。先確認項目旁的選取標記，再檢查 Global Routing 是否仍為剛才確認的模式。訂閱中若有多個項目，先選擇資料明確且仍可使用的一個完成驗證；不要每次重新整理瀏覽器時都任意切換，否則前後結果無法比較。

接著開啟 Home 頂端的連線開關。未連線時會顯示 Not Connected 等狀態提示；開啟開關後請觀察狀態變化，不要只憑按鈕位置判斷是否成功。首次建立連線時，系統可能會顯示新增 VPN 設定的授權提示，請閱讀提示並依系統要求確認，必要時完成裝置驗證。此授權可讓 Shadowrocket 建立系統網路連線，但不會取代訂閱匯入，也不會自動補齊伺服器資料。

完成系統確認後返回 Shadowrocket，等待連線狀態更新。如果先前取消授權，請返回 App 重新發起連線並處理提示。不要連續快速開關反覆嘗試：先確認提示已處理且狀態穩定，再決定下一步。若裝置上另有正在運作的 VPN 設定，也請先確認實際啟用的是哪一個，避免將其他連線的狀態誤認為目前結果。

分別確認連線狀態與實際存取

開啟連線開關，表示用戶端正在建立或已建立相應連線，但尚不能證明目標網站、DNS 與所有協定流量都正常運作。此時應繼續下一步驗證，而不是立即大量修改 Settings。尤其使用配置 (Config) 時，部分請求依 Rule 選擇 DIRECT 是正常的策略結果，不能只憑單一頁面的出口表現判斷整體連線失敗。

切換至瀏覽器前，可以記下目前的伺服器名稱與 Global Routing。返回 Home 後若狀態已中斷，先查看是否有錯誤提示；若仍顯示已連線但網頁無法開啟，則歸類為「已連線但存取異常」，留待第五步依序排查。兩種狀況的檢查重點不同，先區分清楚可減少重複填寫參數。

本次先手動連線，暫時不要啟用 On Demand 自動觸發。手動驗證成功後再設定自動連線條件，比較容易區分系統觸發問題與伺服器問題。測試完成且暫時不需要連線時，可返回 Home 關閉開關；若之後已設定 On Demand，也要一併確認該設定是否會再次觸發連線。

遇到異常時，先依最簡單的順序檢查：裝置基本網路、匯入資料、目前選取項目、連線狀態、目標存取。不要一開始就刪除所有設定。若已有可用備份，請先保留；若沒有，至少記錄目前設定與錯誤訊息，再進行可還原的小幅調整。

匯入後 SERVER 沒有項目

確認選用的是 Subscribe，並檢查 URL 是否完整。訂閱網址與管理頁面網址不同；瀏覽器能開啟某個管理頁面，不代表該網址可直接匯入。若更新時出現錯誤，請記錄錯誤類型，並確認自己的服務狀態與連結是否有效；不要連續建立同名分組。若是手動新增，請返回 Add Server 確認是否已儲存，尤其留意必填欄位是否尚未填寫。

連線開關無法維持連線

先確認系統 VPN 設定授權已完成，再檢查所選伺服器的 Type、Host、Port 與驗證欄位。密碼有區分大小寫，連接埠必須與資料相符，協定的附加欄位也不能任意省略。接著確認裝置目前的網路本身是否可用；可暫時關閉連線，以常用頁面確認基本存取，再返回 Shadowrocket。切換網路進行比較時，請保留其他設定，避免同時變更太多條件。

測試有結果，但網頁無法開啟

先分辨瀏覽器顯示的是解析失敗、連線逾時、憑證問題，還是網站本身回傳錯誤。接著檢查 Global Routing：若配置 (Config) 失敗但代理 (Proxy) 正常，請優先查看目前 Config 的 Rule、策略引用與 FINAL；若兩種模式都失敗，則繼續檢查伺服器與解析相關設定。不要將所有錯誤都歸因於 DNS，也不要因一次測試正常就完全排除伺服器端的連線問題。

在 Settings 中可找到 Test Method 與 Diagnostics 等入口。Test Method 用於確認目前的測試方式；Diagnostics 可用來進一步查看診斷資訊，實際可用項目以 App 內顯示為準。請記錄測試時的網路、所選項目、路由模式與錯誤狀況，才能比較前後結果。DNS 涉及設定中的解析路徑與網路條件，請先了解目前設定，再針對問題調整；詳細術語請參閱DNS 與網路名詞解說。

只有部分目標失敗，或連線反覆恢復

只有特定目標失敗時，請檢查對應網域是否符合 REJECT、是否命中不合適的 DIRECT 規則，以及頁面資源是否來自其他網域。不要為了一個頁面刪除所有規則。若要進一步排查，請查看 Config 中實際的規則比對順序，並參閱功能與規則分流說明，了解各項動作的適用範圍。

若手動關閉後又重新連線，請查看 Settings 中的 On Demand 與相關觸發條件。自動連線只負責決定何時發起連線，不保證伺服器一定可連線。請先暫停相關自動觸發，完成手動測試後再逐項恢復；不要將「自動重新連線」與「已確認可用」混為一談。遷移、訂閱更新與批次刪除並非首次連線的必要步驟，操作前請先閱讀訂閱與伺服器管理手冊中的整理與備份說明。

依照本頁完成一次連線後，日常使用只需確認所選項目、Global Routing 與連線狀態。新增規則或啟用 On Demand 時，依照「小幅調整、實際驗證、保留可還原設定」的順序操作即可，不必每次都從頭匯入。