OFFICIAL MANUAL / GETTING STARTED

Shadowrocket 使用教學

匯入訂閱 → Global Routing → 授權連線 → 確認生效。先完成一次可驗證的連線,再調整規則與隨選連線。

  • iPhone / iPad
  • 已有服務資料
  • 五步操作流程

依序操作即可;已完成的步驟可直接略過。以下以 Home、Config 等英文介面名稱指引,實際選項排列可能因 App 介面調整而有所不同。

STEP 01 / INPUT

新增伺服器與匯入訂閱

先確認手上的資料類型,再選擇相應入口。單一伺服器資料通常包含通訊協定、位址、連接埠與驗證參數;單一節點 URI 則會將這些參數編碼成一段可匯入的文字;伺服器訂閱連結則用於取得一組項目。遠端設定檔也可能包含 DNS、規則與策略設定,不能只因連結以 https:// 開頭,就判斷它屬於哪一種。若不確定資料用途,請先確認原始說明,避免在不同入口重複匯入同一連結。

手動填寫:Home → Add Server

開啟 Shadowrocket 的 Home,點選右上角的新增入口,進入 Add Server。先在 Type 選擇與現有資料相符的通訊協定,例如 Shadowsocks、VMess、VLESS 或 Trojan,再依欄位填入伺服器位址、連接埠與驗證資訊。不同通訊協定的欄位不盡相同,請勿將某種協定的參數直接套用到另一種協定。位址欄通常只需填入主機名稱或位址,不必加上網頁路徑;連接埠也應與原始資料一致。

若資料指定 TLS、傳輸方式、Host 或 SNI,請逐項照原值填寫,不要根據名稱自行推測,也不要把顯示備註當作連線參數。儲存後回到 Home,確認清單中已出現新增項目。建議為項目設定容易辨識的備註,日後修改時仍應以原始服務資料為準。清單中看得到名稱不代表參數正確,請在後續測試步驟確認。

伺服器訂閱:Add Server → Subscribe

若已有伺服器訂閱連結,請在 Add Server 的 Type 中選擇 Subscribe,將完整連結填入 URL,並設定容易辨識的備註後儲存。請保留連結中的路徑、查詢參數與大小寫;複製時檢查末尾是否多了空格、換行或聊天訊息標點。回到 Home 後等待讀取訂閱內容,並確認是否出現相應群組與伺服器項目;若清單仍是空的,請先檢查讀取結果,不要立即開啟連線開關。

成功儲存訂閱與成功讀取訂閱內容是兩回事。若讀取失敗,請確認目前的基礎網路可連線至該網址、連結仍有效,且回傳內容屬於 App 支援的伺服器訂閱格式。連結可能含有存取憑證,請比照密碼妥善保管,不要在公開截圖、留言或求助內容中貼出完整 URL。本網站僅說明如何使用既有資料,不會代為取得或驗證私人連結。

Config 頁面的 Subscribe 與其他匯入方式

Config 頁面的 Subscribe 用於遠端設定檔,與 Home 中的伺服器訂閱群組不同。確認手上的連結指向完整設定檔後,才在 Config 使用該入口,依提示儲存並檢查設定內容;讀取遠端檔案後,也要確認目前實際使用的是哪份設定。設定檔可能變更 DNS 與規則,首次使用前請先了解其來源與處理邏輯。

若已有 QR Code,可使用 Scan QR Code 讀取;若已有單一節點 URI,則可使用 App 提供的剪貼簿匯入提示。僅在操作需要時授予相機或剪貼簿權限;匯入後仍須核對通訊協定、伺服器位址與備註。請勿透過手動新增、掃描 QR Code 和剪貼簿重複匯入同一份資料。確認 Home 至少有一台可選用的伺服器後,繼續選擇 Global Routing。

STEP 02 / ROUTING

選擇 Global Routing

伺服器項目決定代理連線使用哪些參數,Global Routing 則決定請求如何處理。回到 Home,點選 Global Routing,並選擇設定檔 (Config)、代理 (Proxy) 或直連 (Direct) 其中一種。首次使用時,請勿同時變更模式、DNS 與規則;先釐清測試目的,再選擇相應模式,才能在失敗時判斷應檢查哪一層。

