Shadowrocket 使用說明
依照「匯入 → 選擇模式 → 連線 → 驗證 → 排查」的順序操作。先完成一次可重複的連線檢查,再調整規則與日常設定。
本頁適合跟著完成初次設定。介面中的 Home、Add Server、Subscribe 等名稱保留英文,方便對照查找;不同系統語言下的位置與排列可能略有差異。若要了解完整設定項目與維護方式,請前往從新手到進階,初次連線前不必逐項調整。
新增伺服器或匯入訂閱
先確認手邊的是訂閱網址、單筆分享連結,還是需要手動填寫的伺服器資訊,再選擇對應的入口。
已有訂閱連結:使用 Subscribe
開啟 Shadowrocket,進入 Home,點選右上角的加號進入 Add Server。在類型選項中選擇 Subscribe,再將向服務提供者取得的完整訂閱連結填入 URL。若需要填寫備註,使用方便自己辨識的名稱即可;備註只用於整理清單,不會影響連線是否成功。
貼上後先檢查網址開頭、結尾與參數部分,避免混入空格、換行或中文標點。訂閱網址通常會傳回一組伺服器項目,並非服務提供者網站的登入頁面。儲存後等待訂閱內容載入,再返回 Home 查看 SERVER 區域。若要重新取得現有訂閱的內容,請使用對應項目的更新操作;不要連續重複新增相同網址,否則之後不易辨認目前使用的是哪一組項目。
如果儲存後只看到訂閱名稱,還沒有出現可選的伺服器,請先確認更新是否成功,再進行下一步。訂閱連結可能包含驗證資訊,請勿將完整網址貼到公開頁面,也不要為了說明錯誤而公開 QR Code。需要記錄問題時,只保留錯誤文字與已遮蔽敏感內容的欄位說明。
已有伺服器欄位:在 Add Server 手動填寫
一樣從 Home 的加號進入 Add Server,依照現有資料選擇對應協定,例如 Shadowsocks、VMess、VLESS 或 Trojan。接著逐項填寫位址、連接埠與該協定要求的驗證資訊。不同協定需要的欄位並不相同,請勿將某個協定的密碼填入另一個協定的識別欄位,也不要只因名稱相似就更換協定類型。
如果資料還包含 TLS、SNI、傳輸方式或路徑等內容,應與原始資訊保持一致;留白與任意填值並非相同設定。無法確認的欄位請向服務提供者取得資訊,確認後再儲存。若已有單筆分享連結,可使用應用程式提供的連結匯入或剪貼簿辨識入口;若出現讀取剪貼簿提示,請只在確實需要匯入時允許,並檢查匯入後的欄位。
完成後返回 Home,在 SERVER 中選取準備使用的實際伺服器項目。清單中出現名稱只代表資訊已儲存,不代表伺服器已可使用。此時先不要反覆開啟開關,下一步還要確認 Global Routing 使用哪種模式。
選擇 Global Routing 模式
伺服器項目決定「連線到哪裡」,Global Routing 決定「以什麼方式處理連線」。兩者需要分別確認。
在 Home 點選 Global Routing,查看目前的選項。本指南將三種模式寫作配置(Config)/代理(Proxy)/直連(Direct),實際介面請認明 Config、Proxy、Direct。選擇後返回 Home,確認顯示的模式已變更,不要只根據剛才點過某個選項推測目前狀態。
| 模式 | 如何處理連線 | 初次設定時的使用方式 |
|---|---|---|
| 配置(Config) | 依照目前設定中的規則決定連線使用的策略。 | 用於日常規則分流;同時檢查 Config 中目前選取的設定。 |
| 代理(Proxy) | 將可代理的連線交由目前選取的伺服器處理。 | 適合先檢查所選伺服器的基本可用性,再排查規則差異。 |
| 直連(Direct) | 直接存取目標,不經所選代理伺服器轉送。 | 用於辨別基礎網路與代理路徑的差異,不能據此判斷代理已生效。 |
初次設定時,如果還不清楚設定內容,可以先用 Proxy 完成一次基本連線驗證。驗證成功後再切換到 Config,觀察日常瀏覽是否符合預期。不應將 Proxy 理解為所有系統流量都會以完全相同的方式處理;系統行為、連線類型與應用程式本身的網路實作仍可能影響結果。
若要使用 Config,請進入 Config 頁面,確認選取的是準備使用的設定,而不是只下載檔案卻尚未選用。伺服器訂閱與規則設定並非同一份內容:更新訂閱會更新伺服器項目,不代表已切換到某一組規則。排查單一頁面問題時,不要同時更換訂閱、設定與 DNS,否則很難判斷是哪一項變更發揮作用。
如果使用 Proxy 可以存取,而使用 Config 時某個目標失敗,請優先檢查規則比對與策略方向。DOMAIN-SUFFIX、IP-CIDR 等關鍵字的意義請參閱術語表;初次操作不必立即編輯這些規則。確認模式並保留目前選擇後,繼續進行連線與系統授權。
開啟連線開關並授權 VPN
先選取伺服器,再開啟開關。首次出現的新增 VPN 設定提示屬於系統授權流程。
從 Home 開始連線
返回 Home,確認 SERVER 中選取的伺服器,以及 Global Routing 目前顯示的模式,再開啟頂端的連線開關。尚未連線時可能會看到 Not Connected。首次連線時,系統會詢問是否允許新增 VPN 設定;確認提示是由 Shadowrocket 剛才的操作觸發後,選擇允許,並依照系統要求完成裝置密碼或生物辨識驗證。
完成授權後返回 Shadowrocket,觀察開關是否保持開啟,以及連線狀態是否有所變化。系統設定中出現對應的 VPN 項目是正常結果,表示應用程式建立系統網路連線所需的設定已儲存;這不代表系統會自動補齊伺服器資訊,也不表示遠端伺服器已可使用。
曾拒絕授權或開關立即關閉
如果先前曾點選拒絕,請返回 Home 再次嘗試連線,並依照實際出現的系統提示重新授權;同時前往系統設定搜尋 VPN,確認是否已有 Shadowrocket 對應項目。尚未確認用途時,不要批次刪除其他 VPN 設定,尤其是裝置管理或工作環境所需的項目。
若授權後開關仍立即關閉,先記下彈出的錯誤文字,再檢查是否已選取伺服器、必要欄位是否完整,以及裝置上是否有另一個正在使用的 VPN 連線。受管理的裝置可能會限制新增或啟用 VPN 設定;遇到這種情況,應先確認裝置政策,而不是不斷重複匯入相同訂閱。
初次驗證期間,可先保留 On Demand 原有設定,透過手動開關觀察完整連線流程。如果關閉連線後又自動建立,請檢查 On Demand 是否已啟用,以及是否有觸發條件。先了解自動連線的來源,再決定是否調整,以免將自動重新連線誤認為開關失效。
確認連線是否生效
分別檢查本機連線狀態、Connectivity Test 與實際網頁瀏覽,不要用單一結果代替所有判斷。
先在 Home 找到 Connectivity Test,對已匯入的項目執行測試。測試結果反映所選測試方式與當時網路環境下的可連線情況,並非對所有網站的保證。若某個項目顯示失敗,請記錄目前網路、所選伺服器與測試方式;不要只因單次結果就刪除整組訂閱。
接著開啟瀏覽器,造訪一個自己有權存取、且平時能辨認內容的 HTTPS 頁面。必要時開啟新頁面並重新整理,避免將瀏覽器快取誤認為新請求成功。再檢查實際需要使用的目標頁面。一般頁面可瀏覽但特定目標失敗,與所有頁面都無法開啟是兩種不同情況,後續排查方向也應有所區別。
如果目前使用 Proxy,先確認基本存取可以重複成功,再切換到 Config,對同一個目標重新測試。Config 下部分目標採直連可能是正常的規則結果,並非所有請求都必須使用代理。若要判斷某個目標實際採用的連線方式,請搭配應用程式提供的連線記錄或日誌,確認對應的網域與策略;分享記錄前請遮蔽伺服器位址、帳號與訂閱參數等敏感資訊。
也可以在網路條件不變時,暫時關閉連線,對同一頁面進行比較,再恢復連線重新測試。比較的目的是縮小問題範圍,不是用單一頁面證明所有流量的方向。應用程式中已建立的長連線可能繼續沿用原本的路徑;切換模式後應重新送出請求,必要時重新開啟目標應用程式。
若「選取伺服器 → 開啟連線 → 實際瀏覽 → 關閉後重新連線」可以重複完成,初次設定即可結束。記錄可用伺服器的備註與目前模式,之後每次更新訂閱或修改設定後,都使用這組檢查步驟。Data 中的流量變化可協助確認是否有連線活動,但無法單獨證明目標頁面已成功載入。
常見故障與檢查順序
先確認故障發生在哪個步驟。每次只修改一項,並以相同目標重新測試,保留可還原的設定。
已儲存訂閱,但沒有伺服器項目
先關閉連線,確認裝置目前可正常存取基礎網路,再檢查訂閱 URL 是否完整、有沒有多餘空格,以及是否誤貼服務提供者的網頁網址。訂閱更新取決於網址本身可連線、內容格式可辨識,以及存取權限仍然有效。若出現驗證失敗或傳回內容異常,請向服務提供者取得目前有效的資訊,不要靠反覆改寫網址參數嘗試復原。
項目存在,但 Connectivity Test 失敗
先檢查目前選取的是否為實際伺服器項目,再確認協定、位址、連接埠與驗證欄位。手動填寫時尤其要確認 TLS、SNI、路徑與傳輸方式是否符合原始資料。若已有多個項目,可在相同網路下改選另一個現有項目重新測試;只有單一項目失敗與全部項目失敗,分別可能指向項目資訊與基礎網路等不同方向。
開關已開啟,但網頁仍無法瀏覽
確認目前不是 Direct,並檢查所選伺服器是否與剛才測試的項目相同。先使用 Proxy 檢查同一個 HTTPS 目標:若此時可用而 Config 不可用,再檢查目前的設定與規則;若兩種模式都失敗,請重新檢查伺服器欄位與網路環境。不要一開始就重設所有 Settings,重設會清除有助於判斷的背景資訊。
只有部分網域或切換網路後出現異常
部分頁面失敗時,記錄具體網域、發生時段、目前模式與可重現的操作,再檢查規則方向及 DNS 相關設定。不要任意填入用途不明的 DNS 位址。從 Wi-Fi 切換到行動網路後出現異常,可手動中斷連線再重新連線並測試,同時確認目前網路是否需要先完成網頁驗證。若系統連線狀態正常但目標應用程式異常,也應排除該應用程式本身的工作階段與快取影響。
繼續排查時應保留哪些資訊
保留錯誤原文、使用的網路類型、選取的協定類型、Global Routing 模式,以及問題出現在何種操作之後。修改設定前先保留可還原的副本;公開討論時不要附上完整訂閱、密碼或 QR Code。常見情況可繼續參閱常見問題;DNS、規則比對與設定維護的完整檢查方法請參閱從新手到進階。
初次使用到這裡即可:確認資訊已匯入、模式符合用途、授權完成且實際瀏覽可以重複驗證。後續若要調整 On Demand、規則或設定,一次處理一個主題,並在變更後重新執行驗證步驟。