Shadowrocket 設定檔 .conf 詳解:General、Rule、Host、URL Rewrite 各區段用途
先釐清全域參數、本機對應、請求改寫與分流規則各自的用途,再找出應修改的區段。筆記逐段提供範例,也說明為何同一個請求可能先符合較前面的規則。若修改了多個區段,可透過備份逐項比對,避免將對應或改寫造成的結果誤判為伺服器故障。
閱讀設定檔區段筆記 →安裝、設定與連線 · 官方手冊
適用於手機、平板與電腦的全平台用戶端;匯入既有伺服器或訂閱後,可用規則分流決定哪些請求經由代理、直連或拒絕。
目前版本 v2.2.92 · iPhone / iPad $2.99 一次性購買,其他平台免費
01 用戶端功能
設定決定請求走哪條路徑,伺服器則決定代理請求要送往何處。可先了解這兩項選擇,再查看依需求連線、同步與診斷。
在 Home 的 Global Routing 選擇 Config,請求才會依目前設定的 Rule 進行比對。使用 DOMAIN-SUFFIX 指定網域及其子網域,使用 IP-CIDR 指定網段,再用 FINAL 處理前面未符合的請求。若要讓特定子網域單獨直連,請將該條具體規則放在範圍較廣的網域規則前面。修改後先造訪已知網域,查看實際符合的規則,再用另一個網域確認預設處理方式。Proxy 和 Direct 適合暫時比對,不會套用這套分流順序。
查看 Global Routing 的差異 →DOMAIN-SUFFIX,example.com,PROXYIP-CIDR,192.168.0.0/16,DIRECTDOMAIN-KEYWORD,ads,REJECTFINAL,DIRECTOn Demand 控制何時自動發起連線,不會決定特定網域要走代理或直連。在 Settings 找到 On Demand,先確認希望在哪類網路上自動連線,再設定觸發條件。儲存後在 Wi-Fi 與行動網路之間切換一次,回到 Home 查看連線狀態是否符合預期。如果手動中斷後又自動連線,請先檢查是否仍符合依需求連線的條件。若要比較手動開關的行為,可暫時停用 On Demand,只調整這個項目進行比對。
查看 On Demand 設定參考 →向服務提供者取得伺服器資訊後,在 Add Server 先選擇 Type,再填入該類型要求的欄位。Shadowsocks 的 Method 必須與伺服器設定一致;VMess、VLESS、Trojan、Hysteria2 和 WireGuard 也各有參數,不能只改 Type 就沿用整套舊設定。儲存前逐一核對位址、連接埠及協定專屬欄位,尤其留意複製時帶入的空格。如果同一位址上還有其他服務,也不要據此推測這個連接埠使用哪種協定。
查看代理協定名詞 →向服務提供者取得完整訂閱連結,在 Add Server 的 Type 中選擇 Subscribe,貼上後儲存。回到 Home,確認 SERVER 中出現對應的群組與項目,再選擇要使用的伺服器。更新訂閱與建立連線是兩件事:清單能更新,不代表其中每個項目都可連線。若更新後原有項目消失,請重新選擇一個項目並測試;若清單仍空白,先確認連結是否完整,避免在螢幕截圖、記錄或求助資訊中洩露連結內容。
查看訂閱匯入步驟 →在 Config 確認目前使用的檔案,再進入對應區段編輯。General 放置全域參數,Rule 管理比對與策略,Hosts 用於主機對應。修改前保留可還原的副本,每次只改一組相關設定,方便找出行為變化的原因。使用 iCloud 同步時,先確認兩部裝置使用預期的帳號,再到目標裝置確認實際啟用的檔案;檔案已同步不等於已選取,也不代表兩部裝置選擇了同一台伺服器。
閱讀設定檔區段說明 →[General][Rule][Host]先在 Home 查看連線狀態,再執行 Connectivity Test,最後透過實際瀏覽確認目標是否可用。測試成功只代表該項測試能完成,不代表所有網域都採用相同策略。只有部分請求失敗時,查看 Diagnostics 中與發生時間相符的資訊,區分解析失敗、伺服器無法連線和規則選擇問題。Data 可協助查看流量變化,但應搭配測試時段判斷,不能只憑總量推測單次請求採用了哪個策略。
查看連線與排查問答 →02 裝置與安裝檔
iPhone / iPad 透過 App Store 一次性購買($2.99);Mac / Windows / Android / Linux 版免費。電腦與 Android 請從對應平台卡片進入本站下載頁,安裝檔由本站 /dl/shadowrocket/ 提供。
先確認裝置目前使用的 Apple 帳號與商店地區,再核對商店產品頁。系統需求以 App Store 頁面標示為準;若已有購買記錄,可先查看已購項目再決定下一步。
查看商店取得說明 →在「關於這台 Mac」查看晶片或處理器:顯示 Apple 晶片就選 Apple 晶片版,顯示 Intel 處理器就選 Intel 版。兩種安裝檔都是 .dmg,不能只看副檔名判斷。
在系統的「關於」頁面確認系統類型,再選擇 64 位元 .exe 安裝程式。若公司或學校管理的電腦限制安裝,請先確認管理員是否允許,不要將管理限制誤認為安裝檔故障。
Android 下載入口提供 arm64 的 .apk。若系統提示套件與裝置不相容,先確認裝置架構;若提示安裝來源受限,請先查看提示所指的應用程式和權限,不必更改其他應用程式的權限。
先查看發行版慣用的套件格式,再確認架構。使用相應套件管理器的系統可選 deb 或 rpm;選擇 AppImage 時,下載頁另有執行權限說明。三種格式可擇一使用,不必依序安裝。
比較 Linux 安裝格式 →03 首次連線
以下以 iPhone / iPad 的 Home 為例。先完成一次手動連線,確認伺服器與策略都正確,再考慮設定自動連線或修改規則。
伺服器位址、連接埠、協定參數或訂閱連結請向服務提供者取得。若有單一伺服器資料,請依提供的協定選擇 Type,並填入該類型要求的欄位;若有訂閱連結,請選擇 Subscribe,貼上完整連結後儲存。返回 Home 檢查 SERVER,點選想使用的項目。新增成功只代表資料已寫入;若未看到預期項目,應先排除匯入問題,再繼續連線。
若要依設定檔中的規則分流,請選擇 Config,並確認目前設定檔;若要暫時比對代理路徑,請選擇 Proxy;若要比對直連結果,請選擇 Direct。選擇伺服器與選擇模式是兩個不同動作:即使已選取伺服器,Direct 下的請求也不會因此改走代理。測試時保持伺服器不變,一次只切換一種模式,並使用相同目標比較結果,才能判斷差異與哪項設定有關。
開啟 Home 的連線開關。首次出現系統 VPN 設定確認時,先確認要求來自剛開啟的用戶端,再依系統提示操作。連線後執行 Connectivity Test,並造訪一個符合規則的已知目標。若測試成功但實際瀏覽失敗,先查看目前模式和規則是否符合預期;若兩者都失敗,再檢查裝置網路、目前伺服器和協定參數,不要同時修改多項設定。
04 正版與購買
先核對產品,再區分應用程式購買、設定遷移與線路服務。Shadowrocket 是閉源商業應用程式;手機和平板的商店購買記錄與其他平台的安裝檔分開管理。
開啟 App Store 的 Shadowrocket 產品頁,確認開發者是否為 Shadow Launch Technology Limited,對照白底、藍紫描邊的應用程式圖示,並確認產品頁網址末段為 id932747118。中文常將 Shadowrocket 稱為「小火箭」,但別稱、相似名稱或相似圖示都不能取代這三項核對。若從搜尋結果進入,先查看產品頁資訊,再決定是否繼續。
已從商店安裝的裝置,也可從更新記錄進入應用程式詳細頁核對。直接從商店開啟產品頁時,請以詳細頁內容為準,不要依據搜尋摘要或他人截圖中的資料。
App Store 顯示的項目取決於 Apple 帳號使用的商店地區。裝置介面語言、目前所在地與商店地區是不同設定。開啟產品頁後若看到目前地區無法使用,先檢查 App Store 帳號中的國家或地區,不要將商店提示誤認為系統版本不相容。若可開啟產品頁,再查看相容性;iPhone 和 iPad 的系統需求以 App Store 頁面標示為準。
從網頁看到美國商店的產品頁,也不代表目前登入的帳號已切換至美國商店。若要變更地區,請依 Apple 帳號設定中的官方流程檢查餘額、訂閱等條件,再依商店提示處理。
iPhone / iPad 版在 App Store 一次性購買,美國商店價格為 $2.99,結帳金額以所選商店地區顯示為準;Mac / Windows / Android / Linux 版免費。在 iPhone 購買後,使用同一個 Apple 帳號的 iPad 可從已購項目重新取得,反之亦然。更換裝置或重新安裝時,先確認目前用於商店購買的帳號,再尋找 Shadowrocket 的下載圖示,不要只看裝置是否登入 iCloud。
恢復應用程式不等於恢復所有設定。遷移前先保留自己的設定檔,或確認 iCloud 同步是否已啟用;在新裝置上檢查 Config、Global Routing 和目前伺服器,測試一個請求後再繼續日常使用。
App Store 購買記錄對應的是用戶端本身。伺服器位址、協定參數和訂閱連結請向服務提供者取得;本站不提供、不銷售、不推薦節點或訂閱。安裝後若看到空白的 SERVER 清單,先確認是否已新增自己的資料。之後若要更新訂閱,可在用戶端重新整理既有連結;服務期限和可用項目仍以服務提供者提供的資訊為準。
處理匯入失敗時,可記錄時間、裝置和錯誤步驟。若要分享螢幕截圖,請先遮住完整訂閱網址、伺服器密碼及其他憑證。連線前後也可參考名詞解釋,區分訂閱、伺服器與設定檔。
Mac、Windows、Android 和 Linux 版從本站下載,不使用 iPhone / iPad 的商店購買記錄;iPhone / iPad 版在 App Store 一次性付費 $2.99,這四個平台的用戶端免費。Mac 提供 Apple 晶片與 Intel 兩種 .dmg,其他平台則依裝置與發行版選擇。更新時回到下載頁,選擇原本使用的平台、架構和套件格式,不要依裝置名稱搜尋來源不明的同名檔案。
桌面或 Android 安裝檔可能觸發系統來源提示。遇到攔截時,先確認下載網址位於本站 /dl/shadowrocket/ 下,並閱讀對應系統的安裝說明;若來源不明、裝置受管理,或提示與說明不一致,請先停止安裝。
05 技術筆記
若已完成首次連線,可依目前問題繼續閱讀:修改設定後未生效、更換 iPad 後如何恢復購買,或 Linux 應選擇哪種安裝檔。
先釐清全域參數、本機對應、請求改寫與分流規則各自的用途,再找出應修改的區段。筆記逐段提供範例,也說明為何同一個請求可能先符合較前面的規則。若修改了多個區段,可透過備份逐項比對,避免將對應或改寫造成的結果誤判為伺服器故障。
閱讀設定檔區段筆記 →確認用於購買的 Apple 帳號、查看已購項目,以及如何在橫向分欄介面找到對應選項。文章分別說明恢復購買與設定同步,方便更換裝置後逐項檢查。
閱讀 iPad 設定筆記 →從發行版與架構著手選擇安裝格式,再區分透過套件管理器安裝與直接執行 AppImage。已下載但無法開啟時,可依套件格式、執行權限和終端機提示逐項檢查。
閱讀 Linux 安裝筆記 →