Shadowrocket 官方手冊
Shadowrocket 使用指南
匯入既有訂閱 → Global Routing → 首次連線 → 生效檢查。先完成一條可用連線,再調整規則與自動連線條件。
Add Server:新增伺服器與訂閱
開啟 Shadowrocket,先停留在 Home。下方的 SERVER 用來顯示伺服器與分組;首次使用時,這裡可能還沒有項目。點選 Add Server 進入新增頁面。接著只選擇一種符合現有資料的方式:完整訂閱連結請使用 Subscribe;單一伺服器的位址、連接埠與密碼請手動填寫;已有 QR Code 則使用掃描入口。不要以不同方式重複匯入同一份資訊,以免產生難以辨識的重複項目。
已有訂閱連結:選擇 Subscribe
在 Add Server 中開啟 Type,選擇 Subscribe,再將完整訂閱連結填入該類型的連結欄位。貼上後先檢查開頭與結尾是否多出空格或換行,尤其不要漏掉問號後方的參數。訂閱連結與一般網頁網址並不相同:能在瀏覽器開啟介紹頁面,不代表該網址可用於匯入。請使用既有服務提供的訂閱網址,不要自行從網頁標題或分享說明拼湊連結。
儲存後返回 Home,等待清單讀取完成;如果出現訂閱分組,請展開並確認其中確實有伺服器名稱。只有一個訂閱名稱、底下沒有伺服器,並不代表匯入完成。請先嘗試更新該訂閱,再檢查網路與網址是否有效。更新會讀取遠端內容,可能會取代該訂閱下的伺服器欄位;需要保留的手動修改請先記錄,長期整理方式請參閱伺服器管理手冊。
已有單一伺服器:逐項核對欄位
如果取得的是單一伺服器參數,請先在 Type 選擇相應協定,再依序填入 Host、Port 與該協定要求的驗證資訊。Host 通常填寫主機名稱或 IP 位址,不要連同網頁路徑一起填入;Port 請填寫相應連接埠。Password 請保留原有的大小寫與符號;只有所選協定需要 Method 時,才依原始資料選擇,不要因名稱相似就自行替換。不同 Type 的欄位會有所變化,截圖中的欄位不適用於所有協定。
如已有 QR Code,可點選 Scan QR Code,依系統提示授予相機權限後掃描,再檢查解析出的協定與欄位。Import from Cloud JSON 是另一種指定格式的匯入入口,不適合隨意貼上一般訂閱連結。儲存完成後,回到 SERVER 選取目標伺服器;先確認名稱與重要欄位正確,再進入下一步選擇流量處理方式。
Global Routing:選擇三種模式
伺服器出現在清單後,回到 Home 點選 Global Routing。這裡決定流量整體的處理方式,不負責補齊伺服器參數,也不會修復失效的訂閱。初次使用最容易混淆的是:選取伺服器、選擇路由模式、開啟連線開關,是三個獨立操作。清單中有伺服器,不代表目前流量已經經過該伺服器。
- 設定檔(Config):依目前啟用的設定檔比對規則。不同目標可能分別使用 PROXY、DIRECT 或 REJECT,適合需要依規則分流的情況。
- 代理(Proxy):以代理方式處理流量,適合暫時檢查所選伺服器是否具備基本連線能力。這不是可以取代所有規則檢查的永久排錯開關。
- 直連(Direct):使用本機網路直接連線至目標。適合確認直連基準;選擇此模式時,不應將網頁可以開啟解讀為代理伺服器已可正常使用。
準備依規則使用時,選擇設定檔(Config),再進入 Config 頁面確認目前啟用的檔案。Global Routing 中的 Config 是一種路由模式;底部的 Config 頁面則用來管理設定檔,兩者名稱相同但用途不同。截圖中的 General、Rule、Hosts 等是檔案中的不同設定區段;不要只因檔案存在,就假定其中的規則符合目前需求。
初次連線不必立刻編輯規則。如果只想確認伺服器是否能連線,可暫時選擇代理(Proxy),完成第四步的基本檢查後再恢復設定檔(Config)。如果 Proxy 可用而 Config 下某個目標無法使用,請優先檢查該目標的規則去向,而不是重新新增同一台伺服器。修改前請記下原本的模式與設定檔,以便還原。
Add Rule 用來新增規則,不是新增伺服器。像 DOMAIN-SUFFIX,example.com,PROXY 這類項目會依網域後綴選擇策略,DIRECT 則表示直接連線。此處只需了解規則會改變目標的連線去向,不要為了照著截圖操作而新增範例規則。規則順序、訂閱與設定檔的差異可繼續參閱常見問題,先維持目前設定並完成連線。
Home:開啟開關並完成系統授權
回到 Home,在 SERVER 中確認已選取準備使用的伺服器,再確認上方 Global Routing 是否維持剛才的選擇。如果清單中有多個名稱相近的項目,請先透過備註或詳細參數辨別,不要同時切換伺服器與修改設定。確認後開啟頁面頂部的連線開關;未連線時會看到 Not Connected 狀態提示。
首次開始連線時,系統可能會要求允許新增 VPN 設定。請閱讀彈出視窗中的 App 名稱與權限說明,確認操作由 Shadowrocket 發起後選擇允許,並依裝置提示完成密碼或生物辨識驗證。授權過程中可能會暫時離開 App,完成後請返回 Home 檢查狀態。如果剛才選擇取消,請重新開啟連線開關以發出請求,不要反覆刪除伺服器清單。
連線建立後,頂部狀態會隨之變化;系統也可能在狀態區域或控制中心顯示 VPN 標誌,實際位置取決於裝置與系統版面。這個標誌表示系統連線設定已啟用,不能單獨證明每台伺服器或每個網域都能存取。此時先不要開啟更多自動化選項,直接進入下一步進行實際檢查。
如果開關立即返回關閉狀態,請先記下情況發生在授權前還是授權後。授權前通常應先確認系統權限流程;授權後則繼續檢查伺服器、設定檔與基本網路。如果裝置上有其他正在執行的 VPN 連線,請先結束原有連線再測試,避免將連線遭取代誤判為匯入失敗。由組織管理的裝置也可能限制 VPN 設定,遇到明確的管理提示時,請依裝置管理要求處理。
Connectivity Test:確認是否生效
連線開關保持開啟後,在 Home 使用 Connectivity Test 檢查伺服器的測試結果。測試需要時間,請先等待本次測試結束再操作。看到結果後,應將其視為特定測試方法下的連線回饋,而不是對頻寬、穩定性或所有目標存取能力的保證。個別伺服器沒有回應,也不代表訂閱中的所有項目都無法使用。
接著開啟瀏覽器,造訪實際需要使用且可確認網址正確的目標。可重新載入頁面或使用新的瀏覽視窗,減少既有快取對觀察結果的影響。先驗證一個目標,再驗證另一個不同的目標;如果只有某個 App 異常,請優先比較該 App 與瀏覽器的狀況,不要立刻認定整個連線失效。
在設定檔(Config)模式下,部分目標原本就會走 DIRECT,因此「網頁可以開啟」不足以確認該要求使用了代理。需要搭配目前設定檔中的規則判斷連線去向;如果可以查看 App 內的連線記錄,可依目標主機名稱核對比對結果。記錄中出現要求,也不代表遠端已完整傳回頁面,仍需搭配實際存取結果判斷。
如果需要建立對照,可記下原本模式,暫時切換至代理(Proxy),造訪同一個目標,然後恢復設定檔(Config)。兩種模式的表現不同時,通常應沿著規則去向繼續檢查;兩者都失敗時,請先檢查所選伺服器與網路。每次對照都維持相同目標、相同網路與相同伺服器,避免同時改變太多條件而失去判斷依據。
Settings:依序排查問題
如果無法完成前面的檢查,請先保留目前設定與狀況,再依下列順序找出問題。不要同時更換訂閱、伺服器、DNS 與規則;同時變更多項設定,即使恢復連線,也難以判斷真正原因。記下「哪一步失敗、使用哪種網路、哪種模式、哪個目標」,通常比連續重新安裝更有幫助。
清單為空或訂閱更新失敗
先關閉連線,確認裝置目前的網路可以正常使用,再檢查訂閱連結是否完整、是否仍在有效期限內。一般分享說明、網頁網址與 Subscribe 所需網址可能不是同一種內容。如果訂閱可以更新但沒有伺服器,請檢查是否有收合分組或篩選狀態;仍然為空時,應向既有服務的維護者確認回傳內容。不要以重複新增來覆蓋錯誤,請先保留原有項目與必要的錯誤資訊。
伺服器存在,但測試失敗
開啟該伺服器的詳細資料,依原始資料逐項比對 Type、Host、Port 與驗證欄位。不同協定所需欄位也不同,不能只憑伺服器名稱判斷參數相同。確認後可選擇另一台既有伺服器進行對照,再嘗試切換 Wi-Fi 與行動網路;使用行動網路時,請留意自己的流量用量。如果只有目前的網路失敗,排查重點應轉向網路環境,而不是反覆修改密碼。
在 Settings 中查看 Test Method。不同測試方法檢查的環節不同,變更方法後出現不同結果並不矛盾。請保留實際存取驗證,不要只追求某個測試項目顯示數值。關於測試逾時與實際可存取之間的差異,請參閱常見問題中的連線排查說明。
連線成功,但部分目標失敗
先確認目前不是直連(Direct),再比較代理(Proxy)與設定檔(Config)模式下同一目標的狀況。如果只在 Config 下失敗,請回到 Config 檢查目前啟用的檔案與規則順序,確認沒有將需要代理的目標交給 DIRECT 或 REJECT。如果是網域無法解析,請再檢查 DNS 相關設定;不要直接匯入整份自己不了解的設定檔來取代原檔案。詳細的清單整理與設定檔備份流程請參閱伺服器管理手冊,本頁先進行最小範圍的排查。
手動連線可用,自動連線異常
On Demand 會依據設定條件觸發連線。初次使用時請先維持手動連線,基本存取穩定後再設定自動條件;如果出現剛中斷又重新連線、切換網路後狀態改變等情況,請確認是否已啟用 On Demand。需要排錯時,先記下原有條件,再暫時停用並進行對照,避免將自動觸發誤認為頂部開關失效。
Diagnostics 可用於進一步查看診斷資訊。對外說明問題前,請先移除訂閱網址、密碼與其他驗證內容,只保留必要的錯誤文字、網路類型與操作順序。排查結束後,請恢復暫時切換的模式與測試設定;如果連線已可使用,就不必繼續變更 Settings 中的 Proxy、TCP、UDP 等項目。