Shadowrocket 完整使用手冊

02 / FIRST LAUNCH

首次啟動與 VPN 設定權限

先認識 Home，再啟動連線

首次開啟 Shadowrocket 後，請先查看 Home，不要急著開啟連線開關。Home 集中顯示連線狀態，並提供 Global Routing、Connectivity Test 和 SERVER 等入口。SERVER 中需有可用資料，Global Routing 用來選擇路由方式，連線開關則負責啟動系統網路通道。這些項目各有不同用途：清單中有伺服器不代表已選取，選取伺服器也不代表通道已建立。

如果 Home 顯示 Not Connected，只表示應用程式回報目前尚未連線，不能據此判斷訂閱是否有效。請先檢查清單內容，再確認要使用的伺服器，最後核對路由方式。依此順序操作，可避免在清單空白或模式錯誤時就授權連線，之後又將所有問題歸咎於系統權限。介面概覽也可參考首次開啟與 Home 頁面說明。

初次使用時，保留預設設定通常較容易排查問題，不必一次啟用所有輔助功能。先以「使用現有資料完成一次手動連線」為目標；成功後再逐步調整 On Demand、DNS 或規則。將權限、資料與進階設定分開處理，才能清楚判斷是哪項變更影響操作，也方便還原到已驗證的狀態。

了解系統授權提示的用途

啟動連線時，系統可能會詢問是否允許新增 VPN 設定。這是 Apple 系統管理網路延伸功能所需的授權流程；允許後，裝置才能建立供 Shadowrocket 使用的 VPN 設定。系統可能要求輸入裝置密碼或進行其他身分驗證，請依畫面提示完成。授權不是購買步驟，也不會替你填入伺服器網址；它只讓用戶端具備啟動相應網路連線的系統條件。

VPN 設定與代理伺服器紀錄不是同一種資料。前者由系統管理，關係到通道啟動與權限；後者保存在應用程式中，說明伺服器、連接埠與驗證方式。因此，系統中有 VPN 設定，不代表 SERVER 清單一定正確；反過來，匯入成功也不代表系統授權已完成。檢查時應分別確認，不要直接刪除所有資料重來。

如果不小心點選拒絕，請先返回 Home，再嘗試啟動連線並留意授權提示是否再次出現。若沒有提示，請前往系統設定，尋找 VPN 或 VPN 與裝置管理相關項目，檢查現有設定與狀態；路徑名稱可能因系統版本和裝置而異。若裝置受組織管理，部分設定可能無法變更，請先確認管理限制，不要反覆嘗試修改系統政策。

連線受阻時，先排除權限衝突

裝置上若有其他 VPN 設定或網路延伸功能，請先確認目前實際啟用的是哪一項。測試期間，暫停可能同時接管網路的設定，再單獨驗證 Shadowrocket，避免自動連線條件互相觸發。保留其他設定的原始內容，不必為了單次排查全部移除；若使用的是工作或學校裝置，更應先確認設定用途與管理要求。

只有在明確懷疑系統設定損毀，且重新授權仍無法恢復時，才考慮重建相關 VPN 設定。操作前先保留應用程式中的伺服器與設定資料，停止連線，確認要處理的設定名稱，再依系統允許的方式移除並重新授權。刪除系統 VPN 設定無法恢復訂閱，也不應作為所有故障的第一個處理步驟。詳細說明請參閱VPN 設定提示說明。

完成授權後仍無法連線，請觀察失敗發生在哪個階段：開關立即關閉，可能與權限或延伸功能啟動有關；開關維持啟動但目標請求失敗，則應繼續檢查伺服器與路由。不同現象需要不同的排查方式，不能只憑「已授權」就判定一切正常。記下系統提示原文、目前網路類型與失敗操作，比反覆開關更有助於找出原因。

04 / GLOBAL ROUTING

Global Routing 三種模式與規則順序

Config、Proxy、Direct 各自的用途

