Shadowrocket 完整使用手冊

先確認取得管道

Shadowrocket 是 Apple 平台的付費用戶端，iPhone 與 iPad 是本手冊主要說明的裝置。請透過 App Store 產品頁取得；Mac、Apple TV 與 Apple Vision 的相容性也請在同一個商店頁面確認。不要只憑裝置名稱推斷系統需求或購買適用範圍：系統需求、支援裝置與目前價格，均以 App Store 頁面標示為準。購買前請先確認目前使用的 App Store 商店地區，以及該商店的產品頁是否顯示可購買。搜尋結果僅供查找，最後仍應以產品詳細資訊頁為準。

辨認產品時，請同時確認三項資訊：App 名稱為 Shadowrocket，開發者為 Shadow Launch Technology Limited，產品連結中的 App ID 為 932747118。頁面顯示的圖示應與商店產品圖示一致，但不能只憑圖示判斷；名稱或圖案相似的搜尋結果也可能指向不同產品。進入產品頁後，請確認完整的開發者名稱，再檢查網址中的 id932747118。三項資訊相互核對，比只記住「小火箭」這個中文別稱更可靠。詳細確認位置與裝置說明，請參閱正版確認頁。

區分 App 費用與連線資料

購買費用是 Shadowrocket 用戶端本身。美國商店頁曾顯示約 2.99 美元的一次性買斷價格；實際價格、幣別與購買條件，請以目前的 App Store 頁面標示為準。用戶端一次性買斷 ≠ 連線方案：完成購買只代表可以取得 App，不會自動產生可供連線的伺服器資訊。後續匯入步驟以你已經持有自己的訂閱或伺服器參數為前提；若尚未取得這些資料，可以先閱讀路由與介面說明，但不能把 App 內尚未出現 SERVER 項目解讀為購買失敗。

在 iPhone 或 iPad 完成購買後，請返回 App Store 產品詳細資訊頁安裝，並等待系統完成作業。若按鈕顯示可重新取得 App，請先確認目前登入的購買帳號，再查看 App Store 的已購項目；不要只憑裝置桌面上是否有圖示判斷購買紀錄。更換裝置或重新安裝時，購買紀錄與自行匯入 App 的設定是兩回事：重新取得 App 不代表既有訂閱、伺服器備註和自訂規則一定會還原。準備移轉時，請先保留自己有權使用的原始資料，再依新裝置的實際狀況匯入。

將「產品是否正確」、「是否已取得 App」和「是否已備妥連線資料」分開確認，可減少後續誤判。例如開啟 Home 後清單為空，請先確認是否已匯入，而不是再次購買；連線後無法瀏覽目標網站，請先檢查伺服器、路由與網路，而不是將問題歸因於圖示或商店帳號。完成上述準備後，再進入首次啟動與 VPN 設定權限的檢查。

先認識 Home 的幾個位置

首次開啟 Shadowrocket 後，先在 Home 查看目前狀態，不必立刻更改所有選項。Home 是開始連線操作的起點：頂端的連線開關與狀態文字會顯示目前連線狀態，Global Routing 決定流量採用哪種路由方式，SERVER 區域可查看並選取已加入的伺服器，Connectivity Test 則可協助檢查連線。首次進入時看到 Not Connected，只表示目前尚未建立連線；若 SERVER 還沒有可選項目，請先完成匯入。不同螢幕尺寸與 App 版面可能使項目位置有所不同，尋找時請以英文介面名稱為準。

建議依照「查看狀態—確認資料—選擇路由—開啟連線」的順序操作。如此一來，系統權限提示出現時，就能清楚知道是哪個開關操作觸發的，不會把權限要求、伺服器匯入和規則選擇混為一談。若先開啟開關，卻沒有選取可用伺服器，之後發生連線失敗時，反覆允許權限也無法單獨解決問題。記下操作前看到的狀態文字，也有助於下次檢查時判斷狀態是否確實改變。

了解系統授權提示

