官方手冊 · iPhone / iPad 操作範例
Shadowrocket 使用教學
從現有訂閱或伺服器資訊開始,依序完成新增、選擇 Global Routing、連線與驗證。先跑完一次完整流程,再調整規則和 On Demand。
- 新增與匯入
- Config / Proxy / Direct
- 連線與驗證
操作前提與步驟導覽
首次設定請依序閱讀;已有伺服器項目的使用者,可直接從模式選擇開始。
以下圖片為 App Store 官方截圖,用於辨識介面。截圖中的伺服器名稱或欄位值不是需要照填的連線資料;請以服務商提供的資訊為準。
新增伺服器或匯入訂閱
匯入訂閱和手動填寫是兩種方式,選擇符合手上資料的方式即可。
已有訂閱連結:選擇 Subscribe
開啟 Shadowrocket,進入 Home,在 SERVER 區域找到 Add Server,或使用頁面上的新增入口。進入新增頁面後,先查看 Type。若手上有訂閱連結,請將 Type 設為 Subscribe,再將完整連結填入 URL,並在備註欄寫下方便自己辨識的名稱。備註僅用於區分來源,不會改變伺服器的連線參數。
貼上前先檢查連結是否完整:通訊軟體中的換行、複製時帶入的空格、漏掉問號後的內容,都可能導致匯入失敗。訂閱網址通常包含個人存取憑證,請勿傳送到公開留言區,也不要放進他人可見的截圖。儲存後等待匯入完成,再返回 Home 查看 SERVER;出現一組伺服器項目,才表示用戶端已取得並解析訂閱內容。
如果儲存後沒有出現項目,先確認錯誤發生在下載連結還是解析內容。能在瀏覽器中開啟某個網頁,不代表該網址就是可用的訂閱網址;登入頁面、分享頁面與訂閱內容並非同一回事。此時請先向服務商確認連結用途和適用格式,不必反覆新增同一筆訂閱,以免之後難以判斷目前使用的是哪個項目。
已有伺服器參數:依 Type 填寫
若手上有位址、連接埠和驗證資訊,請在 Add Server 中選擇與資料一致的 Type。以 Shadowsocks 為例,需要逐項核對 Host、Port、Password 和 Method;切換至其他協定時,欄位會隨 Type 改變,請勿為了讓表單看起來相似而自行更換協定。Host 填寫伺服器位址,Port 填寫連接埠;Password 和 Method 都應與原始資料完全一致。
使用 TLS 的伺服器可能還需要填寫伺服器名稱等參數。請勿將整條訂閱 URL 填入 Host,也不要把網站的完整路徑當成伺服器位址。參數不齊時請先補齊資料,不建議任意關閉驗證來略過錯誤。掃描現有 QR code 可使用 Scan QR Code;Import from Cloud JSON 用於匯入設定,不能因為都包含連結就與 Subscribe 混用。
儲存後返回 Home,點選要使用的伺服器,確認選取標記位於預期項目上。匯入完成只是將資料寫入用戶端,尚未建立連線。接下來先決定流量要依規則、代理或直連處理,再開啟連線開關,遇到問題時會更容易定位。
選擇 Global Routing 模式
先確認模式,再確認規則。即使伺服器選對了,流量處理模式不正確,存取結果仍可能不如預期。
返回 Home,點開 Global Routing。首次使用時,請先區分三種模式:設定(Config)/代理(Proxy)/直連(Direct)。它們會控制用戶端接管的流量如何處理,不會替你補齊伺服器參數,也無法讓不可用的伺服器變得可用。測試時記下目前的選擇,避免切換後忘記恢復。
設定(Config):依目前設定進行比對
日常需要規則分流時,請選擇設定(Config),再進入 Config 確認使用的設定檔。開啟設定編輯頁面後,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。入門階段先留意 Rule 和目前設定的選取狀態,不必同時調整所有區段;尤其不要為了首次連線而變更與本次目標無關的 HTTPS Decryption。
Rule 中的規則依序比對,流量一旦符合前面的規則,就不會繼續交由後面的普通規則處理。以下僅用兩行說明「指定網域走代理,其餘直連」的結構。example.com 是說明用網域,不是伺服器位址;PROXY 是策略寫法,使用前應確認目前設定中有相應策略,且符合目標需求。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
這段範例的重點是順序:網域規則在前,FINAL 作為後備規則在後。若將 FINAL 提前,後續規則可能就沒有預期的比對機會。已有可用設定時不必照抄範例;若要新增規則,可從 Rule 區段進入 Add Rule,儲存後確認編輯的是目前實際使用的設定,而不是另一個同名檔案。
代理(Proxy)與直連(Direct):明確指定流量路徑
代理(Proxy)會讓用戶端接管的流量採用代理路徑,適合短時間檢查所選伺服器能否完成實際存取。直連(Direct)則採用直連路徑,不能用來判斷代理伺服器是否正常。兩者都不應被視為「自動修復網路」的開關;網站是否可連線,還取決於基礎網路、伺服器狀態和目標服務。
如果在 Proxy 下可以存取,而在 Config 下無法存取同一個目標,下一步應檢查規則命中情況與策略目標,而不是重新匯入訂閱。關於規則範圍和更進階的模式選擇,可繼續閱讀代理模式說明;首次使用時,先保留一份容易辨識且能還原的設定即可。
開啟開關並建立連線
連線前再確認一次伺服器選擇和模式;首次連線還需要完成系統授權。
完成前兩個步驟後返回 Home,檢查 SERVER 中選取的項目,再確認 Global Routing 是否為剛才選擇的模式。若清單中有多個相似名稱,請先點開項目核對位址或備註,不要只憑排列位置判斷。清單更新後位置可能改變,名稱相似也不代表參數相同。
開啟 Home 頂端的連線開關。首次使用時,iPhone 或 iPad 會顯示新增 VPN 設定的系統提示。閱讀提示並確認後,依裝置要求完成密碼或生物辨識驗證,再返回 Shadowrocket 查看狀態。此處授予的是在裝置上建立網路通道所需的權限,不是購買連線服務,也不代表已驗證所選伺服器可連線。
如果先前拒絕了系統提示,開關可能無法維持開啟。請重新啟動連線流程並留意系統彈窗,不要連續快速點按開關。若系統中已有其他 VPN 連線,請先關閉其他連線再重試,避免兩個連線同時爭用網路路徑。受管理的裝置可能受到組織設定限制,此類限制需由裝置管理方確認,反覆修改伺服器參數通常無效。
當開關能維持開啟,頁面也不再顯示 Not Connected 時,就可以進行下一步驗證。系統顯示 VPN 狀態只能表示通道已建立,不能單獨證明所有網站都會採用代理路徑。Config 下有些目標依規則直連本來就是正常情況,因此不要把「瀏覽器能開啟頁面」直接當成所有規則都正確的證據。
若開關剛開啟就立即關閉,先記錄是否出現授權提示或錯誤文字,再檢查系統權限與目前設定;若開關維持開啟但網頁無法開啟,請保留目前狀態進行驗證與排錯,不要同時刪除伺服器、更換設定和修改 DNS。將問題區分為「能否建立通道」與「連線後能否傳輸」,可減少重複操作。
iPad 的基本流程與 iPhone 相同。使用分割畫面或橫向畫面時,先確認焦點位於 Shadowrocket,完成系統授權後返回 Home 查看最終狀態;不要因為 App 切換到背景就認定授權失敗。要結束本次測試時,再返回頂端關閉連線開關。
驗證連線與分流結果
分開檢查伺服器測試、通道狀態與實際存取,才能判斷哪個環節成功。
先在 Home 點選 Connectivity Test,等待結果回傳。測試可用於發現明顯無法連線的伺服器,但某種測試通過不代表每個網站都能存取;某種測試失敗,也需要依測試方法解讀。不要只依結果中的數值大小判斷設定是否正確;首先要確認測試能否完成,以及結果是否穩定重現。
接著開啟瀏覽器,造訪一個原本就需要驗證的網站。首次驗證建議固定一個目標,記錄是否能載入、是否只有部分資源載入失敗,以及等待後出現什麼錯誤。頁面快取可能掩蓋路徑變化,切換模式後可重新載入頁面;若 App 保留既有連線,請關閉該次瀏覽後重新發出請求,而不是只查看已開啟的頁面。
在設定(Config)下,驗證還需包含規則方向。需要走代理的網域應命中相應代理策略;應直連的目標則應維持直連。如果頁面能開啟但路徑不符合預期,請返回 Config 檢查 Rule 順序與目標策略。一個頁面可能同時請求多個網域,只為主網域設定規則,不一定涵蓋頁面載入的其他資源。
為了縮小問題範圍,可保持同一個伺服器和測試網站不變,暫時將 Global Routing 從 Config 切換至 Proxy,再重新發起存取。若 Proxy 可用而 Config 不可用,優先檢查規則、DNS 與策略引用;若兩種模式都失敗,優先檢查伺服器參數和基礎網路。比較結束後請恢復原本模式,避免臨時測試設定變成日常設定。
最後進行一次基本對照:關閉 Shadowrocket 連線,確認一般網路本身能否存取日常使用的網站。若關閉後同樣無法連線,請先處理 Wi-Fi 登入、行動數據權限或網路本身的問題。完成對照後,再依原設定重新連線。每次只變更一個變數,比連續更換多項設定更容易確認是哪個步驟真正影響結果。
依失敗環節檢查設定
先找出失敗環節,再修改相應參數。入門階段不必逐一嘗試 Settings 中的所有開關。
匯入失敗:檢查連結與內容
若問題出現在第一步,先檢查訂閱連結是否完整、是否仍有效,以及目前的基礎網路能否存取該網址。已匯入的訂閱更新失敗,與現有項目失效並非同一回事;請先保留現有項目並記錄錯誤,再向服務商確認連結狀態。需要重新匯入時,先辨識舊訂閱名稱,避免將重複項目誤認為新增了不同伺服器。
手動新增後始終無法通過測試,請返回 Add Server,依序檢查 Type、Host、Port 和驗證參數。密碼中的大小寫、Method 選項,以及 TLS 相關名稱都可能影響連線。請優先逐項比對原始資料,不要根據他人的截圖推測參數,也不要混用不同伺服器的欄位資料。
測試失敗:先查看 Test Method
進入 Settings 查看 Test Method,確認目前的測試方式,再解讀 Home 中的 Connectivity Test 結果。不同方式檢查的環節可能不同,不能將某一種測試失敗直接解讀為整台伺服器永久無法使用。先固定測試方式,比較同一伺服器在同一網路下的表現,再結合實際存取情況判斷;不要每次測試前同時切換模式、網路和測試方式。
開關反覆變化:檢查授權與 On Demand
開關無法維持開啟時,先確認已完成步驟三的系統授權,並關閉其他正在執行的 VPN 連線。若連線在切換 Wi-Fi、鎖定螢幕或重新開啟 App 後自動變化,請進入 Settings 查看 On Demand。隨選連線條件可能觸發重新連線;暫時排查時,先記下原設定,再暫停相關條件,使用手動開關重新測試,確認原因後恢復需要的設定。
請勿直接刪除裝置上的所有網路設定,尤其是包含工作或學校管理設定的裝置。若系統禁止新增 VPN 設定,請先確認是否有管理限制;若沒有此類限制但錯誤持續發生,請記錄系統提示和觸發步驟,再進一步排查。
已連線但無法存取:保留可重現條件
連線維持開啟但頁面無法開啟時,先比較 Config 與 Proxy,再區分是所有目標都失敗,還是只有單一目標失敗。如果 IP 連線與網域存取的表現不同,再進一步檢查 DNS;不要反覆填入來路不明的 DNS 位址。頁面能載入文字卻缺少圖片,也可能是資源網域未命中預期規則,而非整個代理失效。
Settings 中的 Diagnostics 可用於收集錯誤資訊。重現問題後,記錄發生步驟、網路類型、所選模式和錯誤文字;對外提供診斷資料前,先確認內容是否包含訂閱連結、伺服器位址、密碼或其他個人資訊。Proxy、TCP、UDP 等項目涉及更細部的連線行為,首次使用時不建議為了試錯一次修改多項設定。
完成以上檢查仍無法確定原因,可前往故障排除大全,依開關、逾時、訂閱、DNS 等症狀繼續閱讀。購買、復原和常見操作問題請參閱問答頁。保留一組可重複描述的現象,比籠統地說「無法連線」更有助於找到下一步。
其他裝置的取得方式
以上操作以 iPhone / iPad 為例。iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。其他裝置的安裝檔由本站下載頁提供,安裝檔路徑統一位於本站 /dl/shadowrocket/。
系統感知按鈕會依目前裝置顯示取得選項;Mac 不會自動判斷晶片,請先在「關於這台 Mac」查看。首次安裝遇到系統封鎖時,請先閱讀下載頁的安裝放行說明,再依照相應系統操作。
目前版本 · iPhone / iPad $2.99 一次性付費,Mac、Windows、Android、Linux 免費