Global Routing 用來選擇目前連線的路由方式。設定模式對應 Config，依目前設定檔中的規則決定請求去向；代理模式對應 Proxy，讓整體連線使用所選的代理路徑；直連模式對應 Direct，直接連線。這三種模式代表不同的連線行為，不是速度等級，也不是三台伺服器。切換模式不會更換驗證資料，仍需確認伺服器與設定檔有效。

排查時可短暫使用 Proxy 與 Config 比對：若同一目標在 Proxy 下成功、在 Config 下失敗，應優先檢查規則比對結果與策略去向；若兩者都失敗，再檢查伺服器與基礎網路。Direct 可用來觀察直接存取狀況，但比對結果只適用於當時的網路與目標。每次只變更一項條件，測試後恢復原本模式，避免忘記臨時設定。

Global Routing 不是能讓每個應用程式個別繞過路由的獨立開關。實際請求也可能受到系統網路、DNS、應用程式快取與設定例外影響。判斷流量路徑時應參照請求紀錄，而非只看目前的模式名稱。特別是瀏覽器重複使用連線或應用程式維持長連線時，切換模式後應重新發出請求，必要時結束舊工作階段，再查看新連線的路徑。

規則由上而下比對，先命中就先處理

在 Config 模式下，Rule 的順序會直接影響結果。通常應將範圍較小、條件明確的規則放前面，兜底規則放在最後。DOMAIN 用於完整網域比對，DOMAIN-SUFFIX 用於比對網域後綴，DOMAIN-KEYWORD 則依網域中包含的關鍵字比對。關鍵字規則的範圍可能很廣，不要只因為設定方便，就將它放在所有精確規則之前。

IP-CIDR 與 IP-CIDR6 用於比對位址範圍，GEOIP 則依據相應的位址資料判斷，不能將這些規則視為網域分類的同義寫法。網域解析結果、位址資料與實際請求形式都會影響比對。遇到「網域規則未命中」時，先確認請求紀錄顯示的是網域還是位址，以及前面是否有其他規則，不要只根據目標網頁標題推斷。

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

這段內容是教學用規則片段，並非完整連線設定。第一行將符合該網域後綴的請求交給 PROXY；第二行依 GEOIP 條件選擇 DIRECT；FINAL 則指定前面都未命中的請求採用最後的策略。加入自己的設定檔前，請先備份，並確認目前設定中有可用的對應策略。範例網域僅用來說明語法，不代表某一類網站都應採用相同策略。

策略名稱、兜底規則與設定生效

規則關鍵字說明「如何比對」，末尾策略則決定「比對後如何處理」。DIRECT、PROXY、REJECT 的用途不同，不能為了排查問題就將所有規則改成同一個詞。若設定檔使用自訂群組，規則引用的名稱必須與實際定義相符；名稱拼錯、群組不存在或群組內沒有可用項目，都可能讓看似正確的比對無法產生預期結果。

FINAL 應負責兜底，並放在需要繼續檢查的規則之後。若太早出現，後續規則就無法處理原本應該命中的請求。新增規則時，不只要檢查新行語法，也要檢視前後規則的範圍；更廣泛的後綴或關鍵字規則可能已涵蓋目標。排查時應從實際命中位置回頭追查，不要一直在檔案末尾追加重複規則。

編輯完成後，請確認已儲存，並核對目前實際啟用的 Config 檔案。開啟檔案檢視，不一定代表它已用於連線。規則細節可參閱.conf 各區段結構說明；若要了解相關設定的影響，請參閱設定說明。保留可還原的設定檔，再進行範圍明確的修改，通常比整份替換更容易驗證。

06 / DATA & OBSERVATION

Data 流量與請求紀錄的判讀方式

先確認統計口徑，別把數字當成帳單

