Shadowrocket 官方手冊 · 術語索引

Shadowrocket
術語與規則關鍵字

先依所在介面判斷詞義,再確認它影響的是連線、伺服器清單,還是請求分流。本頁保留英文介面用語與協定名稱,按五類整理常見術語;可透過卡片標題的錨點直接前往,方便對照實際操作介面閱讀。

介面與開關

先區分「在哪裡操作」與「以什麼方式處理流量」。同一個詞出現在不同位置時,可能代表不同層級的設定。

介面與開關

Home

Home 是查看伺服器清單、選擇伺服器及控制連線的主要介面,也是匯入後確認項目是否出現的位置。選取某個項目只代表指定了候選伺服器,不代表已建立連線;還要檢查連線開關、系統授權與實際連線結果。

介面與開關

Global Routing

Global Routing 決定整體流量的處理模式:設定、代理、直連分別對應介面中的 Config、Proxy、Direct。需要依規則區分不同請求時,通常選擇 Config;暫時切換模式排查後,請還原原有設定,避免把測試結果誤認為規則已生效。

介面與開關

Config

Config 常見於兩種情境:一是管理設定檔的介面,二是 Global Routing 中依設定處理流量的模式。前者著重檔案的匯入、編輯與啟用;後者著重執行時採用的路由方式。只匯入檔案而未確認啟用項目,並不能證明規則正在參與比對。

介面與開關

Proxy / Direct

在 Global Routing 中,Proxy 與 Direct 分別表示整體採用代理或直連模式,用來改變大範圍請求的路由方式。它們不是規則列中的大寫 PROXY、DIRECT:前者是模式選擇,後者是個別規則的處理結果。排查時須先確認修改的是哪一層。

介面與開關

On Demand

On Demand 依預設網路條件觸發連線行為,適合需要隨網路環境自動建立連線的情況。它回答的是「何時連線」,而 Rule 回答的是「連線後如何處理請求」;修改後應在相應網路條件下測試,不能只看開關是否已開啟。

介面與開關

Settings / Data

Settings 用於尋找應用程式設定,Data 用於查看相關使用資料,實際項目依目前裝置介面為準。設定值說明預期行為,資料紀錄呈現已觀察到的活動;累計流量增加只代表曾有資料傳輸,不能單獨證明某個網域採用了預期策略。

代理協定

協定決定用戶端與伺服器如何通訊,不決定分流目標。選擇協定後,仍須依現有伺服器資訊填寫驗證、傳輸與安全參數,不同協定的欄位不可直接照抄。

代理協定

Shadowsocks

Shadowsocks 使用指定的加密方式、密碼等參數建立代理連線;伺服器位址、連接埠、加密方式與密碼都必須相符。即使位址相同,加密方式或密碼不一致也可能連線失敗;含有額外傳輸參數的設定也須逐項保留,不能只複製位址與連接埠。

代理協定

VMess

VMess 使用使用者識別碼等參數完成驗證,常見設定還包括傳輸方式、路徑與 TLS。識別碼正確只是條件之一,路徑或傳輸類型不符也會影響連線;匯入後請對照原始資訊檢查欄位,不要依名稱猜測伺服器設定。

代理協定

VLESS

VLESS 使用使用者識別碼進行驗證,其協定層本身不提供流量加密,實際安全性取決於搭配的傳輸與安全設定。填寫時須一併核對協定、傳輸方式與安全參數,不能把 VLESS 和 VMess 當成只要更改名稱就能互通的設定。

代理協定

Trojan

Trojan 通常搭配 TLS 並以密碼驗證,設定中的伺服器名稱可能參與交握與憑證驗證。除了連線位址、連接埠與密碼,也要檢查名稱與傳輸參數;遇到憑證錯誤時,應先核對設定、憑證有效期限與裝置時間,而不是直接關閉驗證。

代理協定

Hysteria2

Hysteria2 以 QUIC 為基礎,依賴 UDP 傳輸;驗證與 TLS 參數須與伺服器端一致。若目前網路限制 UDP,即使網頁能透過其他方式開啟,這條連線仍可能失敗。排查時應區分網路傳輸條件與伺服器設定,不能只憑一次逾時就認定密碼錯誤。

代理協定

WireGuard

WireGuard 透過公開金鑰驗證建立加密通道,本機私密金鑰、對端公開金鑰、連線端點與位址範圍各有不同用途。私密金鑰必須保密,對端公開金鑰也不能填成本機公開金鑰;出現交握紀錄與應用程式連線成功是不同檢查項目,還須核對位址、路由與 DNS。

規則關鍵字

規則通常依由上而下的順序比對,匹配後採用相應策略。以下的 example.com 僅用於說明語法;範例規則並非適用於所有情境的完整設定。

PROXY · 代理處理 DIRECT · 直接連線 REJECT · 拒絕請求
規則關鍵字

PROXY / DIRECT / REJECT

PROXY 表示交由代理處理,DIRECT 表示直接連線,REJECT 表示拒絕請求;它們是規則中的策略,不是協定名稱。策略只套用至符合該規則的請求。藍、綠、橘色圓點僅供閱讀參考,判斷時仍應以策略文字與實際連線紀錄為準。

規則關鍵字

DOMAIN / DOMAIN-SUFFIX

DOMAIN 比對指定網域;DOMAIN-SUFFIX 比對指定網域及其子網域,因此後者的涵蓋範圍通常較廣。例如 DOMAIN-SUFFIX,example.com,PROXY 可套用至該網域及其子網域;這類規則不比對網頁 URL 路徑,不能把 /login 當成網域後綴填入。

