01 · Add Server:新增伺服器或匯入訂閱
先確認手上的資料類型,再選擇匯入方式。單一伺服器的位址、連接埠與驗證參數用於手動新增;訂閱連結則用來讀取一組伺服器項目。兩者不可混用,例如不能將整條訂閱連結填入 Host。操作前請確認本機網路可正常連線,暫時不要開啟連線開關,先整理好清單。
手動輸入伺服器資料
進入 Home,點選 Add Server,或開啟新增入口進入同名頁面。先點選 Type,依伺服器資料標示的協定選擇類型,再逐項填寫。以 Shadowsocks 為例,通常需要確認 Host、Port、Password 與 Method。不同 Type 會顯示不同欄位,請依所選協定對應的表單填寫,勿以其他協定的欄位組合代替。
Host 填入伺服器位址,Port 填入連接埠;驗證資料與 Method 必須和伺服器設定一致。輸入時請特別確認複製內容前後沒有空格、連接埠數字正確,且大小寫相符。若協定還需要其他參數,請依現有資料補齊,不要只憑位址外觀猜測。填妥後使用頁面上的儲存功能返回 Home,確認 SERVER 群組中出現新項目,再核對一次備註與位址,避免選錯名稱相近的伺服器。
使用 Subscribe 匯入現有訂閱
若已有訂閱連結,請在 Add Server 的 Type 中選擇 Subscribe,將完整連結填入對應的 URL 欄位,可加上方便辨識的備註,然後儲存。返回 Home 後,等待訂閱內容讀取完成;若未自動讀取,請使用該訂閱項目提供的更新功能。確認出現訂閱對應的伺服器清單,而不是只有空白群組。若更新失敗,請保留錯誤提示,先確認連結仍有效且目前網路可以讀取,勿重複新增同一條連結。
若有相容的 QR Code,可使用 Scan QR Code 掃描;讀取後仍須檢查匯入的 Type 與參數。Import from Cloud JSON 是匯入特定 JSON 內容的另一個入口,不適用於任意訂閱連結。訂閱網址可能包含存取憑證,請勿將完整網址放在公開截圖中。完成後至少應有一個可選取的伺服器項目,接著再決定如何路由流量。
02 · Global Routing:選擇路由模式
伺服器出現在清單中,不代表所有請求都會使用它。返回 Home,開啟 Global Routing 並確認目前選項。三種模式分別為設定 (Config)/代理 (Proxy)/直連 (Direct),用來決定 App 接管的請求如何選擇策略。請先確認用途再選擇模式;不要一邊修改伺服器參數,一邊反覆切換模式,否則難以判斷哪項變更影響結果。
- 設定 (Config):依目前選取的設定處理請求,適合需要依網域、位址或其他條件分流的情境。選擇後還須前往 Config 確認目前設定,不能只看到 Home 顯示 Config,就認定規則正確。
- 代理 (Proxy):以代理路徑處理 App 接管的請求,排查時可用來區分伺服器連線問題與規則選擇問題。這不代表每個系統請求都必定經過同一路徑,也不保證目標服務一定可用。
- 直連 (Direct):以直接連線方式處理請求。若要驗證所選伺服器的代理路徑,維持 Direct 會讓驗證方向不一致。
使用 Config 時確認目前設定
進入 Config 頁面,確認目前使用的設定檔,再開啟內容編輯。官方截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同的設定區段。本次入門操作著重於 General 與 Rule;初次連線不必逐項啟用其他功能,也不需在用途不明時修改所有設定。
Rule 中的規則通常由上而下比對,命中第一條規則後便套用對應策略。PROXY 表示使用代理策略,DIRECT 表示直接連線,REJECT 表示拒絕。使用 Add Rule 新增規則時,請先確認比對條件與策略,再檢查插入位置;過於寬泛的規則若排在前面,後續的具體規則便無法命中。FINAL 應放在最後,用來處理先前未命中的請求。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
上方僅為語法片段:表示 example.com 及其子網域使用 PROXY,其餘請求由 FINAL 指向 DIRECT;這不是完整設定,也不是實際連線測試目標。請勿為了照抄範例而覆蓋現有設定。確認所需模式與目前檔案後,返回 Home;規則關鍵字的詳細說明請參閱術語表,完整功能介紹請見Global Routing 功能介紹。
03 · Home:選擇伺服器並開啟連線
返回 Home,在 SERVER 清單中點選要使用的伺服器,確認選取標記位於正確項目上。同一訂閱群組中的伺服器備註可能相近,選擇前請依位址或備註核對;不要只選清單中的第一項。接著再次確認 Global Routing 仍是上一步選定的模式。伺服器選擇、路由模式與目前設定是三件不同的事,請分別確認。
點選頁面頂端 Not Connected 區域中的連線開關。首次連線時,系統可能提示新增 VPN 設定;閱讀系統說明後,依提示允許,並完成裝置要求的身分驗證。這項操作是讓系統建立 Shadowrocket 使用的 VPN 設定項目,不是在 App 中購買服務,也不會補齊伺服器參數。若當時取消,請返回 App 重新發起連線,並依系統提示完成授權。
完成授權後返回 Home,查看頂端狀態是否從 Not Connected 變為已連線,並確認開關維持開啟。若開啟後立即關閉,請勿連續快速點按;先記下狀態提示,再到最後一步依序排查。系統設定中的 VPN 項目可協助確認連線狀態,但這與伺服器能否連線至特定目標是不同的判斷。
iPad 上的操作順序相同;可用空間較大時,頁面配置可能與 iPhone 截圖不同,請依 Home、SERVER、Global Routing 等名稱尋找功能。首次使用建議先讓 App 保持在前景,完成一次連線與驗證,再考慮其他自動化設定。On Demand 不是手動連線的必要條件;若先前已設定,請留意手動中斷連線後是否再次觸發連線。
暫時不使用時,可返回 Home 關閉連線開關,並確認狀態已變更。若開關保持開啟但網頁仍無法瀏覽,請勿認定「顯示已連線就一定生效」;接下來應分別確認伺服器回應、實際請求與規則選擇。只有各項結果能互相對照,才能確認目前連線是否符合預期。
04 · Connectivity Test:驗證實際請求
每次驗證只確認一件事:本機網路是否正常、伺服器是否有回應、目標是否可連線,以及請求是否採用預期策略。先在 Home 使用 Connectivity Test,查看清單項目的測試結果。測試讀數會受目前使用的方法影響,可用來找出明顯失敗的項目,但不等於網速測試,也不能只憑單次回應就認定所有 App 和目標都能正常連線。
接著開啟瀏覽器,前往使用者明確知道應可連線的目標,重新載入頁面並查看結果。不要只查看已開啟的舊頁面,因為內容可能來自快取。若要驗證特定規則,請選擇符合該規則條件的實際目標;教學中的 example.com 只是語法範例,不能用來推斷伺服器是否可用。測試期間先維持伺服器與 Global Routing 不變,讓結果能夠重現。
比對連線結果與命中策略
返回 Shadowrocket 查看連線記錄,針對剛才開啟的目標核對網域、時間與所用策略。使用 Config 時,命中 DIRECT 的請求直接連線是規則預期的結果,不能因為沒有使用 PROXY 就判定連線失敗;反之,需要使用代理的請求若命中 DIRECT,應檢查 Rule 的排序與 FINAL。記錄中的網域可能和網址列不同,因為同一頁面也會載入圖片、指令碼等資源,請依發生時間判斷。
可在 Data 中觀察上、下行讀數是否變化,但流量增加只能表示有資料傳輸,無法證明特定目標採用了預期策略。背景活動也可能產生讀數,因此較可靠的方式仍是「發出明確請求,再查看對應記錄」。同樣地,系統顯示 VPN 已連線,只代表系統連線層處於相應狀態,不代表伺服器驗證、DNS 與目標連線都已成功。
若測試失敗,先記錄問題發生在哪一層,再進入排查步驟;若測試和實際連線都正常,請保留目前可用的設定,避免為了追求某個測試數字而反覆調整參數。測試方法與工具的詳細說明請參閱診斷工具說明,連線記錄與統計相關術語請見術語表。
05 · Settings:依故障狀況逐項排查
排查時一次只修改一項,修改後重做上一步的同一項測試。先記錄目前的伺服器、Global Routing、設定檔與錯誤提示,再依下列順序檢查。這樣能區分問題來源,也能在修改無效時還原;不要一開始就刪除所有設定。
- 先檢查本機網路。中斷 Shadowrocket 連線後,確認目前的 Wi-Fi 或行動網路本身能正常上網。若網路需要登入驗證,請先完成登入。基本網路無法使用時,應先處理網路連線,而非修改伺服器密碼。
- 接著確認清單與選取項目。返回 Home,確認目前實際選取的項目。訂閱更新成功不代表已自動選取想用的伺服器;若清單是空的,請返回 Subscribe 檢查更新錯誤、連結是否有效及讀取結果。
- 核對協定與驗證參數。開啟對應項目的編輯頁,逐一檢查 Type、Host、Port 與驗證資料。部分協定還需要其他參數,請依現有伺服器資料核對。訂閱項目可能在下次更新時重新寫入,請勿用臨時手動修改來掩蓋來源資料的問題。
- 區分伺服器與規則問題。使用 Config 時若連線失敗,可在用途明確的情況下,暫時切換至 Proxy,對同一目標重新測試。若結果改變,請返回 Config 檢查命中策略、規則順序與 FINAL;測試結束後恢復原先模式。若兩種模式都失敗,應繼續檢查伺服器或基本連線,不能只歸因於規則。
- 檢查系統授權與其他連線。若開關無法保持開啟,請確認是否已授權新增 VPN 設定,以及裝置上的其他 VPN 連線或管理限制是否影響目前操作。不要任意移除用途不明的系統設定;受管理裝置的限制請洽相應管理單位確認。
需要更多線索時使用 Diagnostics
進入 Settings,找到 Test Method 與 Diagnostics。前者會影響測試方式,後者用於進一步檢查問題;不同方法的讀數不宜直接視為同一項指標比較。Proxy、TCP、UDP 等設定各有用途,首次排查時請先維持原有值,不要一次切換多個選項。
若出現網域相關錯誤,請先區分位址是否能解析,以及連線是否能建立,再依 Diagnostics 的具體結果分析。不要為了嘗試而填入來源不明的 DNS 設定。若只有特定目標失敗、其他目標正常,請針對該目標的解析、命中策略與錯誤提示逐步縮小範圍,而非立即重新匯入所有訂閱。
整理記錄時,保留操作順序、錯誤提示、所選模式與測試結果即可。分享截圖或記錄前,請移除完整訂閱連結、密碼、驗證識別資料及其他個人資訊。若連線仍未恢復,請繼續閱讀Shadowrocket 無法連線:常見問題檢查;若問題出在取得 App、購買或還原已購項目,請改參閱App Store 指南,不要混用連線排查步驟。