步驟 01 · Home / Add Server
新增伺服器或匯入既有訂閱
先確認取得的是訂閱連結,還是單一伺服器的連線資料。兩者都能在 Home 建立可選擇的伺服器項目,但輸入方式不同。訂閱通常用於集中更新一組伺服器;單一伺服器則需要依協定填寫各項參數。不要只根據連結中是否出現某個英文單字判斷類型,請以你既有服務的說明為準。
有訂閱連結:選擇 Subscribe
開啟 Shadowrocket,進入 Home,點選右上角加號,進入 Add Server。在 Type 中選擇 Subscribe,將完整訂閱連結貼到 URL,視需要填寫方便辨識的備註,然後儲存。複製時注意不要帶入前後引號、空格或換行,也不要刪除連結問號後的參數;這些參數可能是識別訂閱所必需的內容。
儲存後等待訂閱讀取完成,再返回 Home 查看結果。正確的檢查點是清單中出現訂閱群組及伺服器項目,而不只是編輯頁關閉。如果只看到訂閱名稱、沒有任何伺服器,先檢查目前網路是否能存取訂閱網址,以及連結是否已失效;暫時不要反覆新增同一筆訂閱,以免後續無法分辨正在使用哪一組資料。
訂閱更新與 VPN 連線是兩件事。更新用於讀取服務提供者發布的項目變更,並不代表已選取伺服器或建立連線。匯入成功後,還需要點選一個伺服器項目,讓它成為目前選擇,之後才能進入模式設定與連線步驟。
有單一伺服器:依協定填寫參數
在 Add Server 的 Type 中選擇資料註明的協定,例如 Shadowsocks、VMess、VLESS 或 Trojan,再依介面顯示填寫位址、連接埠與驗證資料。不同協定所需欄位也不同;不要將一種協定的密碼、識別碼或傳輸參數套用到另一種協定。涉及 TLS、伺服器名稱、路徑等欄位時,請逐項對照原始資料,不要猜測填寫。
如果已有資料以 QR Code 提供,可使用 Scan QR Code 讀取,再檢查解析出的協定與重要欄位。QR Code 只是輸入方式,不是有效性證明。儲存前核對是否有遺漏內容,儲存後返回 Home 選擇該伺服器。不清楚協定名稱與參數含義時,可查閱術語手冊,但最終填入的資料仍以你的伺服器資訊為準。
本步完成標準:Home 中有可選擇的伺服器,且已選取準備測試的項目。此時先不要急著開啟連線,下一步先確認請求將以哪種方式處理。
步驟 02 · Global Routing
選擇請求的整體處理模式
Global Routing 決定整體處理方式,不會補齊伺服器參數。在 Home 點選 Global Routing,確認目前選項。三種模式分別是配置(Config)、代理(Proxy)、直連(Direct)。首次操作時先記住目前選擇,測試過程中只變更這一項,避免將模式差異誤認為伺服器時好時壞。
配置(Config):依目前配置處理
配置(Config)會依據目前啟用的配置決定如何處理請求,規則可能將不同目標交給 DIRECT、PROXY 或其他已定義策略。使用前請進入 Config 查看目前使用的檔案,確認這就是你準備採用的配置。伺服器訂閱與 Config 配置檔不是同一種資料:前者主要管理伺服器,後者涉及規則及相關設定,匯入訂閱不等於已匯入一套分流規則。
如果已有可信且了解用途的配置,請依其說明啟用後再返回 Home。不要為了完成本教學而隨意覆寫現有 Config。規則如何比對、DNS 如何搭配屬於後續設定內容,可在完成連線驗證後閱讀設定手冊;目前只需確認正在使用哪個檔案,以及目標請求預期採用哪條路徑。
代理(Proxy):檢查所選伺服器路徑
代理(Proxy)適合在首次驗證時檢查所選伺服器承載請求的情況,減少分流規則對判斷的影響。這不代表所有服務一定都能連線,也不會自動修正驗證、TLS 或遠端伺服器的問題。如果此模式下仍無法正常存取,應先檢查伺服器和網路,而不是繼續疊加規則。完成比較後,是否切回配置(Config),應依你的實際分流需求決定。
直連(Direct):比對本機網路
直連(Direct)會以直連路徑處理請求,可用來比較本機網路與代理路徑的表現。網頁在此模式下能開啟,只能表示相應的直連存取可用,不能證明所選伺服器已正常運作。也不要將直連(Direct)理解為關閉系統 VPN 開關;模式選擇與連線開關是兩個不同的控制項。
本步完成標準:了解目前選取的模式及其用途。如果選擇配置(Config),還應了解目前啟用的配置檔。記下此狀態,再進入連線授權步驟。
步驟 03 · Home
開啟連線開關並完成系統授權
連線需要系統允許建立 VPN 配置。返回 Home,先確認目前伺服器,再確認 Global Routing 與上一步記錄相同,然後開啟頂端連線開關。首次連線可能會出現系統請求,提示允許新增 VPN 配置。確認請求對應 Shadowrocket 後選擇允許,並依系統提示完成密碼或裝置驗證;實際提示方式由裝置系統決定。
如果剛才取消了授權,返回應用程式後重新嘗試連線,並依系統實際顯示的請求操作。不要因為沒有立即看到網頁變化就連續切換開關;先觀察連線開關是否維持開啟,以及是否出現明確錯誤提示。若系統仍要求確認,請先完成流程,再回到 Home 檢查狀態。
測試期間,若另一個 VPN 應用程式或既有 VPN 配置正在連線,可先中斷另一條連線後再試,以免不同連線狀態互相干擾。受組織管理的裝置可能限制 VPN 配置,此時應確認裝置管理要求,而不是反覆刪除應用程式。若裝置無法完成系統授權,可前往問答頁繼續檢查安裝與首次開啟相關問題。
系統顯示 VPN 狀態,表示相應的系統連線已建立或正在使用;這不等於遠端伺服器驗證、網域解析和每個目標網站都已驗證成功。反之,狀態列未持續顯示某個標示時,也不宜只憑這一點判斷失敗,應一併查看應用程式開關與系統 VPN 狀態。下一步仍需以實際請求驗證。
本步完成標準:已完成所需的系統授權,應用程式連線開關可以維持開啟。此時保留目前伺服器與模式,先不要更改 DNS、On Demand 或其他進階選項,直接以固定條件進行一輪測試。
步驟 04 · Connectivity Test
分別驗證伺服器與實際存取
測試結果要分層判讀:伺服器可測、網頁可存取、規則符合預期,並不是同一個結論。先在 Home 使用 Connectivity Test 檢查伺服器項目,再選取本次準備使用的伺服器。測試方式會影響結果含義;某個數值只反映該次測試的狀況,不能直接視為網頁載入速度,也不需要為了追求更小的數字而不斷更換伺服器。
接著開啟瀏覽器,造訪平時使用且已知正常的頁面,觀察是否能完成載入及後續互動。盡量使用新開啟的頁面,不要把已快取的文字或圖片當成新請求成功。如果只有某個應用程式異常,可再用瀏覽器存取相同服務進行比較,藉此判斷問題是否侷限於該應用程式,而不是立刻更改整套配置。
在配置(Config)下,網頁能開啟也可能是規則選擇了 DIRECT。若要驗證代理路徑,應先了解目標在目前配置中的預期策略,必要時暫時切換至代理(Proxy),維持相同伺服器與網路,再存取相同目標。比較完成後恢復原本需要的模式。不要同時切換 Wi-Fi、伺服器和模式,否則即使結果改變,也難以判斷是哪個條件造成影響。
如果 Connectivity Test 有結果但網頁無法存取,表示還需要檢查實際請求使用的協定、驗證、DNS 或目標服務狀況;如果測試失敗但實際網頁正常,也要先確認測試方式及請求是否實際經由代理路徑。單項測試不是最終判定,應一併考量伺服器測試、瀏覽器存取和目前路由選擇。
需要進一步確認時,可在應用程式內查看與本次請求對應的 Log,核對目標、連線錯誤與處理路徑。Log 可能包含存取紀錄和伺服器資料,查看後應妥善保管,不要直接公開完整內容。如何閱讀 DNS 與 Log,可繼續查閱DNS 設定參考及設定手冊。
本步完成標準:能說明測試使用哪個伺服器、哪種 Global Routing、何種網路,以及實際頁面是否正常。驗證通過後,再逐項加入需要的規則或 On Demand 設定;每加入一項,就重複相同一輪驗證。
步驟 05 · 逐層檢查
從匯入結果找出常見問題
從最早未完成的步驟開始排查,而不是先重新安裝。先判斷問題發生在匯入、選擇、授權還是存取階段。每次只調整一項,調整後沿用剛才相同的伺服器、目標頁面與測試方式;保留調整前的值,避免失去原本可用的基準。
已儲存訂閱,但清單沒有伺服器
先檢查 URL 是否完整、是否複製了一般網頁網址而非訂閱網址,以及連結是否因換行而截斷。再確認目前網路能否讀取該訂閱,並向你既有的服務提供者確認連結狀態和格式。訂閱包含敏感憑證,不應貼到公開討論區,也不要以反覆新增訂閱取代匯入錯誤檢查。已有可用項目時,請先保留,再處理更新問題。
已出現伺服器,但測試與存取都失敗
對於手動新增的伺服器,返回 Add Server 對應的編輯內容,依序核對協定、位址、連接埠與驗證欄位,再核對 TLS 和傳輸參數。對於訂閱項目,先確認訂閱資料是否仍有效,再進行更新。如果只有一個項目失敗,可用自己既有的其他項目進行比較;如果全部失敗,則進一步檢查本機網路是否正常,以及遠端服務是否發生整體故障。
連線開關無法維持開啟
先查看是否已完成系統 VPN 配置授權,再檢查其他 VPN 連線或裝置管理限制。確認沒有待處理的系統提示後再試。如果手動關閉開關後又自動開啟,請檢查是否已啟用 On Demand;先暫停自動連線條件,再進行手動測試,避免把自動行為誤認為開關故障。不了解後果時,不要刪除裝置上的其他配置。
連線已開啟,只有部分頁面異常
先比較代理(Proxy)與配置(Config)的結果。前者正常、後者異常時,重點檢查目前 Config、規則順序與相關 DNS 設定;兩者都異常時,再回頭檢查伺服器及網路。也應確認目標服務本身是否正常,避免把單一網站故障擴大成用戶端整體故障。DNS 不應固定作為第一個修改項目;只有出現解析相關線索時,才記錄原值並進行針對性調整。
回報問題前,整理最小重現紀錄
記錄裝置系統、匯入方式、協定名稱、Global Routing 選擇、使用 Wi-Fi 或行動網路,以及具體在哪個步驟出現何種提示。引用 Log 時,只保留與錯誤相關的片段,並刪除訂閱連結、驗證資料、密碼和其他私人內容。無需公開完整配置或 QR Code,也不要傳送任何可直接使用的服務憑證。
基本連線通過後,本頁操作即告完成。常見問題可繼續查閱問答,協定和規則關鍵字可查閱術語手冊;若要逐項了解 DNS、On Demand、Connectivity Test 與其他設定,再前往設定手冊,首次連線時不必一次調整所有選項。