Data 用來查看應用程式顯示的流量與連線資訊，實際統計項目以目前介面為準。檢視數值前，先確認涵蓋的時間範圍、重新連線後是否會變動，以及是否區分上傳與下載。不同頁面可能記錄不同項目，不能只因兩個數值不同就認定異常。單次工作階段流量、累計流量與系統按應用程式統計的流量，並非同一種口徑。

流量經過通道時，還可能涉及協定封裝、交握、重傳與背景請求；實際資料檔案大小通常不會與統計數字完全相同。圖片快取、影片預載與系統背景活動也會影響觀察結果。若要驗證某項操作的影響，先記錄起始值，執行一項明確操作，再讀取結束值；不要將整天的累計值歸因於剛開啟的某個頁面。

用戶端顯示的流量不能取代服務商的用量紀錄或計費依據。雙方可能採用不同的時間範圍、計量方向與統計規則；若訂閱資訊顯示剩餘額度，也需確認資料來源與更新時間。發現差異時，先整理時間區段與操作，再向自己的服務商確認統計方式；不要試圖透過清除用戶端計數來改變遠端紀錄。

利用請求紀錄確認規則是否實際命中

存取結果不符合預期時，紀錄中最有用的資訊是目標、時間、使用策略與錯誤階段，而不只是總流量。先重新發出目標請求，再查找時間相近的項目，避免把快取存取或舊連線誤當成目前結果。同一頁面可能產生多個請求，請分別檢查失敗項目；主網域成功不代表所有資源都使用相同路徑。

看到 DIRECT 或 PROXY 等策略時，請回到 Config 核對是哪條規則產生結果。若目標命中前面較寬泛的規則，繼續在檔案後方新增精確規則通常不會改變結果。先調整規則順序並儲存，再重新發出請求，才能觀察新規則是否生效。長連線可能沿用舊路徑，必須與新建立的連線分開判斷。

DNS 相關故障需區分「名稱解析失敗」與「解析後連線失敗」。前者應檢查解析設定、目前網路與請求網域；後者還要檢查目標位址、連接埠與路徑。不要只憑一則錯誤訊息就推斷全部原因。紀錄顯示的細節可能隨請求類型而異，缺少某個欄位也不代表相關流程沒有發生，請結合其他可觀察資訊判斷。

分開分析流量、電量與背景活動

流量不多但耗電較高並不矛盾；頻繁重新連線、持續喚醒或網路不穩，可能消耗電量，卻沒有產生大量有效流量。相反地，短時間下載大型檔案也可能讓流量明顯增加。觀察時一併記錄使用時間、網路類型與操作情境，不要簡單換算電量百分比與流量大小，也不能只憑一張截圖判斷用戶端異常。

懷疑背景持續活動時，先確認是否啟用 On Demand、是否有應用程式自動重新整理，以及裝置是否在不同網路間反覆切換。選擇相近的使用條件進行比對，例如維持網路與使用習慣不變，只調整按需連線設定。短時間測試容易受到系統工作的干擾，應觀察可重複的趨勢，不要只依據幾分鐘的波動下結論。

系統電池頁面的統計週期可能與 Data 頁面不同，請先對齊觀察時段。背景行為的排查方式可參閱On Demand 與電池排查說明。檢視這些資料是為了找出不必要的活動與失敗重試，不是追求某個固定數值；裝置型號、網路環境與使用內容不同，沒有適用於所有人的統一門檻。

建立個人觀察表時，記錄日期、網路、模式、設定名稱、重現操作與結果即可，不必長期保存所有請求。簡短紀錄更容易比較，也能減少敏感資訊累積。只有在問題需要進一步分析時才補充具體日誌，問題處理完畢後再檢視保存範圍，將診斷工具與日常使用分開管理。

08 / MAINTENANCE

訂閱更新、備份與日常維護

更新前後檢查實際變化

