OFFICIAL MANUAL / GLOSSARY

Shadowrocket 術語解說

先辨認介面用語,再判斷它屬於連線參數、路由選擇或診斷結果。本頁是官方手冊的術語索引;每個項目都可透過標題對應的錨點直接前往,英文名稱與設定關鍵字維持原樣。

INTERFACE & SWITCHES

介面與切換項目

本分類說明「在哪裡操作」及「開關控制什麼」。系統授權、整體路由與連線狀態是三個不同層面,不應混為一談。

Home

Home 是選擇伺服器與設定連線的主要頁面,可從連線狀態、Global Routing 和 SERVER 等區域確認目前準備使用的設定。操作連線開關前,先確認選取的伺服器確實是要測試的項目。顯示已連線只代表連線機制已啟動,仍須透過實際連線及連線紀錄確認目標是否可連通。

Global Routing

Global Routing 控制整體路由方式,分為設定、代理、直連三種模式,分別對應介面用語 Config、Proxy、Direct。排查個別規則未生效時,先確認目前是否使用 Config,再考慮修改規則內容。它決定採用哪類路由邏輯,個別規則的策略則是下一層要確認的項目。

Config / Proxy / Direct

在 Global Routing 中,Config 依目前設定檔中的規則決定連線路徑,Proxy 透過代理處理連線,Direct 則直接連線至目標。此處的 Config 指路由模式;閱讀教學時,也要依上下文判斷它是否指設定管理頁面。切換模式後應重新發起測試連線,既有連線不一定能反映新選項的結果。

On Demand

On Demand 依已設定的條件觸發 VPN 連線,處理的是「何時建立連線」,而不是「某個網域要走哪條路徑」。它不會取代 Rule 區段,也不會修正填寫錯誤的伺服器參數。手動中斷後又再次連線時,先檢查 On Demand 條件,再排查其他連線問題。

Add Server

Add Server 是輸入伺服器資訊的入口,先選擇協定類型,再依據既有資訊填寫位址、連接埠和身分憑證。TLS、傳輸方式及其他欄位也須逐一確認相符,不能只憑伺服器備註推測。完整操作順序請參閱使用說明,修改前建議保留原項目以供比對。

VPN 設定授權

首次建立連線時,Apple 系統可能會要求允許加入 VPN 設定,並透過裝置的系統驗證確認操作。授權可讓 Shadowrocket 建立系統層級的連線,不代表訂閱有效或伺服器已通過測試。請在主動使用 App 時確認系統提示,接著返回 Home 檢查狀態;系統需求以 App Store 頁面標示為準。

PROTOCOLS

協定

協定定義兩端如何交換資料與驗證身分,並非連線品質等級。伺服器採用哪種協定,就選擇對應類型並填入相應參數;名稱相似也不代表身分欄位可以混用。

Shadowsocks

Shadowsocks 使用密碼、加密方式等參數建立代理連線,位址與連接埠用來定位伺服器。即使密碼正確,只要加密方式不符,仍可能無法建立連線。請逐項核對既有伺服器資訊,不要把其他協定的 UUID 填入密碼欄位,也不要憑名稱猜測加密方式。

VMess

VMess 具備身分驗證機制,常見的身分欄位為 UUID,另外也可能涉及 alterId、傳輸方式和 TLS 設定。alterId 應依據既有伺服器資訊填寫,不要把舊教學中的範例當成通用值。即使 UUID 相符,傳輸參數不一致仍可能導致連線失敗;裝置時間異常也值得列入身分驗證的排查項目。

VLESS

VLESS 使用 UUID 識別身分,協定本身不提供資料加密,傳輸保護方式須依實際部署設定判斷。TLS、flow 和傳輸方式必須與伺服器端設定相符,不要只因 UUID 相同就直接沿用 VMess 設定。欄位差異請繼續閱讀VMess 與 VLESS 欄位說明。

Trojan

Trojan 通常搭配 TLS 使用,並以密碼驗證身分。除了位址、連接埠和密碼,也須核對伺服器名稱及憑證驗證所需資訊。遇到 TLS 錯誤時,先檢查名稱、裝置時間與憑證鏈;不要將停用憑證驗證當成一般修復方式。

Hysteria2

Hysteria2 以 QUIC 為基礎,連線仰賴 UDP 網路路徑,驗證與 TLS 參數必須與伺服器端相符。即使網域名稱能解析,UDP 路徑受限時仍可能無法建立連線。若既有資訊包含混淆設定,也要核對相應參數;協定名稱本身不保證延遲較低或傳輸量較高。