在 iPhone 或 iPad 首次嘗試開啟連線時，系統可能會要求允許 Shadowrocket 加入 VPN 設定。這是系統確認網路設定變更的步驟，不代表已連上某台伺服器。請閱讀提示中的 App 名稱與系統說明，確認與目前操作相符後，再依系統指示完成授權；裝置也可能要求輸入密碼或使用生物辨識確認。授權完成後返回 App，仍須檢查連線開關、所選 SERVER、Global Routing 與驗證結果。狀態列出現 VPN 標示，只能證明相關網路設定已啟用，不能證明所有目標都能依預期存取。

若取消提示，請先返回 Home 檢查開關狀態，再透過 App 內的連線操作重新觸發，不要快速反覆切換開關。若先前已允許設定，但之後連線時仍看到權限相關提示，可先確認裝置目前是否允許變更 VPN 設定，以及是否受到其他裝置管理限制；實際可操作項目依裝置設定而異。不要為了處理一般伺服器參數錯誤而反覆刪除系統設定。請先分辨錯誤發生在「授權前」、「授權後但尚未連線」，還是「已連線但存取異常」；這三種情況的檢查方向不同。

在 iPad 上沿用相同的判斷順序

iPad 的寬螢幕版面可能使 Home 上的清單與控制項呈現方式和 iPhone 不同，但權限性質並未改變：系統確認的是裝置上的 VPN 設定，SERVER 資料仍須由使用者自行匯入。首次在兩種裝置上使用時，請分別確認各自的系統授權與 App 內選取項目，不要假設一台裝置的允許操作會自動套用到另一台。同一 Apple ID 的購買紀錄，請從 App Store 已購狀態確認；連線資料則應分別查看各裝置上的實際清單。

確認權限後，請先保持連線關閉，匯入既有資料並檢查欄位。若找不到開關、清單或測試入口，可參閱首次開啟與 Home 區塊說明。此階段最有用的紀錄不是「能否開啟網頁」，而是 App 是否正常啟動、Home 是否顯示、系統權限是否已確認，以及 SERVER 是否仍為空白。這些資訊可界定下一階段匯入問題的排查範圍。

先判斷資料類型

Shadowrocket 的伺服器項目可透過手動輸入、單一分享連結或訂閱取得。開始前，請先確認自己已持有哪一種資料：伺服器位址、連接埠、協定與驗證欄位適合逐項填寫；以協定前綴開頭的分享連結通常代表單一項目；由服務提供者提供、用來定期取得一組項目的 URL，則應以 Subscribe 方式處理。訂閱 URL 與單一伺服器位址不可互換；將前者填入伺服器位址欄位，或把單一分享連結當成訂閱更新網址，都會造成難以判斷的錯誤。

手動新增時，請在 Home 找到新增入口並進入 Add Server，先選擇與既有資料相符的協定類型，再逐項填寫。位址填入主機名稱或 IP，連接埠須與資料一致，驗證資訊則依該協定的要求填寫；備註可協助辨認項目，但不是連線參數。複製貼上時請留意內容前後的空格、數字連接埠、區分大小寫的欄位，以及容易混淆的字元。儲存後返回 SERVER，確認新項目已出現，並檢查實際選取的是哪一項，再啟動連線。App 支援的欄位以 Add Server 目前顯示為準。

依協定檢查必要參數

表格僅用來找出檢查方向，並非通用填寫範本。即使是相同名稱的協定，也可能有不同的傳輸、安全性與網域參數；不要憑記憶取代服務提供者給定的值。WireGuard 的 PrivateKey 是本機身分資料，PublicKey 與 Endpoint 則各有不同用途，詳細說明請參閱WireGuard 參數說明。任何驗證資料都不要在公開頁面、截圖或求助訊息中完整揭露。排查欄位時，請優先自行逐項比對原始資料。

匯入與更新既有訂閱

若已有 Subscribe URL，請使用 App 內對應的訂閱新增方式，貼上完整網址並儲存，再執行 App 提供的更新操作。訂閱示例網址如 https://example.com/sub?token=xxxx 僅用於說明 URL 格式，不能用來連線。更新成功後，還應返回 SERVER 確認是否已產生項目，以及目前選取的項目是否仍符合需求。匯入成功與伺服器可用是兩回事：前者表示 App 已取得並解析資料，後者仍須透過連線與目標存取測試確認。關於 ss://、vmess://、vless://、trojan:// 單一連結與訂閱 URL 的差別，請參閱分享連結與訂閱連結說明。

