官方手冊 / 首次設定
Shadowrocket 入門指南
先新增現有伺服器,再選擇 Global Routing,最後連線並驗證。首次設定建議預留約十分鐘,依序操作,避免同時變更多項設定。
步驟 01 / 在 Home 顯示可選擇的伺服器
Add Server:新增伺服器或匯入訂閱
先確認手上的資料類型。包含多台伺服器、可定期更新的連結,通常應以訂閱方式匯入;若只有位址、連接埠、協定與憑證,則新增單一伺服器即可。兩種方式擇一,不必重複新增同一份資料。請向自己的服務供應商取得訂閱連結,匯入前確認連結屬於自己的帳戶;複製時不要包含說明文字或行尾空格。
已有訂閱連結:使用 Subscribe
開啟 Home,點選新增入口進入 Add Server,再點選 Type,並從類型清單中選擇 Subscribe。返回表單後,將完整訂閱連結填入 URL 欄位,視需要填寫方便辨識的備註,再點選頁面上的儲存按鈕完成新增。訂閱用於取得並維護一組伺服器項目,並不能取代連線開關。
儲存後返回 Home,等待訂閱讀取完成,再確認 SERVER 中是否出現對應群組與伺服器。若只看到訂閱名稱,卻沒有可選擇的伺服器,請先檢查更新是否成功,不要直接進入連線步驟。連結可能已過期,也可能回傳登入提示或其他不適用的內容。詳細排查方式請參閱疑難排解中的訂閱與節點匯入說明。
已有單一伺服器資料:依 Type 填寫
在 Add Server 中,將 Type 設為資料所標示的協定,再逐項填寫 Host、Port、Password 等內容。Host 填入伺服器主機名稱或位址,Port 填入對應連接埠;若表單有 Method 欄位,內容必須與現有資料一致。不同 Type 的欄位不盡相同,不要只因欄位名稱相似就照填,也不要將整段訂閱連結貼進 Host。
主機名稱範例可寫成 example.com,僅用於說明欄位用途,並非可用伺服器。若還需要驗證、TLS 或其他參數,請逐項核對自己的原始資料。儲存後返回 Home,確認項目名稱與協定符合預期。請勿將密碼等敏感資料寫入備註;備註僅用來區分用途或來源。
QR Code 與剪貼簿:匯入後仍須檢查
若資料是 QR Code,可使用 Scan QR Code,依系統提示允許取用相機,再掃描自己持有資料中的 QR Code;若取得的是伺服器分享連結,可使用 App 提供的剪貼簿匯入功能。讀取成功後,請檢查 Type、Host 與 Port,再儲存。QR Code 和分享連結只是傳遞參數的方式;掃描成功不代表伺服器已可連線。
完成此步驟後,Home 中至少應有一台可選擇的伺服器。多份訂閱、重複項目、更新策略與備份不必在首次設定時一併處理,之後可參閱訂閱與伺服器管理手冊進行整理。接著先決定流量處理方式,再開啟連線開關。
步驟 02 / 決定流量處理方式
Global Routing:Config、Proxy 與 Direct
返回 Home,點選 Global Routing。首次使用時,先分清三種模式:設定檔(Config)、代理(Proxy)、直連(Direct)。這些模式會決定連線開啟後如何處理流量,並非三台伺服器,也不會自動補上伺服器資料。切換前先記下原本的選擇,方便測試後恢復。
設定檔(Config):依目前設定檔中的規則處理
選擇 Config 後,流量會依據目前選取的設定檔比對規則,再交由相應策略處理。進入 Config 頁面後,先確認目前選取的是預計使用的設定檔;需要查看內容時,再開啟檔案編輯頁。官方截圖中的 General、Rule、Hosts 等區段屬於設定檔內容,並非首次連線時必須逐項填寫的表單。
若已有可信任的設定檔,應先閱讀其說明,再確認規則引用的策略是否存在。規則通常依序比對,例如 DOMAIN-SUFFIX,example.com,PROXY 表示相應的網域後綴使用指定策略。範例中的 PROXY 必須在實際設定檔中具有正確意義;不能只貼上單行範例,就認為流量分流已設定完成。
代理(Proxy):檢查所選伺服器的連線
Proxy 會讓由此模式處理的流量經由代理路徑傳送。首次排查時,可暫時選擇此模式,降低規則選擇造成的干擾,協助判斷所選伺服器是否基本可連線。這只是檢查方式,不表示所有情況都適合長期使用 Proxy,也不代表一定能連上任何目標。測試完成後,請依自己的設定目標決定是否切回 Config。
直連(Direct):不使用所選的代理伺服器
Direct 用於直接連線。若目前選擇 Direct,即使 VPN 設定已啟用,也不能據此判斷流量正經由所選伺服器傳送。若連線結果與預期不同,請先返回 Global Routing 確認目前選項,比起重複匯入訂閱更能對症排查。
首次設定時,請勿順便變更 URL Rewrite 或 HTTPS Decryption。它們並非伺服器成功連線的必要條件,且會帶來不同的設定影響。此時只要記下目前模式,並確認 Config 所選的檔案或 Proxy 所選的伺服器即可。若想深入了解規則順序與策略名稱,請參閱規則分流與疑難排解;本教學接著進行實際連線。
步驟 03 / 選擇項目並允許 VPN 設定
Home:開啟連線開關
返回 Home,在 SERVER 中點選一台現有伺服器。請選擇具體項目,而不只是查看訂閱群組名稱。若有多個項目,首次測試先固定使用其中一台,避免每次同時更換伺服器與模式,最後無法判斷是哪項變更造成影響。並確認 Global Routing 仍維持上一步選定的模式。
找到 Home 頂端 Not Connected 旁的開關並開啟。首次連線時,iPhone 或 iPad 可能會顯示新增 VPN 設定的系統提示。確認操作是由目前使用的 Shadowrocket 發起後,依提示允許新增,並完成系統要求的裝置驗證。此授權用於建立裝置的 VPN 設定,不是購買 App 或訂閱的確認步驟。
完成授權後返回 App,查看頂端狀態是否從 Not Connected 變為已連線。若剛才取消了系統提示,請重新發起連線並完成授權,不必立即刪除 App。系統狀態列中的 VPN 標示可協助確認設定是否啟用,但不同裝置與顯示位置可能有所不同,仍應一併參考 Home 上的狀態。
顯示已連線只代表連線流程已啟動,不等於所有連線都已驗證成功。伺服器無法連線、參數不符或規則選擇錯誤,都可能造成 App 顯示的連線狀態與實際使用情況不一致。開啟開關後,請勿立即大量變更設定;先進行下一步的小範圍驗證。
不再使用時,返回 Home 關閉開關,並確認狀態已恢復。若裝置上還有其他正在運作的 VPN 設定,測試前請先確認目前由哪個設定接管連線,避免同時切換而造成誤判。首次設定時先維持手動連線;完成基本連線驗證後,再另行設定 On Demand。
步驟 04 / 分別檢查狀態、連線能力與實際使用結果
Connectivity Test:確認連線是否生效
驗證分三個層次進行:先查看連線狀態,再測試伺服器,最後確認實際使用情況。每個層次各自回答不同問題,不能互相取代。Home 頂端顯示連線是否啟用;Connectivity Test 提供特定測試方式的結果;實際開啟網頁則能確認目前的網路、伺服器與模式組合是否可完成你的實際需求。
在 Home 點選 Connectivity Test,測試現有伺服器。先確認是否收到測試結果,再觀察結果是否穩定;不要把單次較低的延遲視為速度或可靠性的保證。不同測試方法的測量對象可能不同,數值只適合在測試方法相同、網路條件相近時參考。若某個項目逾時,請先重測一次並檢查基本網路,不要立即刪除整份訂閱。
接著開啟平常使用且已知可正常瀏覽的網頁,重新整理並嘗試前往另一個頁面,避免只看到先前快取的內容。先測試簡單網頁,再測試實際需要使用的 App。若簡單網頁可正常開啟,只有特定 App 失敗,問題範圍已縮小,不應直接認定所有連線都失效。
使用 Config 時,還要確認結果是否符合自己的分流需求。有些目標原本就應走 DIRECT,其他目標才使用代理;直接連線成功並不能證明代理路徑有效。可搭配 App 提供的連線記錄,查看目標符合的規則與策略,再對照目前的設定檔。記錄可能包含網域或其他連線細節,分享前請先遮蔽敏感資訊。
若連線狀態正常、測試有回應,且實際使用結果符合預期,首次連線便已完成。可記下使用的伺服器備註、Global Routing 模式與網路類型,作為日後排查的基準。若任一層未通過,請在下一步由基本網路開始逐層檢查 App 設定,不必反覆重做整套匯入流程。
步驟 05 / 保留現有資料,逐層縮小問題範圍
Settings 與首次連線常見問題
先判斷問題發生在哪個步驟:訂閱未載入項目、開關無法維持啟用、Connectivity Test 沒有回應,或只有部分連線異常。不同情況需要不同的檢查方式。先記下明確的介面提示,再處理相關環節;不要一開始就刪除 App,以免同時失去本機設定與排查線索。
先檢查基本網路與訂閱讀取狀態
暫停連線,確認目前的 Wi-Fi 或行動網路本身可正常使用;若網路需要登入,請先完成網路驗證。接著檢查訂閱是否更新成功。若更新失敗,請核對完整連結、有效狀態與複製內容;必要時向自己的服務供應商確認原連結是否仍有效。訂閱網址可能包含帳戶憑證,請勿將完整連結貼在公開截圖或求助內容中。
接著核對伺服器欄位與模式
手動新增的項目應逐一對照原始資料,特別檢查 Type、Host、Port、Password,以及該協定要求的其他參數。欄位存在不代表填入的值正確;相似字元、內容遺漏或選錯 Method 都會影響連線。若訂閱匯入的項目由訂閱管理,請先確認更新狀態再決定是否編輯,以免本機變更在下次更新時遭到覆蓋。
若伺服器測試有回應,但實際使用仍失敗,請返回 Home 檢查 Global Routing。在 Config 模式下,確認選取的設定檔與規則策略;必要時暫時切換至 Proxy,進行單一條件比較。若只有 Config 出現異常,請優先檢查規則與策略,不要重新輸入已確認可用的伺服器。若目前是 Direct,則先確認是否符合本次測試目標。
最後檢查測試設定與系統權限
進入 Settings,找到 Test Method 並確認目前使用的測試方法,再返回 Home 以相同方法重新測試。Settings 中的 Diagnostics 可作為進一步檢查的入口;診斷資料的作用是提供線索,無法自動修復所有連線問題。整理記錄時,只保留錯誤提示、測試方法與問題發生步驟,並遮蔽密碼、訂閱連結和其他憑證。
若頂端一直顯示 Not Connected,請確認首次系統授權是否曾遭取消,並重新發起連線以查看提示。若開關已啟用但實際使用仍失敗,請返回檢查伺服器與模式,不要只反覆調整系統權限。若記錄中的錯誤訊息不熟悉,可依問題現象參閱疑難排解,避免只憑單一字詞就變更多項進階設定。
On Demand:完成基本連線後再設定
On Demand 用於依設定條件發起連線,並非修正伺服器參數的開關。請先完成手動連線與停止連線的驗證,再依自己的網路使用習慣進行設定。若測試時發生自動重新連線,請檢查是否已啟用 On Demand,並在了解目前條件後暫時調整。首次操作時,不必同時變更 Settings 中的 Proxy、TCP 或 UDP 等進階項目。
本教學的完成標準是:可選擇現有伺服器、Global Routing 符合需求、開關可正常啟用與停用,且實際使用結果已完成驗證。之後再整理訂閱、更新與備份,請參閱節點管理手冊;遇到特定問題時,保留目前設定並依問題分類繼續排查,比從頭重做更容易找出原因。