模式處理方式適用情境
設定檔 (Config)依目前設定檔中的規則與策略處理請求。適用於已有且確認過的規則設定檔。
代理 (Proxy)將 App 接管的流量透過代理模式處理。短暫檢查所選伺服器的連線路徑,減少規則判斷的干擾。
直連 (Direct)使用直接連線,不經所選代理伺服器轉送。檢查基礎網路,或依需求直接連線。

日常依規則分流時,請選擇 Config,並在 Config 頁確認目前使用的設定檔。規則通常由上而下比對,符合後便套用相應策略;先前未符合的請求則由 FINAL 處理。設定中的 PROXY、DIRECT、REJECT 分別代表不同處理方式;使用自訂策略群組時,也須確認群組內實際選取的項目。將 Global Routing 切換至 Config,不會自動建立適用於所有情境的規則。

若要檢查剛新增的伺服器,可暫時選擇 Proxy,再回到 Home 選取該伺服器。Proxy 模式測試成功後,再切回 Config 確認規則路徑。Direct 適合用來比對基礎網路:若 Direct 可以開啟某個網頁,並不能證明伺服器可用,因為該請求沒有經過所選代理伺服器。測試時請留意目前模式,避免誤將直連結果當成代理連線成功。

若還不熟悉規則,請先閱讀功能介紹中的規則與設定說明,再逐步調整。此階段不必加上 On Demand 等自動觸發條件;先保留手動控制,較容易判斷連線何時啟用、何時結束。選好模式並確認伺服器後,再處理系統連線授權。

STEP 03 / CONNECTION

開啟開關與系統授權

回到 Home,先點選要使用的伺服器項目,確認選取標記位於預期項目上,再開啟頂端的連線開關。若使用的設定檔包含策略群組,也須確認群組內的選擇,因為它會影響實際的出口連線。伺服器名稱只是備註,不要只憑相似名稱判斷選到的是剛匯入的項目。

首次建立連線時,系統可能會顯示新增 VPN 設定的授權提示。這是 Shadowrocket 在裝置上處理相關網路流量所需的系統權限,用於授權本機的 VPN 設定。閱讀提示並確認 App 名稱後,選擇允許,再依系統要求使用裝置密碼或生物辨識完成驗證。若取消授權,回到 Home 後開關可能會恢復關閉;此時請重新啟動連線並處理系統提示,不必重複新增伺服器。

完成授權後回到 App,確認連線開關是否維持開啟,以及是否出現連線錯誤。系統 VPN 標示可作為連線狀態的參考,但不同裝置與系統的顯示位置可能不同,不應只以狀態列是否出現某個圖示作為唯一判斷依據。若開關剛開啟就關閉,請先記下提示文字,再核對系統授權、目前設定與伺服器參數。

測試期間也請留意裝置是否同時啟用其他會接管網路的 VPN 設定,或受到裝置管理限制。先確認目前實際生效的設定,避免不斷切換導致測試結果混雜。App 移至背景與手動關閉連線是兩回事;測試結束要中斷連線時,請回到 Home 關閉連線,並視需要檢查 Settings 中的 On Demand 條件,避免將自動重新連線誤認為開關失效。

iPad 的螢幕版面可能比 iPhone 寬,但操作方式相同:在 Home 選取項目,再控制連線開關。不要因版面不同就重新匯入所有資料。連線維持開啟後,進入下一步檢查實際存取與策略;此時仍不能只憑「已連線」就認定網路可用。

STEP 04 / VALIDATION

驗證存取與規則生效

分三個層面驗證:先確認伺服器是否可連線,再檢查目標能否實際開啟,最後確認請求是否依預期策略處理。在 Home 使用 Connectivity Test,查看剛選取的伺服器是否有回應。測試結果只反映特定探測條件下的連線狀況,不代表所有網頁或通訊協定都可使用;回應時間也不等於實際下載速度,更不能完整代表服務品質。

接著開啟瀏覽器,前往熟悉且獲准存取的網頁,重新整理並確認正文及必要資源是否載入。測試時維持相同目標,必要時再選另一個目標比對;不要同時更換伺服器、網頁與網路。瀏覽器可能顯示快取內容,因此請重新發出一次請求,不要只查看先前已開啟的頁面。

