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 可能包含路徑和查詢參數,網域條件無法區分這些部分。編寫條件前,請先確認用戶端在目前情境下能取得哪些請求資訊。