更新失敗時，請先檢查裝置是否能連到訂閱網址、URL 是否遭截斷，以及原始資料是否仍有效；若顯示更新完成但清單為空，請再確認訂閱內容與 App 可辨識的格式。不要為了測試而將私人 URL 貼到公開檢測網站。Scan QR Code 可用來匯入自己持有的有效資料，但掃描後仍須確認欄位與來源。資料進入 SERVER 後，下一步是選擇 Global Routing；清單中出現項目，不代表分流已設定正確。

先選模式，再檢查規則命中

Global Routing 決定流量採用哪種路由判斷方式。介面中的 Config、Proxy、Direct 可分別理解為依設定判斷、統一經由所選代理路徑，以及統一採用直連路徑。中文說明僅用來解釋行為，實際查找設定時仍請以英文名稱為準。切換模式通常不必重新輸入伺服器資料，但會改變連線結果的解讀方式：同一個目標在 Config 下可能命中 DIRECT，在 Proxy 下則會經由所選伺服器。因此排查時務必先記下目前模式，否則「開關已開卻沒有經過伺服器」可能只是路由選擇的正常結果。

使用 Config 時，最需要了解的是規則順序與預設策略。規則通常由具體比對逐步延伸至較一般的比對：DOMAIN 指定完整網域，DOMAIN-SUFFIX 比對網域後綴，DOMAIN-KEYWORD 依關鍵字比對；GEOIP、IP-CIDR 與 IP-CIDR6 則用於判斷 IP 位址範圍。規則右側的 PROXY、DIRECT、REJECT 是處理策略，不是協定名稱。PROXY 仍須使用已選取且可用的伺服器，DIRECT 會透過裝置目前的網路直接存取，REJECT 則拒絕符合條件的請求。USER-AGENT 也是可見的規則關鍵字；是否適用於特定請求，請以 App 內的比對結果為準。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
GEOIP,CN,DIRECT
FINAL,PROXY

上方的 example.com 是示例網域，片段僅展示規則之間的關係，不應直接視為完整設定。第一行讓該網域及其子網域採用 PROXY；第二行示範關鍵字比對後採用 REJECT；第三行示範 GEOIP 與 DIRECT 的組合；未由前面規則處理的請求，則由 FINAL 決定去向。若將 FINAL,DIRECT 設於末尾，未命中的請求便會採用直連策略。修改前請先儲存目前的 Config，並記錄具體目標與預期行為，避免同時變更多條規則而無法判斷是哪一項改變了結果。

透過三種模式縮小故障範圍

若某個目標在 Config 下存取異常，可先確認測試範圍，再比較 Proxy 與 Direct 的結果。若 Proxy 可存取而 Config 不行，請優先檢查規則命中與 FINAL；若 Proxy 也失敗，請回頭檢查所選伺服器參數、驗證資訊、網路連線與目標本身。若 Direct 可存取而 Config 異常，並不代表必須永久改用 Direct，應繼續找出符合該請求的規則。比較三種模式是一種診斷方式，不是適用於所有網路環境的固定建議；測試結束後請恢復所需模式，並重新驗證常用目標。

設定檔可能還包含規則以外的設定，例如 DNS 相關項目。請求的最終結果可能同時受網域解析、IP 規則、路由模式與目標服務影響。不要將某個測試網站提供的單一結果，視為整份 Config 正確無誤的證明。若要進一步了解術語，請參閱術語表；若要設定 DNS，請閱讀DNS 設定說明。

將連線拆分為幾個可觀察階段

開始連線前，請先在 SERVER 選取自己已有的伺服器，確認 Global Routing 是剛才決定使用的模式，再操作 Home 上的開關。接著依序觀察：系統權限是否已允許、App 狀態是否從 Not Connected 改變、裝置是否顯示相應網路狀態、Connectivity Test 是否有結果，以及實際目標能否如預期存取。這些觀察項目不能互相取代。開關已開啟，不代表伺服器驗證成功；某個位址測試成功，也不代表所有網域都會命中相同規則。