日常維護的重點是確保資料有效，而不是頻繁重建所有設定。更新訂閱前，確認要更新的是哪一組；更新後檢查紀錄數量、名稱與目前選取項目是否有變化。原先選取的紀錄若遭替換或移除，需重新選取並驗證。更新完成只代表已取回清單，不能取代伺服器測試；伺服器清單更新，也不代表規則設定檔當然同步更新。

服務商調整位址或驗證方式時，應依提供的新資料核對，不要只修改紀錄備註。舊位址短時間內仍可存取，不代表能繼續使用；匯入新資料後，也需在目前網路重新驗證。手動新增的紀錄不一定會隨訂閱更新，請分開維護，避免清單中留有多筆名稱相近但來源不同的項目，造成排查時選錯。

應用程式更新透過 App Store 完成，更新資訊與相容性請以商店頁面為準。更新前可先備份目前使用的設定，更新後檢查權限、目前伺服器與重要規則。若操作行為有變化，優先核對實際設定與應用程式提示，不要憑記憶認定某項目「應該沒變」。請分別記錄應用程式、訂閱與設定檔的更新，方便追查變更來源。

備份須兼顧可還原性與敏感性

備份前先確認需要還原哪些內容：只有規則檔案，未必包含伺服器驗證資料；只有伺服器清單，也未必包含自訂群組與應用程式設定。使用應用程式提供的匯出或備份功能時，請閱讀實際選項並確認包含範圍。替備份設定容易辨識用途的名稱，記錄對應設定與儲存時間，但不要在檔名中寫入密碼或完整訂閱網址。

備份檔案可能含有連線憑據，應存放在受保護且由自己控制的位置。透過系統檔案功能或個人儲存空間移轉時，確認接收裝置與帳戶正確，避免誤選公開共享位置。要提供規則範例給他人時，請另外建立已移除敏感資訊的副本，不要直接傳送完整備份；即使表面上只看到規則，檔案其他部分仍可能留有驗證或訂閱資料。

應檢查備份是否能還原，不能只憑「匯出成功」就認定完成。至少確認找得到檔案、內容完整，並知道如何在應用程式中重新匯入。實際移轉時，先保留舊裝置資料；在新裝置匯入後，核對伺服器、Config 與 Global Routing，再進行實際請求驗證。新裝置尚未驗證前，不要刪除唯一一份仍可正常使用的舊設定。

更換裝置、重新安裝與長期未使用後的檢查

更換裝置或重新安裝後，請透過購買帳戶的 App Store 已購項目取得 Shadowrocket；購買適用性以商店標示為準。重新下載應用程式與還原連線資料是兩回事，商店購買紀錄不代表設定已自動恢復。匯入備份後，可能還需要重新完成系統 VPN 授權，接著檢查目前設定與按需條件，避免沿用不適合新裝置的設定。

長期未使用後重新啟用，先驗證基礎網路，再確認訂閱與伺服器資料是否有效。裝置時間異常、服務資料變更與舊設定殘留，都可能影響連線；不必一開始就修改所有規則。先使用現有有效紀錄進行一次手動測試，成功後再恢復 On Demand 與其他輔助設定。逐層恢復有助於區分資料過期與裝置設定問題。

準備移除舊紀錄時，先檢查是否仍被群組或規則引用，再確認已有可用的替代項目。可以整理重複紀錄，但不要只因名稱相似就刪除；不同紀錄可能使用不同協定或參數。刪除後重新驗證常用存取路徑，確保設定中沒有指向不存在項目的引用。整理目的是減少混淆與過期內容，不是讓清單項目越少越好。

問題持續發生時，可整理簡短的檢查紀錄：應用程式能否啟動、VPN 能否建立、訂閱能否更新、哪種模式會失敗，以及哪些目標受到影響。對照連線與驗證章節，比反覆重新安裝更有方向。若要重新依照主要流程操作，請參閱快速入門教學；如果只是購買或重新下載問題，請前往已購項目還原說明。

返回手冊目錄 ↑