WireGuard

WireGuard 使用金鑰建立加密通道,需要相符的本機金鑰、通道位址和對端資訊。公鑰用來識別對應端,私鑰則屬於敏感憑證,不應出現在公開截圖或排查資料中。其參數配置方式不同於密碼或 UUID 類協定,應使用完整的既有設定,而非只複製伺服器位址。

RULES & POLICIES

規則關鍵字與策略

規則左側判斷「比對什麼」,末尾的策略則決定「如何處理」。先檢查 Global Routing,再確認比對順序;範圍較明確的規則通常應放在涵蓋範圍較廣的規則之前。

規則

規則會將比對條件和執行策略放在同一筆項目中,例如 DOMAIN-SUFFIX,example.com,PROXY。Rule 區段通常由上而下檢查,第一條符合的有效規則會決定處理方式,後續項目不會再改變這次比對的結果。編輯時除了確認個別內容是否正確,也要留意它是否已被前面的廣泛規則涵蓋。

DOMAIN

DOMAIN 依完整網域名稱比對,例如 DOMAIN,example.com,DIRECT 只適用於該網域。名稱中包含 example.com,不代表也會自動涵蓋 api.example.com。若要處理整個網域及其子網域,應使用 DOMAIN-SUFFIX 判斷涵蓋範圍,不要反覆猜測完整網域比對的行為。

DOMAIN-SUFFIX

DOMAIN-SUFFIX 依網域後綴邊界比對,填入 example.com 時,可涵蓋該網域本身及 api.example.com 等子網域。它不是任意字串包含比對,因此 notexample.com 不在相同後綴範圍內。範例 DOMAIN-SUFFIX,example.com,PROXY 僅用來示範語法,不代表可用的伺服器設定。

DOMAIN-KEYWORD

DOMAIN-KEYWORD 依網域是否包含指定關鍵字進行比對,涵蓋範圍通常比 DOMAIN 或 DOMAIN-SUFFIX 更廣。關鍵字過短時,可能會將無關網域也納入同一策略。只有確實需要較廣的涵蓋範圍時才使用,並透過連線紀錄檢查是否誤判。

GEOIP

GEOIP 依據 IP 地理資料庫中的分類結果比對,而非依網頁使用的文字或使用者所在位置判斷。網域解析到不同位址時,比對結果也可能改變,資料庫分類亦可能有誤差。連線結果不如預期時,先確認實際目標 IP 和符合的規則,不要只從網站名稱推斷。

IP-CIDR / IP-CIDR6

IP-CIDR 用於 IPv4 網段,IP-CIDR6 用於 IPv6 網段,斜線後的前綴長度決定比對範圍。例如 IP-CIDR,192.0.2.0/24,DIRECT 示範一筆 IPv4 網段規則,其中的位址為文件範例。前綴長度填錯可能擴大處理範圍,檢查時應同時確認位址類型、網路位址與執行策略。

USER-AGENT

USER-AGENT 依據 HTTP 請求中的 User-Agent 資訊比對,並非通用的裝置 App 識別方式。請求資訊是否可見,會受到協定、加密方式與相關處理設定影響。無法比對時,先確認紀錄中是否能取得這項資訊,而不是一味增加關鍵字。

FINAL

FINAL 是後備規則,用來處理前面項目都未符合的連線,通常放在 Rule 區段末尾。例如 FINAL,PROXY 代表將其餘連線交由 PROXY 策略處理。修改 FINAL 會影響所有其餘連線,不只限於單一網站;應先確認已有的精確規則是否涵蓋需要例外處理的目標。

PROXY / DIRECT / REJECT

PROXY 代表使用代理策略,DIRECT 代表直接連線至目標,REJECT 代表拒絕連線;這些關鍵字寫在規則中,適用於符合該規則的連線。規則中的大寫策略關鍵字,不等於 Global Routing 中的 Proxy、Direct 介面選項。若目標符合 REJECT,先檢查規則設定意圖,不要直接將拒絕結果歸因於伺服器故障。

SUBSCRIPTION & CONFIG FILE

訂閱與設定檔

伺服器項目提供連線所需參數,訂閱用來取得或更新項目,設定檔則整理路由與相關設定。匯入成功後,仍須確認內容類型及目前是否已啟用。

伺服器/節點

