Shadowrocket 使用教學:
匯入、連線與生效驗證
先新增既有伺服器資訊,再選擇流量處理模式。連線後同時檢查測試結果與實際連線,不要只以開關狀態作為最終判斷。
Add Server:新增伺服器或匯入訂閱
訂閱連結和單台伺服器參數是兩種輸入方式。依照手邊資料擇一使用,不必重複新增。
已有訂閱連結:選擇 Subscribe
進入 Home(主畫面),點選右上角的新增入口,或在清單中點選 Add Server(新增伺服器),開啟伺服器編輯頁面。先點選 Type(類型),選擇 Subscribe(訂閱),再將使用者既有的完整訂閱連結貼到 URL 欄位。返回後檢查是否多出空格或換行,尤其不要連同說明文字一起複製;名稱或備註僅供辨識,可依個人管理習慣填寫。
確認後點選右上角的儲存或完成按鈕,返回 Home。若尚未出現伺服器記錄,請在相應訂閱項目的操作選單中執行更新,再等待匯入完成。訂閱項目是清單的來源,不等於一台可連線的伺服器;展開相應群組,確認其中已有具體項目,再進行後續選擇。若出現解析失敗提示,先確認連結是否完整,以及該連結傳回的內容是否確實為訂閱,而非登入頁面或一般網頁。
已有單台伺服器資訊:依協定填寫
同樣進入 Add Server,先在 Type 選擇資料中指定的協定,例如 Shadowsocks,再依序填寫 Host(伺服器位址)、Port(連接埠)、Password(密碼)。使用 Shadowsocks 時也應確認 Method(加密方式);其他協定若顯示額外欄位,應依既有資料逐項填寫,不能直接套用其他協定的欄位。位址欄位通常填寫主機名稱或 IP 位址,不要自行加上網頁路徑。
如果已有資料是 QR Code,可使用 Scan QR Code(掃描 QR Code)匯入,並在儲存前重新確認欄位。Import from Cloud JSON(從雲端 JSON 匯入)適用於相應格式的資料,不應將一般訂閱連結任意填入。完成後返回 Home,在 SERVER(伺服器)群組確認新項目的名稱與類型。此時只是儲存資訊,尚未開始代理連線;下一步需要決定如何處理流量。
訂閱連結、密碼和 QR Code 可能包含存取憑證。請勿將完整內容張貼到公開討論區;格式問題可先參閱FAQ,Subscribe 與設定檔的差異請見術語表。
Global Routing:選擇設定、代理或直連
伺服器決定流量傳送到哪裡,Global Routing 決定如何處理流量;兩者是不同設定。
返回 Home,點選 Global Routing(全域路由)查看目前模式。這裡的三個選項分別是設定(Config)/代理(Proxy)/直連(Direct)。不要只依名稱選擇:先確認目前是日常使用,還是暫時檢查伺服器是否可用。調整後返回 Home,確認 Global Routing 列顯示的內容已變更。
設定(Config):依目前設定檔處理
設定(Config)會依目前啟用的設定檔執行規則。進入 Config(設定檔),確認目前使用的檔案,再查看 Rule(規則)區段。規則符合後會採用相應策略;PROXY 表示交由代理策略處理,DIRECT 表示直接連線,REJECT 表示拒絕。更新訂閱清單只會更新伺服器資料,不代表已下載並啟用符合預期的分流規則。
初次使用不必立即改寫所有設定。先查看目前檔案是否包含需要的規則與預設處理方式,保留原始檔案,了解內容後再編輯。設定頁中的 General(一般)、Rule、Hosts(主機對應)、URL Rewrite(網址重寫)、HTTPS Decryption(HTTPS 解密)各有不同用途;完成基本連線不需要逐一啟用或修改,更不需要為了入門而調整解密設定。
代理(Proxy)與直連(Direct):用於明確比對
代理(Proxy)會讓用戶端接管的流量依代理模式處理,適合暫時檢查目前伺服器能否支援實際連線,但仍會受到系統網路與 App 行為影響。直連(Direct)會讓用戶端接管的流量直接連線,不經所選代理伺服器;可用於比對基礎網路狀態,但不能據此證明代理伺服器正常。比對結束後,請恢復實際需要的模式。
規則通常由上而下比對,前面的規則未符合時才會套用 FINAL(預設規則)。例如以下片段會讓 example.com 及其子網域使用 PROXY,其他請求則由 FINAL 指向 DIRECT。這只是語法範例,不是建議直接取代目前設定的完整檔案。若要了解設定檔結構、優先順序及更多規則類型,請繼續閱讀設定欄位參考。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
Home:選擇伺服器並開啟連線開關
先選擇項目,再連線;首次授權是系統建立 VPN 設定的步驟。
返回 Home,在 SERVER 群組點選準備使用的伺服器,確認目前的選取標記位於目標項目上。若有多個訂閱群組,先展開正確群組,再選擇具體伺服器;點選編輯按鈕和選取項目是不同操作,進入參數頁面後應先返回主畫面。接著再次確認 Global Routing,避免剛才排查時停留在直連(Direct)模式。
開啟 Home 頂端的連線開關。首次使用時,系統可能會顯示新增 VPN 設定的授權提示;閱讀 App 名稱和提示內容,確認後依系統要求進行裝置驗證。此步驟是允許系統建立本機 VPN 設定,不是新增訂閱,也不會補齊錯誤的伺服器參數。若取消授權,返回後開關可能會恢復關閉,請重新發起連線並完成授權。
返回 Shadowrocket,檢查頂端是否仍顯示 Not Connected(未連線)。若狀態已切換為連線,表示本機連線流程已啟動,但不代表遠端伺服器、DNS 或所有目標網站都正常。請勿快速連續切換開關;等待目前操作完成,再進行下一步驗證,才能更容易判斷每次連線的結果。
若系統提示已有其他 VPN 連線,先確認目前是否存在會影響路由的系統設定,避免多個連線互相干擾;受管理的裝置可能需要管理員允許。初次排查時建議先維持目前網路不變,不要一邊切換 Wi-Fi 與行動網路、一邊修改協定參數。結束使用時,可在 Home 關閉開關,並檢查系統連線狀態是否隨之結束。
Connectivity Test:搭配實際連線驗證
連線狀態、測試結果和目標請求是三個檢查面向,任何一項都不能取代其他兩項。
先測試,再開啟要使用的內容
在 Home 點選 Connectivity Test(連線測試),等待目前測試完成。測試結果會受 Settings 中的 Test Method(測試方法)及測試目標影響,有助判斷所選項目在該方法下是否可連線,但不能保證每個網站都能正常載入。單次逾時不足以直接判斷所有伺服器都無法使用,應搭配其他項目與實際連線結果判斷問題範圍。
接著切換到瀏覽器,重新載入原本要使用的頁面,觀察頁面正文、圖片與後續請求是否正常。盡量不要只看已快取的首頁;可重新開啟具體內容頁,以免將快取命中誤判為目前網路可用。若瀏覽器可以連線,某個 App 卻無法使用,先將問題範圍縮小到該 App 及其請求,不必立刻刪除所有訂閱。
使用設定(Config)時,額外檢查規則
返回 App,在 Data(資料)中查看目前版本提供的連線或請求記錄,核對目標網域、符合的規則及採用的策略。記錄有助區分「已連線但使用 DIRECT」與「已使用 PROXY 但請求失敗」。不要只根據出口表現推測規則,也不要將單一請求成功推論為所有流量都採用相同路徑。
需要比對時,可保持使用同一台伺服器與同一個網路,暫時切換到代理(Proxy)後重試相同目標。如果代理(Proxy)正常、設定(Config)異常,優先檢查啟用的檔案及規則順序;如果兩種模式都失敗,優先檢查伺服器參數或基礎網路。測試結束後恢復原定模式,並記下可重現的狀況,再進行下一步排查。
Settings:依範圍排除常見故障
每次只修改一項,並對相同目標重新測試;保留能說明前後差異的記錄。
清單空白或訂閱更新失敗
先檢查裝置本身能否連線至一般網頁,再確認訂閱連結是否遭截斷、是否仍有效。若服務提供者已更新資料,請使用自己的最新連結重新確認,不要反覆新增相同項目。既有伺服器可用但更新失敗,與所有伺服器都無法連線是兩種不同問題;請分開觀察,避免誤刪原本有效的項目。
單台連線逾時或連線後無法使用
如果只有一台失敗,優先檢查該項目的 Host、Port、協定類型及驗證參數。網域拼寫、連接埠數字和 Method 的差異都可能造成失敗;使用額外傳輸或 TLS 參數的協定,也需要確認相應欄位。接著檢查系統日期與時間是否正確。請勿任意關閉憑證驗證來掩蓋參數或時間問題。
若所有項目都失敗,先比較目前使用 Wi-Fi 與行動網路時的狀況,再檢查系統 VPN 授權和其他可能影響連線的系統設定。切換網路後先重新測試,不要同時修改伺服器欄位。連線後只有部分網域失敗,請返回 Global Routing 與 Config 檢查規則,並搭配請求記錄區分 DNS 解析問題、策略選擇與遠端回應。
查看測試方法、自動連線與診斷記錄
開啟 Settings(設定),在 Test Method 確認 Connectivity Test 使用的方法,避免直接比較不同測試方式的結果。On Demand(隨選連線)會依條件觸發連線;若出現關閉後又重新連線的情況,請查看是否已設定相關條件。初次手動驗證時,先確認目前條件是否生效,再決定是否調整。
需要進一步查明原因時,查看 Diagnostics(診斷)中的可用工具與記錄,並保留錯誤發生時的網路類型、模式和操作順序。分享診斷資訊前,請隱藏訂閱網址、密碼、QR Code 及可能識別個人身分的資訊。Proxy、TCP、UDP 等設定不需要為了「試試看」全部修改;不確定的選項請先維持原值。
若仍未解決,可依狀況前往FAQ 的安裝與連線問題繼續檢查;不清楚欄位含義時請查閱術語表;需要修改規則時再閱讀設定欄位參考。提供清楚的重現步驟,比一次修改多個開關更有助於找出問題。