Connectivity Test 適合快速比較，但測試目標、目前網路與路由設定都會影響結果。測試失敗時，請先確認裝置本身可正常連網，再檢查所選伺服器是否仍是要測試的項目；若剛更新過 Subscribe，更要重新確認選取項目。接著確認目前使用的是 Config、Proxy 還是 Direct，再以相同目標重測，避免每次都更換網路與目標。記錄「模式、所選項目、測試目標、觀察到的現象」這四項，比只寫「無法連線」更容易找出原因。

依照現象分流排查

若無法啟動連線，請先檢查系統 VPN 設定權限與 Home 狀態，不要急著修改規則。若顯示已連線但無法存取目標，請先判斷該目標是否被 Config 中的 REJECT 或 DIRECT 規則處理，再檢查 PROXY 所使用的伺服器。若只有少數網域異常，請重點核對對應的 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 與 DNS；若所有目標都異常，則優先檢查裝置的基本網路連線、伺服器欄位、驗證資訊與所選項目。目標網站暫時無法使用也可能造成類似現象，因此請選擇不只一個熟悉的目標交叉驗證。

需要確認既有伺服器參數時，請先比對最初取得的資料，不要任意更換協定、連接埠與安全性設定。位址解析正常但仍無法連線，可能與驗證或傳輸參數有關；訂閱可以更新但伺服器無法使用，也只能表示資料取得步驟成功，不能略過伺服器驗證。反過來說，單一伺服器可用但某份訂閱更新失敗，則應集中檢查訂閱 URL 是否完整且可存取。將「取得設定」、「建立連線」與「存取目標」分成不同階段，才不會在排查時陷入反覆循環。

連線穩定後再檢查長期使用情況

第一次成功存取目標後，請再測試幾種常見情境：裝置從一個已知網路切換到另一個網路、鎖定螢幕再解鎖、更新訂閱後重新選取項目。切換網路可能改變 DNS、可用路徑或連線維持狀態；一次成功不代表之後在所有環境都不必再檢查。若平時使用 On Demand，請先了解觸發條件，再納入測試；否則自動連線可能會干擾手動開關的測試結果。關於 On Demand 與背景使用的取捨，請參閱按需連線與耗電排查。

驗證完成的標準不是某個狀態指示亮起，而是預期採用 PROXY 的目標能如預期存取、預期採用 DIRECT 的目標仍可正常使用，並且切回日常使用的 Config 後結果一致。具備這些條件後，Data 中的數字才有明確的解讀基礎。若現象無法歸入上述分支，可返回教學主流程，逐步確認輸入、選取與開關操作順序，避免在狀態不明時繼續疊加設定變更。

先確認統計範圍

Data 用於查看 App 顯示的流量資訊。進入該頁面前，請先記下目前連線狀態、所選伺服器與 Global Routing，再查看計數。數字是否變化，應在這些條件下解讀：部分請求可能採用 DIRECT，部分請求可能遭到 REJECT；裝置上的其他活動、背景重新整理與先前的連線，也可能使觀察期間的數字不只對應剛開啟的單一頁面。不要直接將 Data 中的總量描述為「某網站用了多少流量」，也不要把 App 內統計視為與電信業者帳單完全相同的計量方式。

比較前後數據時，請先確認觀察的起點與終點。可以先記下目前數值，再瀏覽一個熟悉的目標，然後返回 Data 查看變化；若期間切換了網路、伺服器或路由模式，請一併記錄。不同檢視畫面可能依連線、項目或時間範圍呈現資訊，請先看清頁面標籤再比較。介面實際提供哪些篩選與重設功能，以目前 App 內顯示為準；不要根據他人的截圖推斷自己的頁面一定有相同按鈕。

用統計輔助判斷，不以此取代連線測試

