Shadowrocket 官方手冊

Shadowrocket 術語解說

從介面上的英文詞彙找到操作入口,從規則列中的欄位判斷請求如何處理。若已有訂閱或伺服器資料,可依名稱查對;本手冊不提供、不販售,也不推薦此類資料。

介面與開關

先分清楚決定請求路徑的選項、觸發連線的開關,以及新增資料和測試的入口。

Global Routing
決定由用戶端接管的請求要以何種方式選擇出口。Config(設定)依目前設定處理,Proxy(代理)使用代理出口,Direct(直連)則不經代理伺服器。排查分流規則時,請先確認目前選取的是 Config。
On Demand
符合設定條件時觸發連線,適用於需要依網路條件自動啟動的情境。此功能決定何時連線,不負責判斷個別請求要走哪個出口。即使條件已符合,仍須確認伺服器本身可用。
Add Server
用來新增既有伺服器資料的入口。先選取協定,再填入對應的位址、連接埠和驗證資料;不同協定所需欄位不盡相同。儲存項目只代表資料已輸入,不表示用戶端已成功連上伺服器。
Connectivity Test
檢查用戶端在目前網路下,能否透過指定路徑完成測試。結果中的耗時只反映該次測試條件,不能換算為檔案下載速度。比較結果時,應盡量使用相同的測試目標、網路和測試方式。

代理協定

協定說明用戶端與伺服器如何通訊。輸入資料時請以既有資訊為準,不要根據連接埠或名稱猜測協定。

Shadowsocks
採用對稱式加密的代理協定,設定資料通常包含伺服器位址、連接埠、加密方法和密碼。連接埠可連通不代表連線一定成功;若加密方法或密碼與伺服器設定不一致,仍無法正常交換資料。
VMess
具備身分驗證的代理協定,通常以 UUID 識別使用者。輸入資料時也要核對實際使用的傳輸方式及相關欄位,不能只憑 UUID 判斷兩份設定是否能互換。驗證失敗時,請先逐項比對原始資料。
VLESS
將身分驗證與傳輸保護分開設定的代理協定。即使資料中同樣包含 UUID,也不能只修改協定名稱,就直接沿用 VMess 設定。傳輸方式和安全參數都必須與對端一致。
Trojan
通常透過 TLS 傳輸並以密碼驗證的代理協定。連線失敗時,請分別核對驗證資料及 TLS 所需的伺服器名稱。憑證名稱不符與密碼錯誤是不同問題。
Hysteria2
以 QUIC 為傳輸基礎的代理協定,需要網路允許 UDP 流量通過。一般網頁可以瀏覽,不代表同一網路也能使用 QUIC 連線。排查時可記錄故障是否只出現在某種網路連線方式。
WireGuard
以公鑰識別對端,並透過 UDP 傳輸的加密通道協定。設定中用來識別對端的公鑰,與必須妥善保管的本機私鑰是不同欄位。分享排查紀錄時,請移除私鑰等敏感資料。

規則關鍵字

規則列開頭的關鍵字決定比對條件;列尾的策略則決定符合後如何處理。

DOMAIN
比對完整網域名稱。條件設為 example.com 時,不會因此比對到 www.example.com,也不會用來判斷 URL 路徑。若只需改變某個明確主機名稱的處理方式,可使用這類精確條件。
DOMAIN-SUFFIX
比對指定網域及其子網域。條件設為 example.com 時,可比對 img.example.com,但不會比對 notexample.com。若需對某個子網域另行處理,請將對應的精確規則排在後綴規則之前。
IP-CIDR
將目的 IPv4 位址與指定網段比對,例如 192.0.2.0/24。斜線後的數字是前綴長度,不是連接埠。若請求一開始以網域名稱表示,還須依位址是否已解析及規則參數判斷比對結果。
GEOIP
依位址資料庫記錄的目的 IP 地區分類進行比對,不是依網頁內容所用的語種、網域後綴或裝置所在地判斷。同一網域可能在不同網路解析至不同位址,因此不一定總是符合相同的地區條件。
FINAL
為未符合前面任何規則的請求指定預設策略。不需要額外的網域或位址條件,例如 FINAL,DIRECT。請將它放在需要優先判斷的規則之後,避免提早結束比對。

策略與比對順序

介面中的 Proxy、Direct 是 Global Routing 選項;規則中的 PROXY、DIRECT 則是個別規則的處理策略。

PROXY
將符合規則的請求交由代理出口處理。規則符合只代表出口已選定,不表示代理伺服器能連上目標。若診斷紀錄顯示規則已符合,但請求仍失敗,接著應檢查所用伺服器及目標是否可連線。
DIRECT
符合規則的請求直接透過目前網路連線至目標,不經代理伺服器。直連不代表略過 DNS 查詢,也不等於關閉用戶端;啟用規則處理時,用戶端仍可依規則為不同請求選擇不同路徑。
REJECT
拒絕已交由用戶端處理且符合此策略的請求。規則只處理符合條件的流量,不會辨識網頁中的每個內容元素。使用範圍較廣的後綴條件前,請確認不會連同封鎖同一網域下需要保留的服務。
比對順序
依設定順序檢查規則,以第一個符合的規則為準,而不是找出所有符合項目後再選最精確的一個。若範圍較廣的後綴規則排在精確網域規則之前,請先調整順序,再用同一個目標驗證結果。

閱讀規則時,先看第一個逗號前的比對類型,再看最後的策略。例如 DOMAIN-SUFFIX,example.com,PROXY 表示:符合網域後綴 example.com 時,使用代理出口。

訂閱與設定檔

訂閱用來取得既有伺服器清單,設定檔則用來描述請求的處理方式。更新清單不等於切換分流規則。

Subscribe
匯入既有訂閱網址,並讀取其中的伺服器項目。清單更新後,請再次確認目前選取的項目仍存在,且參數符合預期。訂閱網址可能包含存取憑證,提交故障紀錄時請勿附上完整網址。
Config
作為頁面入口時,可用來檢視和管理設定檔;出現在 Global Routing 中時,表示依目前設定處理流量。編輯檔案不代表已選用該檔案。驗證規則前,請確認實際啟用的是哪一份設定。
DNS
用來查詢網域記錄,連線請求通常藉此取得目標位址。網域查詢與連線至目標是兩個不同環節;查得到位址不代表目標一定可連線。排查位址型規則時,應查看實際取得的位址,而非只看輸入的網域名稱。
URL Rewrite
依條件對可識別的 URL 執行改寫等操作,與在規則中選擇請求出口是不同工作。URL 可能包含路徑和查詢參數,網域條件無法區分這些部分。編寫條件前,請先確認用戶端在目前情境下能取得哪些請求資訊。

相關操作

首次匯入既有資料,請參閱使用教學;需要比對規則欄位和優先順序,請查閱設定大全。

iPhone / iPad 版透過 App Store 取得,$2.99 一次付費,系統需求以 App Store 頁面標示為準。Mac(Apple 晶片版與 Intel 版)/ Windows / Android / Linux 版免費,安裝檔僅透過本站下載頁的 /dl/ 路徑提供。用戶端一次買斷 ≠ 連線服務方案。