Shadowrocket 官方手冊 · 入門操作
Shadowrocket
訂閱匯入與連線教學
以 iPhone / iPad 介面為例，先加入既有伺服器，再選擇路由方式、開啟連線並驗證結果。首次操作依照以下五個步驟進行，複雜設定可等連線正常後再處理。
步驟 01 · Add Server / Subscribe
加入伺服器或匯入既有訂閱
開啟 Shadowrocket，進入底部的 Home。尚未加入內容時，先找到 Add Server；也可以透過頁面右上角的新增入口開啟相同表單。這裡有兩種方式：訂閱連結使用 Subscribe，單一伺服器資料則選擇相應的協定類型。先確認手上的資料用途，不要將訂閱網址直接填入 Host。
已有訂閱連結：選擇 Subscribe
進入 Add Server 後點開 Type，選擇 Subscribe。返回表單，在訂閱網址欄位貼上完整連結，再填寫方便辨識的名稱並儲存。網址應從開頭到結尾完整複製，特別要保留問號後方的參數；不要加入聊天訊息中的說明文字、引號、空格或換行。訂閱網址通常包含個人憑證，請像密碼一樣妥善保管。
儲存後返回 Home，等待訂閱內容載入，再查看 SERVER 下方是否出現相應分組與伺服器。若只看到訂閱名稱而沒有伺服器，先確認更新是否完成，以及是否出現錯誤提示，不要連續重複新增。重複匯入相同網址可能讓清單更難辨識，也無法修復已失效的網址。
已有伺服器參數：逐項填寫 Add Server
如果取得的是位址、連接埠、密碼及協定說明，先在 Type 選取正確的協定，再填寫 Host 與 Port。Host 只填服務商提供的主機名稱或 IP 位址；Port 填入對應連接埠。Password、Method 等欄位是否出現取決於所選 Type，並非每種協定都使用相同欄位。截圖展示的是其中一種欄位組合，切換協定後表單有所變化是正常情況。
例如 Shadowsocks 要確認 Method 與密碼是否相符；Trojan 的密碼與 TLS 相關設定也應依照原始資料填寫。若資料另列 SNI、傳輸方式或路徑，請進入對應設定核對，不能只憑連接埠推測協定。不確定欄位含義時，先查看術語表，參數值仍以自己的伺服器資料為準。
已有 QR Code 時，可在 Add Server 使用 Scan QR Code；掃描前需允許相機存取，掃描後仍應檢查辨識出的 Type、Host 與 Port。剪貼簿中若是單一分享連結，可依應用程式顯示的匯入提示處理。Import from Cloud JSON 是另一種結構化資料匯入入口，不等於一般訂閱網址輸入欄位，請勿混用不同格式。
本步完成標準：返回 Home 後，能在 SERVER 中找到準備使用的伺服器。清單中出現名稱只表示儲存或匯入完成，不代表已能成功連線；接著先選擇 Global Routing，再進行連線測試。訂閱更新、分組整理與批次管理請參閱訂閱與伺服器管理手冊。
步驟 02 · Global Routing / Config
選擇 Global Routing 模式
加入伺服器後，返回 Home，點開 Global Routing。這裡決定流量採用哪種路由方式，而不是決定訂閱如何更新。三種模式分別是設定(Config)、代理(Proxy)、直連(Direct)。開始前先確認本次要驗證的是「伺服器能否使用」，還是「自己的分流規則是否正確」，兩者的檢查目標不同。
設定(Config)：依設定規則處理
設定(Config)會依目前選取的設定檔進行比對。需要規則分流時，先進入底部的 Config，確認已有可用檔案並選取，再返回 Home 選擇設定(Config)。規則具有順序，通常由最先符合的規則決定該連線的處理方式；訂閱中有伺服器，不代表 Config 已設定好所需的所有策略。
官方截圖展示 Config 內的設定編輯頁面，可見 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段與 Add Rule。初次使用不需要逐項修改這些內容，也不要為了完成連線而開啟 HTTPS Decryption。若服務商提供自己的設定說明，應先確認適用範圍；不確定時請保留原設定，並在編輯前備份。
代理(Proxy)：減少規則影響以利排查
代理(Proxy)會讓目前由代理連線處理的流量採用代理路徑，適合在排查時暫時減少規則因素。選擇後仍需在 Home 選取可用伺服器，並開啟頂端開關；只變更 Global Routing 不會自動修正伺服器參數。若 Proxy 下可以造訪，而 Config 下只有部分目標失敗，接下來應優先檢查規則比對結果與策略指向。
直連(Direct)：不經遠端代理路徑
直連(Direct)用於透過直連路徑造訪，不適合用來證明遠端伺服器已可使用。不要把「開關已開啟但選擇 Direct」當成伺服器連線成功的證據。比較不同模式後，應恢復自己計畫長期使用的模式，避免排錯時的暫時選擇一直保留。
本步完成標準：返回 Home 時，Global Routing 顯示的選項符合預期。若選擇 Config，也應確認目前啟用的是哪個設定檔。DOMAIN-SUFFIX、GEOIP、FINAL 等規則詞的說明可在術語表查閱，本頁先不深入說明規則編寫。
步驟 03 · Home / SERVER
選取伺服器並開啟連線
返回 Home，在 SERVER 分組中點選本次要使用的伺服器，確認選取標記位於正確項目上。若有多個訂閱，先確認所屬分組，再核對伺服器名稱；剛匯入新訂閱不代表應用程式已切換到其中的伺服器。若設定使用獨立策略組，也要確認相關策略沒有指向失效項目。
確認 Global Routing 後，開啟 Home 頂端的連線開關。首次連線時，系統可能會要求加入 VPN 設定；確認這是剛開啟 Shadowrocket 所觸發的要求後，依系統提示允許，並完成裝置要求的身分驗證。這裡使用的是裝置本身的確認方式，不需要向訂閱服務商提供裝置解鎖資訊。
完成授權後返回 Shadowrocket，查看頂端狀態是否從 Not Connected 變成 Connected。若系統授權後開關仍關閉，可返回 Home 再開啟一次；若開關立即關閉或持續無法建立連線，不要快速反覆切換，先記下提示，再前往本頁的設定與排錯部分。
VPN 設定授權與伺服器驗證是兩回事。允許系統加入設定，只表示裝置允許建立這類網路連線；伺服器端仍須核對位址、連接埠與驗證參數。因此，Connected 是下一步驗證的起點，不代表所有網站、所有規則都已正常運作。
首次驗證建議暫時保持 Home 畫面開啟，等連線狀態穩定後再開啟瀏覽器。若準備切換伺服器或修改重要參數，請先關閉連線、儲存修改，再重新連線，方便確認目前測試對應的是哪一組設定。測試完成後若要停止使用，返回 Home 關閉頂端開關。
本步完成標準：已選取伺服器、完成系統授權，且 Home 顯示 Connected。接下來先不要修改設定，使用固定目標驗證實際造訪結果，以便遇到問題時區分連線建立與應用程式造訪兩個環節。
步驟 04 · Connectivity Test
驗證連線與實際造訪結果
保持剛才選取的伺服器與路由模式，在 Home 使用 Connectivity Test。測試用於觀察伺服器在目前網路中的連線狀況，結果會受 Test Method、網路環境與目標回應影響。出現時間數值不代表所有服務都可用；出現逾時也不能只憑一次結果就判定密碼錯誤，應配合後續的實際造訪結果判斷。
接著開啟瀏覽器，造訪一個自己確定正常、且符合本次測試目的的目標。使用新頁面或重新載入，避免只看到先前快取的內容。先用同一個目標完成一次檢查，再更換目標；不要同時切換無線網路、伺服器和 Global Routing，否則即使結果改變，也難以判斷是哪項設定造成影響。
如果目前選擇代理(Proxy)，請確認所選伺服器是否能正常完成造訪。如果目前選擇設定(Config)，還要判斷該目標預期應走代理還是直連：規則指定 DIRECT 的造訪成功，不能單獨證明遠端代理可用；預期走代理的目標失敗，則應繼續核對比對規則及對應策略。
需要比較網路因素時，先記錄目前狀態，再只改變一個條件。例如保持伺服器與設定不變，從無線網路切換到行動網路後重新測試。若同一伺服器只在某種網路下失敗，排查方向就與「所有網路都失敗」不同。不要只依延遲數字挑選項目，最後仍應以自己的實際造訪是否穩定為準。
本步完成標準：不只確認 Connected，還能說明哪些目標已成功造訪、使用哪種模式，以及測試時使用哪種網路。若結果不符合預期，保留這三項條件，依下一步縮小問題範圍；若已可正常使用，再整理名稱、調整分組並備份設定。
步驟 05 · Settings / Diagnostics
依故障範圍檢查設定
排錯時先從問題發生的步驟開始：尚未成功匯入，就先檢查網址與格式；看得到伺服器但測試失敗，就先檢查伺服器參數；顯示 Connected 卻只有部分目標無法正常造訪，再檢查路由與解析。每次只修改一個條件，並在修改後重複相同測試。如此能清楚掌握前因後果，避免連原本可用的部分也一起改亂。
訂閱匯入失敗或更新後清單為空
重新確認訂閱連結是否完整、是否多了空格，以及是否誤把單一伺服器分享連結當成 Subscribe 網址。若連結包含有效期限或存取憑證，請向自己的服務商確認目前狀態。不要公開貼上完整訂閱網址尋求協助，也不要連續建立同名訂閱；先保留現有記錄，再依錯誤提示處理。刪除前請先備份需要保留的自訂內容。
測試逾時或連線立即中斷
先確認裝置在關閉連線時能正常使用一般網路，再核對所選伺服器的 Type、Host、Port、驗證資訊及傳輸設定。若只有一項失敗而同組其他項目正常，通常應優先檢查該伺服器資料；若全部失敗，還要檢查目前網路、訂閱狀態與系統時間。TLS 相關連線需要正確時間，可在系統的日期與時間設定中確認自動設定，請勿以關閉憑證驗證代替診斷。
Connected 後只有部分目標異常
返回 Home 核對 Global Routing，確認沒有保留直連(Direct)。可暫時比較代理(Proxy)與設定(Config)的結果：若前者可用而後者失敗，請檢查目前 Config 是否選取正確檔案，以及規則引用的策略是否存在。若涉及 DNS 或特定應用程式的獨立網路行為，先閱讀相關術語，再調整設定，不要一次替換所有設定。
背景行為與 Settings 選項
進入底部的 Settings，可以看到 Test Method、On Demand、Diagnostics，以及 Proxy、TCP、UDP 等設定分類。Test Method 會影響 Connectivity Test 的測試方式，因此不同測試方法的數值不宜直接比較。On Demand 與符合條件時的自動連線有關，並非修正錯誤伺服器參數的開關；若手動中斷後又自動連線，請先檢查是否啟用了對應規則。
仍無法找出原因時，可使用 Diagnostics 查看可用的診斷資訊。記錄問題發生時的網路類型、Global Routing 選項、測試結果與提示文字，再判斷是否需要向自己的服務商詢問。分享截圖或記錄前，請遮蔽訂閱連結、密碼、個人位址及其他憑證；也應先檢查 SERVER 中的私人命名。
本步完成標準：能將問題定位在匯入、伺服器、系統連線或設定規則其中一類。若要進一步整理多個訂閱、更新策略、刪除與備份，請繼續閱讀訂閱與伺服器管理手冊；若只是不了解某個英文介面詞，使用術語表查閱即可，不必重做所有步驟。