流量增加代表觀察範圍內有相關資料活動，但單憑這點無法證明目標內容已正確載入，也無法證明每個請求都經由 PROXY。若 Data 沒有立即變化，請先確認連線是否持續、請求是否確實送出，以及目前篩選範圍是否涵蓋測試時段，再返回 Home 與 Connectivity Test 核對。尤其在 Config 模式下，同一個 App 發出的不同請求可能符合不同規則，單看累計數值很難還原各請求的路徑。若要判斷單一目標，應一併參考路由規則、連線狀態與目標的實際表現。

排查「流量看起來偏多」時，先進行可重複的小範圍觀察，不要一次關閉所有功能。記下開始時的數值，暫停目前進行中的大量流量作業，再依平常的網路使用方式觀察一段時間。若只有在背景執行時持續增加，可對照系統的電池與網路使用資訊，並檢查是否啟用了 On Demand 等可能影響連線時機的設定。兩處統計的範圍與計算方式可能不同，數值有差異不必立刻歸因於 App 異常。先確認單位、時間範圍及是否計入背景活動，再決定是否調整設定。

保留可供回查的紀錄

若要向自己的服務提供者詢問連線資料問題，只需說明網路類型、所選協定、連線時段與可重現的現象；不要附上完整訂閱 URL、密碼或金鑰。Data 截圖也應先確認是否含有帳號、伺服器備註或其他個人資訊。若懷疑某條規則使流量走向與預期不同，請返回 Config 逐條檢查處理策略，而不是只重設統計。重設只能改變觀察起點，無法修正路由邏輯。

Data 最適合回答「在這段已知條件下，流量有沒有變化、變化是否大致符合操作」。它無法單獨回答「伺服器為何驗證失敗」、「某個網域命中了哪條規則」或「商店購買是否成功」。前兩個問題應回到連線與 Global Routing 章節；購買問題則請參閱已購項目還原說明。了解工具的用途後，統計數值才能成為排查線索，而不是新的誤判來源。

先保留可用的基準設定

Settings 集中管理會影響使用習慣與連線行為的選項，但首次成功連線後，不需要逐項調整。建議先記錄一組已驗證可用的基準設定：所選 SERVER、Global Routing、目前的 Config，以及是否使用 On Demand。之後只針對明確問題調整相關設定，每次修改一項，再造訪相同的測試目標。如此一來，若結果變差，就能知道該還原哪項設定，不必在多個開關都變動後猜測原因。不同裝置與 App 頁面可能顯示不同項目，名稱與可用範圍以實際介面為準。

On Demand 會依設定條件決定何時建立連線，不是提升特定伺服器速度的按鈕。若日常需要在特定網路環境下自動連線，請先確認觸發條件與例外情況，再啟用相應設定；測試時觀察加入網路、離開網路與重新解鎖裝置後的狀態。若正在排查手動連線問題，請先讓測試條件保持簡單，避免自動操作覆蓋剛完成的開關操作。若對背景活動或耗電有疑問，也應先查看系統提供的電池使用情況，再配合連線頻率判斷；不能只憑 App 維持連線就推定原因。

區分 DNS 與路由規則

DNS 負責將網域解析為後續連線所需的資訊；Global Routing 與 Config 規則則決定如何處理請求。兩者彼此相關，但不是同一項設定。系統 DNS、自訂 DNS 與 DNS over HTTPS 各有適用情境；變更解析方式後，請重新測試先前出問題的網域，同時保留一個不受該問題影響的對照目標。若原本問題來自伺服器驗證錯誤，修改 DNS 通常無法直接修復；若只有特定網域出現異常，則值得一併檢查解析結果與規則命中情況。

在 Config 中看到 dns-server 等項目時，請先確認目前編輯的是哪一份設定，以及變更後是否確實已啟用。不要直接將教學範例中的解析位址視為適用於所有網路的預設值。記錄舊值、修改一項、儲存、重新測試，並確認是否需要重新整理相關連線，才算完成一次設定測試。三種解析方式與驗證步驟詳見DNS 設定說明。若 Config 來自自己已有的資料，編輯前也應考慮後續更新是否會覆蓋本機修改。

處理設定檔與裝置之間的差異

