Shadowrocket 使用說明
從現有訂閱開始,依序完成新增、模式選擇、連線與驗證。先確認連線正常,再調整規則與自動連線設定。
開始前:分別準備用戶端與連線資訊本教學以 iPhone / iPad 介面為例。請先安裝 Shadowrocket:iPhone / iPad 從 App Store 取得,$2.99 一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版從下載頁免費安裝,首次安裝時的系統允許步驟請參閱安裝說明。iPhone / iPad 系統需求以 App Store 頁面標示為準。
同時確認已有自己的訂閱連結或伺服器資訊,相關內容請向服務商取得。本網站不提供、不銷售、不推薦節點或訂閱。用戶端一次性買斷 ≠ 線路方案,安裝用戶端不會自動產生可用的伺服器。
依序操作即可;已完成匯入的使用者可以直接從 Global Routing 開始。截圖用於辨認介面區域,實際欄位會依所選 Type 和應用程式介面而異。
STEP 01 / IMPORT
新增伺服器 / 匯入訂閱
開啟 Shadowrocket 後,先停留在 Home,不必立刻開啟頂部開關。頁面下方的 SERVER 群組用於選擇伺服器;如果這裡還沒有自己的項目,請進入 Add Server。此時應先判斷手上的資料屬於哪一種:可更新一組伺服器的訂閱連結、單台伺服器的分享連結,或需要逐項填寫的參數。三種資料的入口可能不同,不要只因連結看起來相似,就填入同一個欄位。
已有訂閱連結:選擇 Subscribe
在 Add Server 中開啟 Type,選擇 Subscribe,再將完整訂閱連結填入 URL。連結應向服務商取得,貼上時請保留開頭、路徑和查詢參數,不要帶入聊天訊息中的說明文字、換行或末尾標點。若介面提供備註欄位,可以填寫方便辨認的名稱,例如「日常連線」;備註僅供本機識別,無法修正連結本身的錯誤。
確認後儲存,等待訂閱下載完成,再返回 Home 查看 SERVER。成功的標誌是出現對應的伺服器項目,而不只是儲存了一筆訂閱記錄。若只看到訂閱名稱,卻沒有伺服器,先檢查網路能否連線至訂閱網址,再確認連結是否失效、內容是否為服務商提供的適用格式。不要為了讓清單出現內容而反覆新增同一個連結,重複項目會增加後續選擇與排錯的難度。
已有伺服器參數:依 Type 手動填寫
如果收到的是 Host、Port、Password 等個別欄位,請先在 Add Server 中選擇正確的 Type,再填寫該類型要求的內容。Host 填伺服器網域或 IP,Port 填對應的連接埠,Password 保留大小寫與符號。Method 等欄位僅在對應協定需要時填寫,不要照著另一種協定的截圖補齊所有項目;選擇 Type 後顯示的欄位,才是本次需要確認的內容。
例如,Shadowsocks 的 Method 必須與伺服器一致;Trojan 涉及的 TLS 與伺服器名稱設定也應依現有資料確認。地址、密碼或伺服器名稱有任何一項不清楚,應向服務商確認,而不是輪流嘗試填寫。截圖中的欄位用於說明 Add Server 的結構,並不代表所有 Type 都使用相同的一組欄位。儲存後回到 SERVER,確認備註與目標伺服器,接著再選擇流量路徑。
已有分享連結或 QR Code:匯入後仍須確認
如果收到的是單台伺服器分享連結,可以使用應用程式提供的剪貼簿匯入入口;QR Code 可從 Scan QR Code 進入,並依系統提示允許相機存取。匯入前確認來源與內容屬於自己的伺服器資訊,匯入後開啟項目確認 Type、Host 和 Port。Import from Cloud JSON 是另一種指定格式的入口,不應視為任意訂閱網址的通用輸入框。
訂閱連結通常包含存取憑證,QR Code 也可能包含完整密碼。不要將它們貼到公開留言區,或直接當作排錯截圖傳送。訂閱更新、多組訂閱整理及分享連結欄位的詳細說明,請參閱訂閱與伺服器管理手冊;這裡先保留一組確認有效的資料,繼續下一步。
STEP 02 / ROUTING
選擇 Global Routing 模式
伺服器出現後,返回 Home,開啟 Global Routing。這裡決定請求以何種方式處理,不負責下載訂閱,也不會替你補齊伺服器參數。三種模式分別是 Config、Proxy、Direct。先了解這一步再開啟連線,可以避免將「已選取伺服器」誤認為「所有請求都已經經過伺服器」。
Config:依目前規則決定流量去向
Config 會使用目前所選設定中的規則。進入 Config 可以檢視、選擇和編輯設定檔;編輯頁中的 General、Rule、Hosts 等區段各有用途,Rule 用於確認規則內容。日常使用前,應確認已選取準備使用的檔案,而不是只下載了檔案,卻仍在使用另一份設定。初次使用不必同時修改 DNS、重寫與 HTTPS Decryption,先保留能清楚說明的基本規則。
以下是規則格式說明,不是要直接覆寫現有設定。規則通常依序比對,命中的策略會決定對應請求走 PROXY 或 DIRECT,FINAL 則用於處理此前未命中的請求。如果還不了解目前設定的來源與規則順序,請先查看其中的 Rule 內容;具體關鍵字可查閱概念速查。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
Proxy 與 Direct:用於比對流量路徑
Proxy 用於將應用程式接管的請求交由所選代理策略處理,可用來確認伺服器是否基本可用;Direct 則讓應用程式接管的請求直接連線至目標。Direct 並不會關閉頂部連線開關,兩者控制的是不同層面。需要結束連線時,仍應返回 Home 關閉開關,而不是只將模式改為 Direct。
如果 Config 模式下某個頁面無法開啟,可以短暫切換至 Proxy,再測試同一個頁面:Proxy 可用而 Config 不可用時,檢查重點應轉向設定比對、策略選擇與解析設定;兩者都不可用時,先繼續檢查伺服器與本機網路。一次只修改一個選項,記錄原本的模式,測試完成後恢復日常選擇,避免排錯設定長期留在裝置上。
STEP 03 / CONNECT
選擇項目,開啟連線開關
返回 Home,在 SERVER 群組中點選準備使用的伺服器,確認選取標記位於正確項目上。訂閱中有多個項目時,不要只看備註中相似的文字;必要時開啟詳細資料確認地址。伺服器清單已出現,只能表示資料已匯入;是否能建立連線,還要透過接下來的授權與實際連線驗證。
開啟頁面頂部的連線開關。首次連線時,系統可能會詢問是否允許新增 VPN 設定;請閱讀提示,確認這是剛才在 Shadowrocket 中主動發起的操作,再依系統要求完成授權與裝置驗證。這項提示是用戶端建立系統網路連線所需的權限,與訂閱是否有效是兩回事。如果先前取消了授權,請返回應用程式重新發起連線,並觀察系統是否再次顯示確認步驟。
授權結束後返回 Home,觀察頂部是否從 Not Connected 轉為已連線狀態。狀態變化期間不要連續開關;先等待這次操作完成。如果開關立即回落,記下是否出現錯誤提示,再進入後續排錯步驟。若另有正在執行的系統 VPN 設定,也應先確認連線狀態,避免將其他設定的表現誤算為目前測試結果。
首次驗證階段建議維持手動連線。On Demand 可以之後依需求設定,但現在開啟會增加自動重新連線的條件,讓「是否已手動中斷」變得不容易判斷。完成第四步並確認連線符合預期後,再閱讀FAQ 中的連線與 On Demand 說明,決定是否需要依條件自動要求連線。
STEP 04 / VERIFY
驗證連線,不只看開關狀態
開關維持連線後,先在 Home 執行 Connectivity Test,觀察所選項目是否有測試結果。測試結果只能表示目前測試方法下的連通情況,不代表所有網站都可使用,也不等同於實際下載速度。某種測試方法沒有回應時,不要立刻刪除伺服器,先搭配實際連線狀況判斷。
- 檢查一般連線。開啟瀏覽器,造訪平時已知可用的頁面,確認裝置仍能正常載入內容。如果一般頁面也無法連線,先檢查 Wi-Fi 或行動網路是否需要登入認證,再考慮規則問題。
- 檢查預期透過代理連線的目標。選擇一個明確需要透過代理連線、且已知服務正常的目標,重新整理頁面並等待載入。Config 模式下,一般頁面可以透過直連成功,因此僅憑一般頁面能開啟,無法證明代理路徑已正常運作。
- 必要時比對模式。維持相同的伺服器、網路和目標,短暫切換 Proxy 與 Config。每次只變更模式,避免同時更換伺服器和網路後,無法判斷究竟是哪項變更生效。
- 恢復日常設定。測試結束後返回準備長期使用的模式。若需要中斷連線,請關閉 Home 頂部開關並確認狀態變化;不要將 Direct 當作中斷連線的操作。
如果瀏覽器運作正常,但某個應用程式仍無法使用,請繼續確認該應用程式本身的服務狀態、連線快取與實際請求目標。可以結束該應用程式目前的操作後重新開啟再試,但不必先重新安裝 Shadowrocket。遇到憑證警告時,也不要透過開啟 HTTPS Decryption 來「嘗試修復」;首次連線驗證不需要這項設定。
完成這一步後,就能區分「匯入成功」、「建立系統連線」和「目標連線成功」這三種結果。之後遇到問題,先說明在哪一層失敗,比只描述「連不上」更容易縮小排查範圍。
STEP 05 / TROUBLESHOOT
常見問題與檢查順序
排錯時先保留目前設定,不要一開始就清空清單。依序檢查以下層面,每修正一處就返回 Home 重新測試。這樣可以確認修改是否有效,也方便在沒有改善時還原原值。服務商提供的參數與目前介面不一致時,先確認 Type,而不是把缺少的欄位隨意填入備註或密碼欄。
已儲存訂閱,但 SERVER 沒有項目
通常應先檢查訂閱下載環節。確認 URL 是否完整,是否誤將單台伺服器分享連結填入 Subscribe,或複製時帶入空格與標點。接著確認本機網路能否完成訂閱請求,以及服務商是否已調整連結。訂閱更新失敗不一定會立即使既有項目失效,請先保留仍可辨認的舊資料;整理與更新方式請參閱節點管理手冊。
開關回落,或一直停留在未連線狀態
先確認系統新增 VPN 設定的授權是否完成,再檢查 Home 是否已選取有效項目。記下應用程式提示的具體文字,並確認裝置目前是否有其他正在運作的 VPN 設定。此時還不必反覆修改 Rule:如果系統連線本身尚未建立,通常無法用規則層面的調整解釋授權失敗。
已連線,但測試逾時或目標無法開啟
先中斷連線,確認本機網路本身可用,再重新連線並確認 Host、Port、認證欄位與 TLS 相關參數。Connectivity Test 的結果也會受 Test Method 影響;進入 Settings 查看目前使用的方法後,再搭配瀏覽器連線結果判斷。測試有回應但某個頁面失敗,不能只憑這個結果就認定整條連線正常;測試沒有回應但頁面可以連線,也應繼續確認測試方式。
Proxy 可以連線,Config 不行
這種比對結果適合從目前設定著手檢查:Config 中是否選對檔案、Rule 的比對順序是否符合預期,以及目標請求是否被分配至不同策略。先找出具體目標與命中的方向,不要直接將所有 DIRECT 替換成 PROXY。規則關鍵字與策略含義可在概念速查查看,深入整理則留待基本連線穩定之後。
需要保留診斷記錄時
Settings 中的 Diagnostics 可用於進一步檢查問題。記錄當時的網路類型、Global Routing 模式、所選伺服器備註及失敗狀況,必要時只擷取相關錯誤片段。傳送記錄前,請遮蔽完整訂閱 URL、Password、QR Code 與其他認證資訊;僅為說明故障,不需要公開整份伺服器資料。更多問題清單請參閱FAQ。
匯入、連線與實際連線都已確認正常後,先維持這組設定。之後再逐項了解 On Demand、設定備份與訂閱更新,每次調整都保留可還原的狀態。這樣後續即使發生變化,也能判斷是新增設定造成的影響,還是原有連線條件已經改變。