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指定本機檔案,詳細步驟請參閱下載頁。
需要確認安裝入口時,請查看全平台取得說明;想將術語應用於實際操作,請繼續閱讀使用教學或訂閱與伺服器管理手冊。