規則關鍵字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 檢查網域是否包含指定關鍵字,例如 DOMAIN-KEYWORD,example,PROXY。關鍵字可能出現在多個無關網域中,涵蓋範圍往往比預期更廣;若只想處理某個網域及其子網域,建議優先使用範圍明確的 DOMAIN-SUFFIX。

規則關鍵字

IP-CIDR / IP-CIDR6

IP-CIDR 與 IP-CIDR6 分別依 IPv4、IPv6 位址範圍比對,斜線後的前綴長度表示網路範圍。例如 IP-CIDR,192.168.0.0/16,DIRECT 描述的是一段 IPv4 位址範圍,而非單一伺服器連接埠;只有 IPv4 規則時,也不能據此認定相應的 IPv6 請求會採用相同策略。

規則關鍵字

GEOIP

GEOIP 依 IP 地理資料庫記錄的地區歸屬進行比對,例如 GEOIP,CN,DIRECT。地區歸屬不等於網頁內容所用的語言、網域後綴或營運主體所在地;解析結果與資料庫內容也可能變動。若要精確處理特定網域,可考慮在其前方加入更具體的網域規則。

規則關鍵字

FINAL

FINAL 是前面規則都未匹配時採用的後備項目,常見寫法為 FINAL,PROXY,通常放在清單末尾。它不會重新處理已符合前面規則的請求;若後備策略符合預期但連線方向仍不對,應先檢查前面的規則,而不是反覆修改 FINAL。

訂閱與設定檔

伺服器項目儲存連線參數,設定檔描述規則與設定,訂閱則負責批次取得及更新項目。先分清匯入的是什麼,才能判斷更新後應在哪個介面確認變更。

訂閱與設定檔

Subscribe

Subscribe 用於透過訂閱網址取得並更新一組伺服器項目,訂閱請向你的服務供應商取得。更新成功通常表示清單內容已重新整理,不代表分流設定也已更新;若更新後項目數量或名稱有所變動,請先檢查所屬群組與目前選取的項目,再測試連線。

訂閱與設定檔

SERVER / Add Server

SERVER 表示伺服器相關內容,Add Server 是新增伺服器的入口,適用於已有完整連線參數的情況。手動填寫時,先確認協定,再依序核對位址、連接埠、驗證與傳輸設定;項目顯示名稱僅供辨識,修改名稱不會改變實際伺服器位址。

訂閱與設定檔

Scan QR Code

Scan QR Code 透過 QR Code 讀取可匯入的內容。QR Code 只是資訊載體,不保證其中一定是單一伺服器設定。掃描後請確認內容類型、協定與參數,再行儲存;QR Code 可能含有密碼或訂閱網址,展示截圖時也須一併遮蔽,不能只遮住旁邊的文字。

訂閱與設定檔

設定檔

設定檔可包含 [General]、[Rule] 等區段,用來儲存一般設定與規則;檔名只是識別資訊,無法據此判斷規則內容。匯入後須確認目前啟用的項目,再檢查 Global Routing 模式;編輯前請保留副本,以便發生誤匹配時還原至先前可用的設定。

訂閱與設定檔

iCloud 同步

iCloud 同步是在相應系統與應用程式設定支援範圍內同步設定資料的方式,同步項目與開關以實際介面為準。這不等於獨立備份,也不等於還原商店購買項目;刪除或修改內容前,請另存重要設定,不要假設同步端一定保留舊副本。

連線與診斷

每項測試結果都有其目標、時間與方法限制。先重現一項明確請求,再分別檢查網路、解析、交握與規則,避免把一次延遲測試當成完整的可用性結論。

連線與診斷

Connectivity Test

Connectivity Test 用於檢查指定目標能否完成相應連線程序,結果會受測試位址、方法與目前網路影響。成功只代表在這次測試條件下完成相應步驟,不保證所有網站或應用程式都能連線;若失敗,請記錄測試目標與錯誤提示,再與實際應用程式請求比對。

連線與診斷

延遲

延遲是完成某類測試互動所需的時間,通常以毫秒表示,不等於下載頻寬,也不代表持續傳輸的穩定性。比較伺服器時,應盡量使用相同網路、目標與測試方式;逾時也可能是目標無法連線或協定受限所致,不能簡單視為伺服器永久失效。

連線與診斷

DNS

DNS 將網域名稱解析為 IP 位址,解析結果與快取會影響後續連線及部分規則判斷;dns-server = system 表示使用系統解析設定。排查時須一併查看網域、回傳位址與最終策略;變更解析設定,不代表所有請求都會改由代理處理。

連線與診斷

TLS / SNI

TLS 為傳輸提供加密與身分驗證;SNI 用於在交握時指出所要求的伺服器名稱,該名稱可能與連線位址不同。若出現憑證或交握錯誤,請依序核對伺服器名稱、憑證有效期限、裝置時間與原始設定;關閉驗證不能取代修正欄位錯誤。

連線與診斷

TCP / UDP

TCP 與 UDP 是兩種常見的傳輸層協定,不同應用程式與代理協定可能依賴不同的傳輸方式。TCP 測試成功不代表 UDP 也可用;網頁能開啟,也不代表所有即時通訊都正常。請依實際應用程式、所選協定與目前網路條件分別驗證。

連線與診斷

連線紀錄

連線紀錄可用來查看請求目標、匹配規則、處理策略與錯誤提示,協助區分匯入、規則與傳輸問題。排查時先記下重現時間,再觸發一次目標請求;分享紀錄前,請移除伺服器憑證、完整訂閱網址與個人資料,只保留必要的錯誤訊息即可。