同一份連線資料匯入 iPhone 與 iPad，也不代表兩台裝置的 Settings 完全相同：系統網路、權限狀態、所選 Config 與本機偏好都應分別確認。Import from Cloud JSON 等匯入項目只有在你確實持有相應格式的資料時才有用途，不能任意用一般訂閱 URL 取代。匯入後請先確認實際內容，再決定是否啟用；來源不明的設定不宜直接覆蓋目前可用的設定。

維護設定時，請先回答三個問題：想改善的現象是什麼、哪個選項可能直接影響該現象，以及如何確認變更確實有效。若無法回答，就先保留已驗證的基準設定。Settings 的用途是依需求微調行為，而不是讓所有選項都維持某種統一狀態。查找英文介面名稱與規則關鍵字時，可搭配術語表；完成設定後，再依連線章節的方法實際驗證目標。

將更新分為兩種

日常維護首先要區分 App 更新與連線資料更新。Shadowrocket 本身透過 App Store 更新；商店頁面可查看 App 資訊、相容性與更新紀錄。Subscribe 更新則是 App 透過你已有的訂閱 URL 重新取得設定內容，兩者不會因名稱都有「更新」就自動同步。發現新項目沒有出現時，請先檢查訂閱更新與 SERVER；若 App 功能或介面說明與手冊不同，則先確認 App Store 頁面及 App 內目前顯示的文字。不要以伺服器清單的變化推斷 App 版本，也不要以 App 更新推斷訂閱內容已重新整理。

準備更換裝置時，請先確認 App Store 的已購紀錄與目前裝置可使用的購買帳號，再整理自己有權使用的訂閱 URL、手動填寫所需欄位、個人 Config 修改與必要備註。請將私人資料存放在自己能妥善管理的安全位置，不要把完整 URL 或金鑰貼到公開討論區。新裝置取得 App 後，依照「權限—匯入—選取伺服器—Global Routing—驗證」的順序重新確認。即使兩台裝置使用同一購買帳號，也應分別確認 App 內實際有哪些項目，以及目前選取了哪份設定；已購狀態不能取代 App 資料檢查。

發生故障時保留必要資訊

方便回顧問題的紀錄應包括：故障開始的大致時間、使用 iPhone 或 iPad、目前網路類型、連線前後的 Home 狀態、所選協定與伺服器備註、Global Routing 模式、測試目標及結果。若問題在修改後才出現，也要記下剛調整的設定。備註只需用來辨認項目，不要記錄密碼、金鑰或完整訂閱網址。先重現一次問題，再只改變一個條件重新測試；若結果改變，就沿著該方向繼續檢查。同時變更多項設定，會增加下次處理相同問題的難度。

可依固定的判斷順序整理問題：App 能否正常開啟；SERVER 是否有預期項目；是否已確認系統 VPN 設定權限；連線狀態是否改變；所選伺服器在 Proxy 下是否可用；目標在 Config 下命中了哪條規則；Data 是否在已知測試中有所變化。每個問題都對應本頁前述階段。若訂閱無法更新，不必先修改 DNS 與所有規則；若只有特定網域失敗，也不必先重新安裝 App。先將問題定位到相應階段，再檢查該階段的參數與特殊情況。

定期確認，不要頻繁重設

日常可定期查看 App Store 產品頁、已儲存的原始資料是否仍可使用，以及常用目標在目前 Config 下是否符合預期。網路環境改變時，先重新進行簡短驗證，再決定是否調整 On Demand 或 DNS。規則使用的網域、位址範圍與個人需求都可能改變，過去有效的比對不代表永遠適用；每次調整都應保留可還原的舊設定。清空清單、重設統計或重新匯入所有資料，應在確認目的與備份範圍後執行，不應在測試失敗一次時就當成預設的第一步。

本手冊的終點不是某個「完成」按鈕，而是一套可重複執行的檢查順序：從 App Store 確認產品，檢查權限與既有資料，在 Global Routing 中選定路徑，實際驗證連線，以 Data 輔助觀察，並只在 Settings 中調整目的明確的選項。若要重新走一次簡短流程，請返回快速入門教學；若要確認購買與裝置條件，請查看App Store 正版說明。本手冊中的操作位置，請隨時以 App Store 頁面及 App 內目前顯示的文字為準。