Shadowrocket 官方手冊 · 術語索引

Shadowrocket 術語表

依用途區分介面用語、協定名稱與規則語法。先確認名稱出現的位置,再了解其用途與適用範圍;英文名稱相似,不代表屬於同一層設定。

介面選項 Config / Proxy / Direct

決定 Global Routing 的整體運作模式。

比對條件 DOMAIN-SUFFIX

判斷連線是否符合某一條規則。

規則動作 PROXY / DIRECT / REJECT

指定符合規則後的處理方式。

本頁供查閱術語,不取代完整操作步驟。首次設定請閱讀使用教學;已有訂閱的更新、排序與備份方式,請參閱伺服器管理手冊。

介面與開關

連線入口與運作模式

同一個名稱可能既是頁面入口,也是模式選項。以下說明以名稱所在位置為判斷依據;不同平台或 App 狀態下,入口排列可能有所不同。

Home
查看伺服器清單、選擇連線對象及操作連線開關的介面。選擇伺服器只是指定接下來要連線的對象,仍須啟用連線並確認實際存取狀況;開關顯示已開啟,不代表目標服務一定能連線。
Global Routing
決定整體連線採用哪種處理模式;設定檔、代理、直連分別對應介面用語 Config、Proxy、Direct。需要依規則區分目標時請使用 Config;排查問題而暫時切換模式時,請記下原設定並在測試後還原。
Config
作為頁面名稱時,指匯入、選擇與管理設定檔的入口;出現在 Global Routing 中時,表示依目前設定檔規則處理連線。設定檔已儲存不代表已啟用,還須確認目前選取的設定檔與連線模式。
Proxy / Direct
Global Routing 中的 Proxy 表示採用代理模式,Direct 表示採用直連模式。兩者控制整體運作方式,不是特定伺服器的協定類型,也不可與規則列中的大寫動作 PROXY、DIRECT 混為同一層設定。
On Demand
依照設定條件要求系統自動建立連線的功能,可減少符合條件時手動操作的次數。此功能不會挑選分流規則,也無法修正錯誤的密碼或位址;手動中斷連線後再次連線時,請確認是否仍有觸發條件生效。
DNS
將網域名稱轉換為 IP 位址的解析機制,可能用於網域存取及部分規則判斷。若網域無法開啟,但直接連線至位址有回應,可單獨檢查 DNS;變更解析設定無法直接解決協定驗證失敗或伺服器無法連線的問題。
Connectivity Test
依選定方式檢查伺服器是否可連線的測試入口;結果與本機網路、測試目標和連線協定有關。比較結果前請先統一測試條件;單次測試成功只代表該次探測有回應,不能證明所有 App 和目標都能正常使用。

協定

伺服器類型與連線參數

協定決定雙方如何驗證及傳輸資料,不會決定規則如何比對。新增伺服器時,請以你已有的伺服器資訊為準,不要將某種協定的欄位直接套用到另一種協定。

Shadowsocks
使用加密方法與密碼建立代理連線的協定;位址、連接埠、加密方法和密碼須與伺服器設定一致。名稱相似的加密方法不代表可以互換;匯入後仍應逐項核對服務商提供的參數。
VMess
使用使用者識別碼進行驗證的代理協定,通常還須依伺服器要求設定傳輸方式與相關安全選項。識別碼正確只是必要條件之一;傳輸路徑、Host 或 TLS 設定不符也可能導致連線失敗。
VLESS
以使用者識別碼驗證的代理協定;傳輸與安全設定須符合伺服器要求。此協定與 VMess 不同,不能只更換類型名稱就沿用所有參數;是否啟用 TLS 及其他選項,應依實際資料判斷。
Trojan
通常搭配 TLS 建立連線的代理協定,常見檢查項目包括位址、連接埠、密碼與 SNI。SNI 用於 TLS 交握時指示服務名稱,不一定等同填寫的連線位址;若憑證錯誤,請先檢查網域名稱、時間與伺服器設定。
Hysteria2
以 QUIC 為基礎的代理協定,透過 UDP 傳輸,須符合驗證與 TLS 等參數設定。若網路限制 UDP,即使位址和密碼正確也可能連線失敗;頻寬相關設定應依實際狀況填寫,不要以調高數值取代連線排查。
WireGuard
使用公私鑰與對端資訊建立加密通道的協定;設定通常也包括通道位址、端點及允許的位址範圍。私鑰屬於敏感資訊,不應出現在求助截圖中;若交握正常但存取異常,還須檢查路由與 DNS。
HTTP / SOCKS5
兩種代理協定名稱;驗證方式與可承載的流量範圍須依伺服器設定確認。不能只憑協定名稱判斷連線是否加密,也不能假設所有 SOCKS5 服務都支援 UDP 轉送;請確認服務的實際條件。

規則關鍵字

比對條件與處理動作

常見規則由比對類型、比對值與處理動作組成,通常依清單順序逐條比對。查看個別規則前,請先確認目前處於 Config 模式,並檢查前面是否已有範圍較廣的規則符合條件。

