第一次使用 Shadowrocket（小火箭），請先完成安裝、匯入自己已有的訂閱、選取可用連線，再開啟連線開關；確認基本連線正常後，再設定規則與自動連線。本文以十個常見問題說明 Home、Config、Settings 的用途，並提供逐項檢查方式。以下操作路徑主要參照 iPhone / iPad 介面，其他平台請依對應設定項目操作。
一、應該從哪裡安裝？
請從本站取得應用程式頁面選擇裝置。iPhone / iPad 版從 App Store 取得，一次性付費 $2.99；系統需求以 App Store 頁面標示為準。Mac（Apple 晶片與 Intel）、Windows、Android、Linux 版免費。桌面版與 Android 安裝檔可從取得應用程式頁面連至本站下載；電腦版不適用行動版商店的價格。
- iPhone / iPad：在 App Store 產品頁確認名稱 Shadowrocket、開發者 Shadow Launch Technology Limited，以及 App ID
932747118。 - Mac：先開啟系統的「關於這台 Mac」，確認顯示的是 Apple 晶片還是 Intel，再到取得應用程式頁面選擇相應版本。
- Windows、Android、Linux：依照作業系統及安裝檔說明選擇檔案；Linux 還需確認套件格式是否適用於目前的發行版。
安裝用戶端不等於取得線路服務。本文以使用者已擁有自己的服務商與訂閱為前提；本站不提供、不銷售、不推薦節點或訂閱。用戶端負責讀取連線參數並套用策略，能否連線仍取決於既有服務的狀態。
二、如何匯入訂閱？
訂閱是用來取得連線設定的網址，不是任意網頁連結。請先從自己既有的服務管理頁面複製完整訂閱網址，並保留查詢參數；若複製不完整、混入換行，或誤把登入頁網址當成訂閱網址，都可能導致匯入失敗。
-
取得訂閱網址
複製既有服務提供的訂閱連結。連結中的 token 是存取憑證，請勿公開於截圖、聊天記錄或問題排查說明中。
-
前往新增頁面
開啟 Home → 點選右上角「+」，在 Type 中選擇 Subscribe；不要將訂閱網址填入單一伺服器的 Address 欄位。
-
貼上並儲存
在 URL 欄位貼上完整連結，填寫方便辨識的備註後儲存。返回 Home，等待訂閱內容讀取完成。
-
確認匯入結果
確認 Home 顯示訂閱群組與連線項目，再選取其中一個。若只有群組而沒有項目，請先處理訂閱讀取問題，不要直接調整 Rule。
以下網址僅供辨識格式，並非可用訂閱：https://example.com/sub?token=xxxx。手動填寫 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard 時，請依照既有服務提供的協定參數輸入，不要只憑伺服器名稱猜測 Type、Port 或驗證欄位。
三、如何開啟連線？
先在 Home 選取一個連線項目，再開啟頂端的連線開關。iPhone / iPad 首次建立連線時，系統會要求加入 VPN 設定；確認這是自己剛才發起的操作後，依照系統提示授權。此授權是建立本機網路接管所需的系統步驟，不代表所有目標網站都已可連線。
- 確認 Home 有連線項目，且目前選取的是要測試的項目。
- 開啟連線開關並完成系統 VPN 設定授權；若先前取消授權，請重新嘗試連線並查看系統提示。
- 等待狀態顯示已連線，再分別造訪一個明確需要代理的目標，以及一個一般直連目標。
- 若開關立即關閉，請先記下錯誤訊息，再檢查連線參數、服務是否有效，以及是否有其他 VPN 工作階段正在使用連線。
連線開關、Global Routing 與所選連線分別控制「是否接管」、「如何分流」及「使用哪個連線承載」。只修改其中一項，不一定會改變最終連線結果。排查時一次只修改一個條件，才能判斷哪項操作有效。
四、分流模式該選哪一種？
日常使用通常選擇 Global Routing → Config，前提是已啟用符合需求的 Config。Config 不代表「所有境外網址都會自動走代理」；實際結果取決於規則、規則順序與策略設定。以下比較 Shadowrocket 的四種路由模式。
Config
建議依照目前啟用的設定檔中的規則與策略分流。請求可能直連、經代理或遭拒絕，應以實際匹配的規則為準。
適用情境：日常使用已設定妥當的 Config
Proxy
對用戶端接管且符合條件的請求採用代理模式，可暫時用來區分連線問題與規則問題；這不保證系統所有通訊都會經過代理。
適用情境：短時間確認所選連線是否可用
Direct
採用直連模式，不透過所選的遠端代理連線存取目標。即使連線開關已開啟，選擇此模式仍可能不經代理。
適用情境：檢查本機網路與目標的直連狀況
Scene
依照已設定的情境條件選擇相應的路由行為。請先檢查情境條件及關聯設定，不要將此模式視為固定的全域代理選項。
適用情境：已設定不同網路情境的使用者
若 Proxy 可以存取而 Config 不行，請優先檢查 Config 與 Rule；若兩種模式都無法存取，不能只據此判定規則有誤，還應檢查連線、驗證、DNS 與目標網站本身。
五、需要匯入 Config 嗎？
訂閱與 Config 解決的是不同問題：訂閱主要用來更新連線項目，Config 則決定規則及相關網路行為。Home 出現新的連線項目，不代表 Config 已切換。請前往 Config 確認目前啟用的檔案，再檢查其中的 [Rule] 區段。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY以下內容僅說明語法，並非可直接套用的完整設定。DOMAIN-SUFFIX 用來匹配網域後綴，IP-CIDR 用來匹配 IP 網段，GEOIP 依 IP 地理資料進行匹配，FINAL 則處理未匹配前置規則的請求。範例中的 no-resolve 用於避免這條 IP 規則主動觸發網域解析。
- 規則由上往下匹配，較具體的例外通常應排在較廣泛的規則之前。
- 先確認
PROXY對應的策略確實可用，再判斷規則是否設定錯誤。 - 不要將
FINAL放在仍需繼續檢查的規則之前，否則後續規則可能沒有匹配機會。
六、如何更新訂閱？
返回 Home，下拉重新整理訂閱，並確認更新是否完成及連線清單是否有變化。更新會重新讀取既有訂閱內容，不會延長服務期限，也無法自動修復伺服器端已停用的帳號。更新前可先記下目前的連線名稱，避免項目變動後誤以為原先選取的項目仍有效。
重新整理一直轉圈怎麼辦？
先確認目前的網路可以連上訂閱網域。若已有可用連線，開啟連線後再試一次；若需要透過代理讀取，請到 Settings → Subscribe 檢查 Update via Proxy。若目前沒有任何可用連線，不要指望這個選項能解決首次匯入問題。
更新後少了幾個項目？
訂閱更新會反映伺服器回傳的清單。請先確認既有服務是否調整了內容，再重新選取仍存在的項目；不要重複加入相同 URL，以免產生多個重複群組。
顯示格式錯誤或沒有內容？
檢查 URL 是否完整、有沒有多餘空格，以及服務是否回傳登入頁或錯誤頁。若明確顯示驗證失敗，請向自己既有的服務商確認網址或憑證，不要修改 Rule。
七、已連線卻無法開啟網頁，為什麼？
「VPN 已連線」只表示本機工作階段已建立；延遲測試有結果，也不代表前往目標網站的完整連線路徑正常。請使用相同目標與相同連線進行對照，記錄是逾時、解析失敗還是驗證錯誤，避免同時切換網路、連線與設定。
- 在 Home 執行 Connectivity Test，確認所選連線有測試結果；若失敗，先改用自己已有的其他項目進行對照。
- 檢查 Global Routing 是否誤設為 Direct；暫時切換至 Proxy 測試相同目標，測試後再恢復原模式。
- 若 Proxy 正常但 Config 異常，請核對目前的 Config、規則匹配結果及策略引用。
- 網域無法連線時，請檢查 DNS 相關設定與記錄。不要任意以目標 IP 取代 HTTPS 網域測試，否則憑證與主機名稱差異會影響判斷。
- 若 Wi-Fi 無法連線而行動網路正常，請保留相同連線進行比較，並優先檢查目前網路的限制或驗證頁面。
八、如何設定自動連線？
先手動連線並確認可以正常存取，再設定 Settings → On Demand。On Demand 會依照已設定的網路條件觸發連線，不會替你選擇必然可用的遠端服務，也不能取代訂閱更新。自動連線與 Global Routing 是兩項不同設定：前者決定何時建立連線，後者決定連線後採用哪種路由模式。
- 開啟 Settings → On Demand，檢查現有條件，確認是否已針對目前的 Wi-Fi 或其他網路設定連線行為。
- 先只設定一個明確情境，例如需要自動連線的網路，再切換網路確認結果。
- 若手動關閉後又自動連線，請回到 On Demand 檢查觸發條件，不要反覆刪除系統 VPN 設定。
- 若要完全暫停，請先停用相關的自動連線條件，再關閉 Home 的連線開關。
驗證時應觀察切換網路後的連線狀態，而不只是查看設定頁的開關。裝置休眠、網路重新驗證或系統排程都可能影響觸發時間；若手動連線本身失敗，應先排除基本連線問題。
九、如何在多部裝置上使用？
請分開確認「應用程式取得資格」、「設定內容」與「服務的同時連線限制」。iPhone / iPad 版在 App Store 一次性付費 $2.99；Mac、Windows、Android、Linux 版免費。應用程式可安裝在多部裝置上，不代表使用者既有的訂閱允許相同數量的裝置同時上線。
建議做法：分開處理取得資格與設定
iPhone / iPad
- 使用購買時的同一個 Apple ID，在 App Store 的已購項目中尋找並重新下載。
- 系統需求以 App Store 頁面標示為準。
- 在每部裝置上確認訂閱、目前的 Config 與系統 VPN 授權。
電腦 / Android / Linux
- 在本站的取得應用程式頁面選擇免費安裝檔；Mac 請區分 Apple 晶片與 Intel 版本。
- 依各裝置匯入自己已有的訂閱，並確認可用協定與參數。
- 先在單一裝置上測試，再確認既有服務允許的同時上線裝置數量。
購買記錄不會自動同步訂閱與 Config；每部裝置都要確認實際匯入結果。
若一部裝置連線後，另一部裝置立刻失效，請先查看既有服務的同時連線限制，不要預設是用戶端安裝失敗。移轉設定時，也應檢查規則引用、網路條件與檔案相依項目是否仍適用於新裝置。
十、換機前要備份哪些內容？
備份設定的目標是讓新裝置能重現相同的連線行為，而不只是保留一張 Home 截圖。訂閱 URL、單一連線的驗證資訊、目前的 Config 與 On Demand 條件各有不同用途；缺少其中一項，換機後可能出現「項目都在，分流方式卻不同」的情況。
- 記下既有服務的訂閱取得位置，並將完整 URL 存放在自己的安全儲存空間。
- 使用 Config 中可用的匯出或分享功能，儲存目前使用的設定，並確認外部規則資源仍可讀取。
- 記下 Global Routing 目前的模式，以及自己在 Settings → On Demand 中新增的網路條件。
- 在新裝置上先匯入訂閱、選擇連線並完成系統授權，再啟用 Config；最後還原自動連線條件。
- 尋求協助時，請提供作業系統、完整錯誤訊息、發生步驟及對照結果，並遮蔽訂閱 token、密碼及其他驗證資訊。
最精簡的驗證順序是：在 Home 確認項目 → 手動連線 → 測試目標 → 在 Config 檢查分流 → 在 On Demand 驗證自動連線。每個步驟確認正常後再繼續，才能分別排查取得、服務、規則與系統授權問題。