日常使用中,節點通常指一組可用來建立連線的伺服器參數,包括協定、位址、連接埠、身分憑證及傳輸選項。顯示的備註只是名稱,改名不會改變伺服器實際位置或連線方式。排查時應核對參數本身,分享資料時則應遮蔽密碼、UUID 和其他驗證資訊。

訂閱/Subscribe

訂閱通常透過網址取得伺服器清單,並在更新時同步相關項目;Subscribe 是訂閱相關操作的介面用語。請使用自己已有的訂閱;更新成功只代表本次取得與解析完成,不保證每部伺服器都能連線。訂閱網址可能含有存取憑證,不應公開貼出;匯入入口請參閱訂閱匯入入口說明。

設定檔

設定檔以分段文字整理路由與相關設定,常見區段名稱包括 [General]、[Rule]、[Host] 和 [URL Rewrite]。它不等同於伺服器訂閱:有規則檔不代表已具備建立連線所需的伺服器資訊。匯入後應確認選用的是目標設定檔,並先查看其中的 DNS、後備策略與重寫內容。

Host

Host 區段用來定義特定網域與位址的對應關係,例如 example.com = 192.0.2.1 是文件範例寫法。它會影響網域對應到哪個位址,但不會直接指定該連線使用 PROXY 或 DIRECT。若目標位址已變更,過時的對應資料可能使連線仍指向舊位址,因此應與一般 DNS 查詢結果分開檢查。

URL Rewrite

URL Rewrite 依比對條件重寫 URL 等內容,用途不同於由 Rule 區段決定連線路徑。規則能否生效,也受請求資訊可見度、比對運算式與相關設定限制,並非填入任意 URL 就一定有效。匯入含有重寫內容的設定檔前,應先了解比對範圍與處理結果,避免混淆內容處理和路由問題。

DIAGNOSTICS & CONNECTION

診斷與連線

將「解析目標」、「建立連線」、「驗證身分」和「比對規則」分開檢查。每次只調整一類參數,並記錄調整前後的結果,才能判斷真正的故障環節。

Connectivity Test

Connectivity Test 會依所選測試方式檢查伺服器連線狀況,結果僅涵蓋該次測試涉及的路徑和目標。測試成功不代表所有網站、所有協定或所有規則路徑都能正常運作。應配合實際目標連線、目前的 Global Routing 和連線紀錄判斷,不要將單次測試視為完整的連線證明。

延遲

延遲是特定測試條件下請求與回應所需時間的衡量值,不等同於頻寬或下載速度。不同測試方式、目標與網路狀態下的數值,不能直接互相比較;逾時也不一定代表伺服器在所有條件下都無法使用。若要比較,應維持相同的測試方式與網路環境,並觀察多次結果及實際連線表現。

DNS

DNS 會將網域名稱查詢為位址等紀錄,建立連線前通常須先取得目標位址。解析失敗與取得位址後連線失敗屬於不同環節,修改伺服器密碼無法修復前者。排查時先確認查詢是否有結果,再確認取得的是 IPv4 或 IPv6 位址,以及後續符合了哪條路由規則。

TLS / SNI

TLS 提供傳輸加密與憑證身分驗證,SNI 則在交握時傳送請求的伺服器名稱。用於連線的位址和用於名稱驗證的網域可能不同,應依據既有資訊分別填寫。交握失敗時,請核對名稱、裝置時間、憑證鏈與伺服器端設定;保留憑證驗證並查明錯誤原因。

連線紀錄

連線紀錄可協助確認目標網域或位址、符合的規則、實際採用的策略及錯誤線索,比只看連線開關更有助於找出具體問題。重現故障時,先記下時間與目標,再查找對應連線,區分規則拒絕、解析失敗和連線逾時。對外分享紀錄前,應遮蔽訂閱網址、身分憑證及不需公開的存取內容。

依問題繼續查閱

第一次加入既有伺服器資訊,請依使用說明完成匯入、選擇 Global Routing 與連線驗證。已能連線但分流不如預期,請查閱規則參考中的比對順序與策略說明;遇到訂閱更新或目標連線失敗,再依常見問題逐項排查。

購買、已購項目回復與裝置相容性屬於商店資訊,不應由協定參數推斷。請在正版核對說明中確認開發者 Shadow Launch Technology Limited 與 App ID 932747118;系統需求與裝置相容性以 App Store 頁面標示為準。

返回術語分類 ↑