本文適合已經有自己的服務商與訂閱，準備開始使用 Shadowrocket（小火箭）的使用者。內容依序說明安裝準備、連線開關、路由模式、設定規則、訂閱維護與故障檢查；Home、Config、Settings 的操作以 iPhone / iPad 介面為例，其他平台的選單位置可能不同。閱讀後可依循從設定到實際請求的檢查順序，不必反覆切換無關選項。
1. 安裝後，首次連線還需要準備什麼？
安裝 App 不代表已經具備可連線的伺服器。Shadowrocket 是閉源商業 App，可讀取連線參數、建立連線並套用路由規則。首次使用前，請準備自己已有的訂閱連結或單一連線設定，並確認服務仍在有效期限內。本文不提供、不販售也不推薦節點或訂閱。
取得方式分為兩種：iPhone / iPad 版透過 App Store 一次性付費 $2.99，開發者為 Shadow Launch Technology Limited，系統需求以 App Store 頁面標示為準；Mac（Apple 晶片 / Intel）、Windows、Android、Linux 版免費。各平台的取得方式請參閱下載頁，App 費用不包含線路方案。
-
準備設定資料
向自己原有的服務商確認訂閱網址、有效期限及裝置使用限制。網址中的 token 屬於憑證，請勿貼到公開討論區。
-
匯入訂閱
Home → 點選右上角「+」→ Type → Subscribe，在 URL 欄位輸入自己的訂閱網址，確認後儲存。
-
選擇連線
返回 Home，確認訂閱已載入項目，再選擇一個現有節點。若只看到訂閱名稱，沒有節點清單，請先檢查訂閱的取得結果。
-
允許連線
開啟 Home 的連線開關；iPhone / iPad 首次出現新增 VPN 設定的系統提示時，閱讀內容後允許，並依系統要求完成身分驗證。
2. Home 開關無法啟用，或開啟後馬上關閉，該怎麼辦？
先分辨是「系統不允許建立連線」還是「連線已建立，但請求失敗」。前者通常會看到開關無法維持開啟；後者則可能仍顯示 VPN 狀態。VPN 圖示只能表示系統連線狀態，無法證明所選的遠端節點可用。
- 沒有可選項目：返回 Home 檢查匯入結果，確認已選取完整設定，而不是只填寫了訂閱名稱。
- 取消首次授權：重新開啟開關並處理系統提示；若裝置受組織管理，請檢查管理政策是否限制 VPN 設定，避免反覆刪除系統設定。
- 連線衝突：先中斷其他正在占用系統 VPN 連線的 App，再單獨測試 Shadowrocket。
- 開關維持開啟：接著檢查節點連線狀態、Global Routing 和 DNS，不要再將故障歸因於授權問題。
3. Global Routing 的 Config、Proxy、Direct、Scene 該怎麼選？
Global Routing 會決定目前的請求採用哪種路由方式。日常使用已有有效規則的設定時，選擇 Config；若要確認某個請求是否受規則影響，可暫時切換到 Proxy 作比較。切換前先記下原本的選項，測試後再恢復。
Config
建議依據目前啟用的 Config 及其規則選擇策略。結果可能是 DIRECT、PROXY 或其他已定義的策略，並非所有未符合規則的請求都會自動直連；實際行為取決於兜底規則。
適用情況：日常使用已有有效規則的設定。
Proxy
由用戶端處理的請求會統一以代理方式轉送，不會依照 Config 中的一般分流規則逐條選擇路徑。這不會讓失效的節點恢復，也不代表伺服器支援所有流量類型。
適用情況：暫時比較規則分流與代理連線的結果。
Direct
由用戶端處理的請求會直接連線，不經過所選的遠端代理。這與關閉連線開關不同，用戶端仍可能處於執行狀態。
適用情況：確認目前網路能否直接連線。
Scene
依照已設定的場景條件套用對應的路由設定。此模式需要事先建立場景，並非自動偵測後替使用者挑選最快節點。
適用情況：已明確設定不同網路場景的使用者。
4. Config 和 Rule 有什麼不同？修改哪個才會生效？
Config 是設定檔及其管理入口；Rule 則是設定檔內的一組比對規則。Home 儲存的節點參數決定「連線到哪裡、使用什麼協定」，Config 中的規則則決定「這個請求應該走哪條路徑」。成功匯入訂閱，不代表也取得完整的分流設定。
在 Global Routing 選擇 Config 時，請確認 Config 中實際啟用的是哪個檔案，再編輯其中的規則。只修改未啟用的檔案，不會改變目前請求的路徑。規則通常依序比對，較具體的例外規則應排在較廣泛的規則之前。
[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXYDOMAIN-SUFFIX：比對指定的網域後綴；此處的 example.com 僅為語法範例，不是建議直接匯入的完整規則集。IP-CIDR：比對 IP 網段；範例中的no-resolve表示不會為這條 IP 規則額外發起網域解析。GEOIP：依據 IP 地理資料庫進行比對，國家代碼不代表網站內容使用的語言。FINAL：接收前面規則都未比對到的請求；本例使用 PROXY，因此不能概括為「其餘全部直連」。
5. 匯入時，如何分辨訂閱連結和單一分享連結？
單一分享連結通常以 ss://、vmess://、vless:// 或 trojan:// 開頭，用來描述一條連線；訂閱網址通常是 HTTP 或 HTTPS URL，取得後可傳回一組連線，並支援後續更新。不能只因網址很長，就判定它是訂閱。
依照現有設定的來源選擇匯入方式
已有訂閱網址
- 使用 Home →「+」→ Type → Subscribe。
- 將完整網址填入 URL，並保留查詢參數。
- 儲存後確認是否確實產生節點項目。
- 後續透過該訂閱更新，不要逐項改寫來源參數。
已有單一分享連結
- 使用連結匯入功能，或掃描自己已有的設定 QR Code。
- 匯入後確認 Type、伺服器位址與連接埠。
- 確認 TLS、傳輸方式等參數與來源一致。
- 匯入單一連線不會自動變成可定期更新的訂閱。
連結是承載設定的方式，也可能包含驗證資訊；匯入前請確認來源，排查問題時只分享已去識別的欄位。
6. 如何更新訂閱？更新失敗時先檢查什麼？
更新訂閱是重新取得遠端設定清單，不是更新用戶端程式，也不一定會更新目前 Config 的規則檔。在 Home 更新訂閱後，請確認節點清單及結果提示；更新成功不代表每個節點都能連線。
- 返回 Home，更新目標訂閱；使用下拉重新整理時，請留意目前畫面實際更新的訂閱範圍與結果提示。
- 若顯示逾時，先確認目前網路能否取得訂閱網址；網址過期、token 遭撤銷與網路逾時是不同問題。
- 只有在已有可用代理，而且該訂閱需要透過代理取得時，才前往 Settings → Subscribe 檢查 Update via Proxy，然後重試。
- 更新成功後，再次確認所選節點。伺服器可能刪除舊項目或更改名稱，請勿只依原本的位置判斷選取結果。
7. 延遲數字很低，為什麼網頁還是打不開？
延遲測試只反映特定測試方式、目標和當下網路條件的結果，不等於下載速度，也無法證明所有網站都能存取。例如顯示 80 ms，只能作為該次測試的參考；不能直接換算成檔案下載速率，也不能取代實際網頁請求。
- 先固定變數：選定同一個節點與網頁，記下目前的 Global Routing，再比較不同模式；不要同時切換節點和設定。
- 確認實際比對結果：在可用的請求記錄或日誌中，核對目標網域、比對到的規則與最終策略，確認請求沒有走錯路徑。
- 分辨解析失敗：若出現網域解析錯誤，請檢查 DNS 設定及解析請求是否可達，不要先把所有規則都改成 PROXY。
- 分辨單一網站故障：只有一個網站失敗時，檢查目標網站及驗證狀態；所有網站都失敗時，再檢查節點、網路與路由。
記錄「網頁網址、錯誤訊息原文、網路類型、模式、是否可重現」，比只記下一個延遲數值更有助於找出問題。完整檢查流程請參閱連線疑難排解手冊。
8. Settings → On Demand 有什麼用途？為什麼關閉後又自動連線？
On Demand 會在符合指定條件時要求系統建立連線，屬於連線觸發邏輯；Global Routing 則決定連線建立後如何分流，兩者用途不同。啟用 On Demand 不代表所有請求都會走代理，也不會改變伺服器的有效期限。
- 前往 Settings → On Demand，先確認是否已啟用，再檢查現有的觸發條件。
- 若手動中斷後又自動連線，先暫停 On Demand，再關閉 Home 開關，觀察是否仍會重新連線。
- 若問題只在連上特定 Wi-Fi 或切換網路後發生，記下當時的網路狀況，並逐項比對現有的觸發設定。
- 手動連線穩定後，再恢復自動觸發；每次只修改一項，分別測試 Wi-Fi 與行動網路。
不要為了處理一次斷線，同時修改 On Demand、Scene 和 Config。先分別驗證自動觸發與請求路徑，才能找出是哪項設定造成行為改變。
9. Shadowsocks、VMess、VLESS、Trojan 等協定需要自行修改嗎？
協定必須與現有伺服器設定一致，不能只為了「更快」就修改用戶端的 Type。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的驗證欄位與傳輸需求各不相同；使用相同的位址和連接埠，不代表可以互換協定。
- Shadowsocks：確認加密方式與密碼；不要直接填入其他協定的 UUID，並期待能建立相同的連線。
- VMess / VLESS：確認各自的驗證參數，以及來源指定的傳輸方式、路徑與 TLS 設定。
- Trojan：確認密碼與 TLS 相關欄位；連線位址和用於憑證驗證的名稱不一定相同，請依原始設定填寫。
- Hysteria2：需要相應的 UDP 網路可達性；TCP 網頁能開啟，不代表這類連線的底層通路可用。
- WireGuard：需要金鑰、對端與位址等設定，不是只填伺服器名稱就能完成。
10. 更換裝置、連接區域網路或準備尋求協助時，還要注意什麼？
保留可重現的檢查紀錄，再處理移轉或區域網路存取問題。設定同步、伺服器的裝置數量限制，以及目前網路的存取權限彼此不同；將同一份訂閱匯入另一台裝置，不代表伺服器一定允許增加同時連線數。
改用 Mac 時，需要重新設定什麼？
先從下載頁依 Apple 晶片或 Intel 選擇對應版本，再匯入自己已有的設定。確認伺服器允許使用的裝置數量；不要假設 iPhone 的系統 VPN 授權、On Demand 條件和本機檔案會自動移轉到 Mac。
開啟連線後，找不到印表機或 NAS？
先確認裝置仍在同一個區域網路，再到 Config 檢查目標網段是否依預期使用 DIRECT。使用 NAS 的區域網路 IP 測試，可區分位址是否可達與名稱探索問題；能透過 IP 存取，不代表廣播探索也一定正常。
尋求協助時應提供哪些資訊？
請提供系統平台、Home 開關狀態、Global Routing 選項、錯誤訊息原文及重現步驟。分享日誌前，請遮蔽訂閱 token、密碼、UUID 與金鑰；並說明問題發生在取得訂閱、建立連線，還是特定網頁請求階段。
首次排查依序確認「設定有效 → 系統授權 → 節點可達 → 路由比對 → DNS 與目標請求」。每次只修改一個變數，確認結果後再進行下一步。