OFFICIAL MANUAL / GLOSSARY

Shadowrocket 術語表

依介面名稱查詢含義，依規則關鍵字確認比對範圍。英文保留 App 與設定中的原文，並以中文說明用途及不可據此推論的事項。

33 個術語項目
分開理解介面名稱與設定語法

01 / INTERFACE

介面與開關

先確認選項所在位置，再了解它影響的是整體連線還是個別要求。

Home: 查看伺服器項目、選擇連線對象及控制連線的主要入口。選取某個項目只代表指定連線對象，不表示已建立可用連線。初次使用時，匯入資訊後應先確認選取狀態，再測試連線及存取情況。

Global Routing: 決定整體流量處理方式的選項，常見模式為 Config、Proxy、Direct，分別代表設定、代理、直連。排查時應先記下目前選項，避免把切換模式造成的變化誤判為伺服器故障。是否套用具體規則，取決於目前模式。

Config: 在 Global Routing 中，Config 代表依目前設定的規則處理流量；在其他位置也可能指設定管理入口。啟用此模式前，請確認使用的是預期設定，而不只是匯入了檔案。規則順序、策略名稱及最終規則都會影響結果。

Proxy: 在 Global Routing 中，Proxy 代表以代理策略處理流量，通常用於暫時比對連線路徑。它不等於規則文字中的某一行，也不保證所有目標都能存取。使用時仍須有可用的伺服器資訊，並留意 DNS 與連線環境。

Direct: 在 Global Routing 中，Direct 代表採用直連策略，不將要求交由代理伺服器處理。可用來與其他模式比較，判斷問題是否與代理路徑有關。選擇 Direct 不等同於刪除或關閉系統中的 VPN 設定，兩者應分別確認。

On Demand: 依預設條件觸發連線行為的隨選連線設定，作用範圍不同於網域分流規則。設定前應先確認希望在何種網路條件下連線或中斷連線。手動中斷後若又自動連線，請先檢查 On Demand 條件，而非反覆修改伺服器參數。

Connectivity Test: 用於依目前測試條件檢查伺服器是否可連線及其回應時間。測試結果只反映當時的網路、測試方式與目標，不能直接視為下載速度或所有網站的存取狀況。比較結果時應維持條件一致，並搭配實際存取測試。

02 / PROTOCOLS

協定

協定名稱代表通訊方式，不代表服務品質；參數須與既有伺服器資訊相符。

Shadowsocks: 一種代理協定，用戶端與伺服器必須使用相符的位址、連接埠、密碼及加密方式。只填對位址並不足以建立連線。手動輸入時應逐項核對加密方式，不要因名稱相近就自行替換。

VMess: 通常使用 UUID 身分資訊的代理協定，完整連線還可能需要額外的傳輸層與安全層設定。UUID 正確不代表 Host、Path 或 TLS 參數也正確。匯入後若連線失敗，應對照原始資訊檢查整組欄位，而非只更換連接埠。

VLESS: 一種代理協定，須一併確認身分資訊、所用傳輸方式及安全層參數。協定名稱本身並未涵蓋所有連線條件。既有資訊若包含 Server Name、Path 等欄位，應依原值核對，不宜憑經驗補填或省略。

Trojan: 通常搭配 TLS 與密碼驗證使用的代理協定。伺服器位址、連接埠、密碼及憑證對應的名稱都可能影響連線。遇到憑證驗證問題時，應先確認位址、Server Name 與系統時間，不應把關閉驗證當作一般解法。

Hysteria2: 以 QUIC 為基礎的代理協定，連線仰賴目前網路支援相應的 UDP 流量。網路環境改變，可能使相同參數產生不同的連線結果。排查時應分別檢查驗證資訊、TLS 參數及 UDP 連線條件，而非只確認網域是否能解析。

WireGuard: 透過公私鑰建立加密通道的協定，須核對本機位址、對端公鑰、Endpoint 及路由範圍。私鑰屬於敏感憑證，不可放入公開截圖或排查紀錄。交握成功只代表部分連線條件成立，還須進一步確認路由與 DNS。

HTTP / SOCKS5: 兩種常見的代理協定名稱；驗證方式及可承載的要求類型，應依伺服器實際設定確認。不能只憑協定名稱推斷連線是否加密。新增時應確認 Type、位址、連接埠及驗證欄位，避免把一種協定的參數填入另一種類型。

03 / RULES & POLICIES

規則關鍵字與策略

關鍵字負責判斷是否符合條件，策略則決定符合後如何處理。

規則: 通常由比對類型、比對內容及處理策略組成，並依設定中的順序進行判斷。前面的寬鬆規則可能先於後面的精確規則符合，因此不能只檢查單一行是否正確。規則是否生效，也取決於目前 Global Routing 是否採用 Config。

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN 比對完整網域名稱，DOMAIN-SUFFIX 比對指定網域及其子網域，DOMAIN-KEYWORD 則比對網域名稱中的關鍵字。三者的範圍不同，關鍵字比對尤其要留意誤判。設定網域規則時，不要混入 URL 的路徑或查詢參數。

GEOIP: 依 IP 地理位置資料庫中的歸屬資訊比對，而非依網頁語言、網域後綴或使用者所在地判斷。結果會受到資料庫及實際解析位址影響。同一網域若使用不同位址，符合的規則也可能改變，因此須搭配連線紀錄確認。