若目前模式為 Proxy,請著重確認所選伺服器路徑能否完成存取;若目前模式為 Config,還須核對符合的規則與最終採用的策略。可在 Data 查看本次連線記錄,依請求時間與目標網域尋找相應項目,並留意記錄提供的規則與策略資訊。不同記錄類型顯示的欄位可能不同,請以實際內容為準;總流量增加不代表目標請求一定經由 PROXY。

在 Config 模式下,某個請求符合 DIRECT 不一定是錯誤,重點在於是否符合預期。網頁也可能涉及多個網域:若正文正常但圖片載入失敗,應檢查失敗資源對應的請求,而不只是頁面主網域。若規則指定 REJECT,目標無法開啟可能正是設定預期的結果。先比對「預期的路徑」與「記錄顯示的路徑」,再判斷是否需要修改設定。

如需比較,可記錄同一目標在 Proxy 與 Config 模式下的結果。Proxy 可用但 Config 失敗時,優先檢查規則、策略群組與 DNS 設定;兩種模式都失敗時,則先核對伺服器與基礎網路。比對完成後,請恢復日常預期的模式,不要長期保留為排查而暫時變更的設定。

STEP 05 / CHECKLIST

常見問題檢查順序

遇到問題時,先記下目前的現象:訂閱讀取失敗、開關立即關閉、Connectivity Test 沒有回應,還是只有特定網頁無法開啟。不同現象需要檢查的入口各不相同。每次只變更一個條件,再以相同目標重試並記錄結果;一次替換整份設定檔或許會改變現象,卻容易失去判斷問題所在的線索。

先檢查基礎網路與服務資料

先關閉連線,確認裝置本身的網路可正常使用。若使用的 Wi-Fi 需要登入確認,請先完成登入。基礎網路尚未連線時,重複更新訂閱或重新填寫伺服器資料通常無法解決問題。必要時可在自己能使用的另一種網路環境下重新測試,判斷問題是否只發生於目前網路。

確認基礎網路正常後,再核對伺服器位址、連接埠、通訊協定、驗證欄位及 TLS 相關參數。若訂閱先前讀取成功,後來卻無法使用,請使用 App 提供的更新功能重新讀取既有訂閱,並確認更新是否完成及項目是否有變化。更新失敗時,先保留原有且可供核對的資料,不要立即刪除整個群組;連結有效性、帳戶狀態或伺服器狀況,請透過自己的服務管道確認。

接著檢查模式、DNS 與規則

確認 Global Routing 沒有停留在 Direct,也沒有意外將預期直連的請求送往代理路徑。使用 Config 時,請檢查目前選用的檔案、策略群組選擇與 FINAL。若 Proxy 正常、Config 異常,請優先檢查目標請求符合的規則,而不是重新安裝 App。規則順序也很重要:若前面的廣泛規則先符合,後續較細的規則便不會執行。

DNS 問題可能會造成伺服器測試有結果,但目標網域無法解析,或網頁資源只載入一部分。先檢查目前設定是否使用自訂 DNS,以及相關位址在目前網路環境中是否可連線。不要同時啟用多個尚未了解的 DNS 選項,也不要只憑某種位址格式就認定它一定較合適。調整前先記下原設定,測試沒有改善時請及時還原。

最後檢查特定目標與自動連線問題

只有特定目標失敗時,請分辨是連線逾時、解析失敗、服務回傳錯誤,還是存取權限提示。收到目標服務的錯誤回應,與完全未建立連線屬於不同層面的問題;帳戶登入或目標服務本身的狀態,也不應一概歸因於代理。請對照 Data 中相同時間的記錄,檢查失敗請求,不要以單一網頁的結果代表所有連線。

若手動關閉後又自動連線,請檢查 Settings 中的 On Demand 及相關觸發條件。排查時可暫時關閉自動觸發,確認手動連線正常後再恢復。若仍有系統授權或從 App Store 取得 App 方面的疑問,請參閱App Store 安裝與帳號指南;指南會說明購買、確認裝置相容性及還原已購項目,不必在網路問題排查時重複處理這些步驟。

排查完成後,回到Global Routing 模式選擇步驟恢復預期模式,再依照生效驗證步驟重新測試。若要進一步釐清「已連線但無法上網」的情況,請參閱伺服器、模式、DNS 與規則排查筆記。求助時只提供必要的錯誤訊息與已嘗試步驟,並隱去訂閱連結、密碼、驗證參數及其他私人資訊。