DOMAIN
精確比對指定網域,例如 DOMAIN,example.com,DIRECT 會比對 example.com。此規則不會自動涵蓋所有子網域;若要一併處理 www.example.com 等名稱,請另行新增規則或使用適當的網域後綴比對。
DOMAIN-SUFFIX
比對指定網域及其子網域,適合對完整網域家族設定相同動作。DOMAIN-SUFFIX,example.com,PROXY 可涵蓋 example.com 及其子網域,但不會比對任何包含 example 字串的網域。
DOMAIN-KEYWORD
依網域名稱是否包含指定字串進行比對,涵蓋範圍通常比網域後綴比對更廣。關鍵字太短時可能比對到不希望處理的網域,因此請先確認涵蓋範圍,並將較精確的例外規則排在前面。
GEOIP
依 IP 地理資料庫分類目標位址,例如 GEOIP,CN,DIRECT 表示符合相應分類後執行 DIRECT。資料庫結果不能證明使用者位置或伺服器身分;位址歸屬更新及解析結果都可能影響比對結果。
IP-CIDR / IP-CIDR6
分別用於比對 IPv4 與 IPv6 位址範圍,斜線後的前綴長度決定涵蓋範圍。檢查規則時也要留意目標實際使用的位址家族;IPv4 規則不會自動取代對應的 IPv6 規則。
FINAL
為未符合前面規則的連線指定預設動作,例如 FINAL,PROXY。通常應放在規則清單末尾;若位置太前面,後續的具體規則可能無法進行比對。
PROXY / DIRECT / REJECT
規則中的處理動作,分別表示交由代理連線、直接連線及拒絕連線。PROXY 的最終出口仍取決於目前伺服器或相關策略設定;DIRECT 表示不經該代理路徑,不代表目標一定能連線。
URL Rewrite
依運算式比對請求 URL,並按照設定進行改寫或其他處理;這與依目標選擇連線路徑的分流規則不同。此功能取決於相應機制能否處理該請求,不應假設新增運算式規則就能套用於所有加密請求。

訂閱與伺服器

匯入、測試與資料還原

以下說明假設你已有自己的訂閱或伺服器資訊。訂閱網址請向你的服務商取得;網址中的驗證參數、伺服器密碼與私鑰都應妥善保管。

Subscribe
儲存訂閱網址並讀取其中伺服器項目的入口;更新訂閱時,項目可能新增、修改或移除。訂閱不是規則設定檔,也不是用戶端購買記錄;手動修改訂閱項目後,請留意下次更新是否會覆蓋這些變更。
Add Server
手動新增伺服器的入口;請先選擇協定,再依資料填寫對應欄位。位址、連接埠、驗證、傳輸與 TLS 資訊各不相同;不適用的欄位不要自行猜填,儲存後應測試連線。
SERVER
可能表示伺服器項目,也可能是位址欄位,須依介面位置判斷。伺服器位址通常是網域名稱或 IP,不等於訂閱連結;將完整訂閱 URL 填入位址欄位,無法取代透過 Subscribe 匯入。
Scan QR Code
讀取 QR Code 內容並匯入相應資訊的入口;QR Code 可能包含單一伺服器連結或訂閱網址。掃描後請先檢查識別出的類型與欄位,再決定是否儲存;含有驗證參數的 QR Code 不宜公開轉傳。
延遲
在指定測試條件下測得的回應時間,常用於比較同一次測試中的項目。數值較小不代表持續下載速度較快,也不保證目標網站回應更快;排序前請先統一測試方式,若逾時則須進一步區分網路與驗證問題。
iCloud 同步
在符合條件的 Apple 裝置、帳戶與系統權限下,同步 App 支援的資料。這不代表所有連線狀態與外部服務都會一併轉移;更換裝置後仍應核對訂閱、目前的 Config 與連線權限,並保留必要的獨立備份。

安裝與系統權限

帳戶記錄、架構與權限

Shadowrocket 支援 iPhone、iPad、Mac、Windows、Android 與 Linux。iPhone / iPad 版請從 App Store 取得,系統需求以 App Store 頁面標示為準;其他平台的安裝檔統一由本站 /dl/ 取得,下載入口與完整操作請參閱用戶端下載頁。

已購項目
在 App Store 帳戶中查看及重新下載已購 App 的入口;更換裝置或重新安裝時,請使用原購買帳戶核對記錄。App 購買記錄不會自動還原服務商訂閱;確認正版時,也請核對開發者 Shadow Launch Technology Limited 與 App ID 932747118。
Apple 晶片 / Intel
Mac 的兩種處理器架構,對應 Shadowrocket 的兩個 dmg 安裝檔。請先在「關於這台 Mac」查看晶片或處理器資訊,再選擇相應版本;架構選擇關係到相容性,首次開啟時的提示仍須依系統權限步驟處理。
SmartScreen
Windows 的應用程式信譽提示機制;出現提示不代表已完成安裝檔內容的檢查。確認檔案是從本站下載入口取得後,可在相應提示中選擇「更多資訊 → 仍要執行」;若受組織策略限制,請遵循裝置管理規定。
隱私權與安全性
macOS 中處理 App 首次開啟限制的系統設定入口;若出現「無法驗證開發者」提示,確認安裝檔來自本站後,可查看「仍要打開」選項。若提示「已損壞」,請確認 App 位於 Applications,再依下載頁說明使用 xattr -cr /Applications/Shadowrocket.app;不要對來源不明的檔案執行指令。
允許安裝未知的應用程式
Android 依來源 App 個別授予的安裝權限,例如允許下載 apk 的瀏覽器或開啟檔案的檔案管理員安裝 App。只開啟這次實際使用的來源權限,安裝完成後可視需要關閉;若無法在微信中下載,請改用系統瀏覽器開啟下載頁。
deb / rpm / AppImage
Linux 提供多種安裝檔格式;deb 與 rpm 請依發行版的套件管理系統選擇,執行 AppImage 前則須授予執行權限。使用 chmod +x 時,目標應是實際下載的 AppImage 檔案;安裝 deb 時可透過 sudo apt install 指定本機檔案,詳細步驟請參閱下載頁。

需要確認安裝入口時,請查看全平台取得說明;想將術語應用於實際操作,請繼續閱讀使用教學或訂閱與伺服器管理手冊。