IP-CIDR / IP-CIDR6: 分別用於比對 IPv4 與 IPv6 網段，以位址和前綴長度表示範圍。前綴長度會影響涵蓋範圍，不可將單一位址與整個網段混為一談。設定時應確認目標實際使用的位址類型，避免只涵蓋其中一種。

FINAL: 先前規則皆未符合時套用的最終規則，通常放在規則清單末尾。它決定其他要求如何處理，但不會覆蓋已符合前面規則的要求。若排查時所有目標都套用 FINAL，應優先檢查前面的比對內容及規則順序。

PROXY / DIRECT / REJECT: 規則中的處理策略：PROXY 交由代理路徑處理，DIRECT 採用直連路徑，REJECT 拒絕要求。這些大寫策略名稱不可與 Global Routing 中的 Proxy、Direct 混為同一設定。REJECT 依據可比對的要求範圍運作，無法選擇性刪除同一網域中的任意內容。

USER-AGENT: 依可讀取的要求 User-Agent 資訊進行比對，而非依 App 顯示名稱判斷。加密要求中的相關資訊未必能直接讀取，因此這種方式並不適用於所有要求。若比對結果異常，應先確認要求是否包含可供比對的資訊。

規則語法範例，非完整設定

以下內容僅示範比對類型與策略之間的關係。example.com 是教學用網域範例；使用前仍須確認目前設定中的策略定義及順序。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

04 / SUBSCRIPTION & CONFIG

訂閱與設定

匯入、更新、規則設定及資料同步是不同操作，彼此不能取代。

Add Server: 依使用者既有伺服器資訊手動建立項目的入口，通常先選擇 Type，再填入 Address、Port 等對應欄位。不同協定需要的欄位不盡相同。儲存前應對照原始資料逐項核對，不能只因欄位都已填寫就認定參數正確。

Scan QR Code: 透過 QR Code 讀取既有伺服器或訂閱資訊的方式，本質上是匯入經編碼的內容。掃描完成後仍須核對類型、位址及名稱。QR Code 可能包含完整憑證，因此分享圖片前應確認分享對象，不要將其當作一般裝飾圖片公開。

訂閱更新: 重新讀取遠端訂閱內容，並更新本機對應的伺服器項目；這不是更新 Shadowrocket App。遠端內容變更可能造成項目新增、移除或參數改變。更新前應記下自己的命名與整理方式，更新後再確認目前選取項目是否符合預期。

設定檔: 用來儲存規則、策略關聯及相關設定的文字設定檔，與只提供伺服器集合的訂閱並非同一項目。匯入設定檔後，通常還須確認目前是否正在使用該檔案。修改前建議保留可還原的副本，逐項變更並驗證，避免同時改動多個因素。

DNS: 將網域名稱解析為 IP 位址的機制，會影響要求後續連線的目標及部分規則判斷。解析成功不代表連接埠可連線，也不代表伺服器驗證成功。若只有網域存取異常，應將 DNS 結果與實際連線失敗分開檢查。

URL Rewrite: 依條件改寫要求位址或相關要求行為的設定功能，不等同於將流量交由特定代理策略處理。此功能能否作用於要求，會受協定、加密及可讀取資訊限制。使用前應了解比對範圍，並保留可還原的設定，以便處理意外轉址或要求失敗。

iCloud 同步: 啟用相關設定後，透過 iCloud 同步支援的資料；實際同步範圍請以 App 內說明為準。同步狀態與 App Store 已購資格屬於不同系統，重新取得 App 不等於還原所有設定。同步也不能取代修改前的獨立備份。

需要依序操作時，請參閱訂閱與伺服器管理；初次使用可從入門指南開始。

05 / APP STORE & ACCOUNT

App Store 與帳號

購買資格、App 資料及連線服務分別管理，還原時也須分別確認。

App Store 正版確認: 請同時核對開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118。Shadowrocket 僅能在 Apple 平台透過 App Store 取得，主要支援 iPhone / iPad。裝置相容性及系統需求請以 App Store 頁面標示為準。

一次買斷: 指購買 Shadowrocket 用戶端的付費方式，美國商店定價約為 $2.99，實際價格請以商店頁面為準。一次買斷用戶端 ≠ 線路方案；使用連線功能仍須有自己的訂閱或伺服器資訊。其他裝置的通用購買資格請以 App Store 頁面標示為準。

已購項目: 在 App Store 帳號的購買紀錄中查找並重新取得已購 App 的入口，適用於換機或重新安裝後確認。請先確認目前使用的商店帳號與原購買紀錄相同。重新取得用戶端不會自動重新產生原有訂閱憑證，App 資料是否還原也須另行確認。

商店地區: 決定帳號使用的 App Store 店面，以及商品顯示與結帳條件，並非系統顯示語言。若搜尋不到 App，可先確認帳號店面、年齡分級限制及帳號狀態。變更地區會影響付款方式及現有帳號權益，操作前請先閱讀系統提示。

購買、確認及還原已購項目的完整步驟，請參閱App Store 下載指南。若已確認術語含義但連線仍異常，可繼續查閱常見問題。