OFFICIAL MANUAL / GLOSSARY
Shadowrocket 名詞解釋
依介面原文查詢含義,再確認目前設定。區分連線模式、協定參數與規則策略,避免把名稱相近的選項誤認為同一項設定。
- 五類術語
- 英文原文對照
- 每項均可透過錨點直接定位
- Home
- 查看伺服器項目、目前選取項目與連線開關的主要頁面。匯入成功只代表項目已新增,不代表已選取該項目或建立連線;驗證前先確認實際選取項目,再查看開關狀態。若頁面有多個群組,應確認選取的是準備測試的項目。
- Global Routing
- 決定以哪種整體方式處理要求的全域選項,對應設定、代理、直連三種模式,介面用語分別是 Config、Proxy、Direct。若規則似乎未生效,應先確認此處,而非立即修改規則。切換模式會改變排查前提,測試時應記錄目前選項。
- Config / Proxy / Direct
- 在 Global Routing 中,Config 表示依目前設定中的規則處理,Proxy 表示使用代理模式,Direct 表示使用直連模式。此處的 Config 是一種模式,不是管理設定檔的頁面;Proxy、Direct 也不可與規則中的大寫策略詞混為一談。恢復日常使用前,應確認沒有停留在暫時測試模式。
- On Demand
- 依系統條件觸發 VPN 連線的隨選機制,並非伺服器測速或自動修復功能。手動中斷後又重新連線時,先檢查是否仍有生效中的隨選條件,以及系統中的 VPN 設定狀態。測試連線故障時,可先記錄條件,暫時停用後比較結果。
- Add Server
- 手動輸入現有伺服器資訊的入口,先選擇協定類型,再填寫相應欄位。位址、連接埠、身分或密碼、傳輸方式與 TLS 參數應逐項對照伺服器資料,不要只憑名稱猜測。儲存後還要返回 Home 確認選取項目,並實際測試連線。
- Connectivity Test
- 用來檢查目標項目在目前網路下是否連通,結果會受測試目標、網路路徑與測試方式影響。測得的延遲不是檔案下載速度,也不能保證所有網站都能存取。若結果異常,先在相同網路與測試條件下重測,再配合實際存取情況與記錄判斷。
02 / PROTOCOLS
協定
協定名稱決定參數的解讀方式。匯入後應依使用者現有的伺服器資料逐項確認,不要把協定名稱當成速度或穩定性的保證。
- Shadowsocks
- 使用指定加密方法與驗證參數傳輸代理流量的協定,用戶端與伺服器須採用一致設定。確認時至少檢查位址、連接埠、密碼與加密方法,不能只確認密碼正確。若資料包含其他傳輸參數,也應保留原值,避免匯入時遺漏。
- VMess / VLESS
- 這是兩種不同的代理協定,即使項目中都出現 UUID,也不能互換協定類型。應一併確認身分欄位、傳輸方式、Host、路徑與 TLS 設定;實際欄位依伺服器部署方式而定。VLESS 名稱本身不代表已啟用傳輸加密,須另外確認 TLS 等設定。
- Trojan
- 透過 TLS 傳輸並使用密碼驗證的代理協定;驗證與憑證檢查是兩項不同的確認項目。連線失敗時,應分別確認密碼、連線位址、連接埠與 SNI,不要直接關閉憑證檢查。憑證不符也可能是伺服器名稱填錯或裝置時間異常所致。
- Hysteria2
- 以 QUIC 為基礎的代理協定,連線仰賴目前網路的 UDP 可達性,也須設定正確的驗證與 TLS 參數。在某個網路環境中持續逾時時,先比較另一個網路的結果,再判斷是否為參數錯誤。協定類型相同,不代表不同伺服器的驗證、混淆或頻寬相關設定可以通用。
- WireGuard
- 使用公鑰架構建立加密通道的協定,須一併確認本機私鑰、對端公鑰、Endpoint、位址與路由範圍。只有伺服器位址通常不足以組成完整設定;路由範圍錯誤也可能造成部分要求無法連線。私鑰屬於敏感資訊,排查記錄與截圖應予以遮蔽。
- HTTP / SOCKS5
- 兩種代理協定,位址、連接埠與選用的帳號驗證須與伺服器一致。協定名稱本身不代表連線已透過 TLS 加密,是否加密應確認具體傳輸設定。SOCKS5 的 UDP 使用也取決於伺服器能力與用戶端設定,不能以一次網頁存取結果取代檢查。
- TLS / SNI
- TLS 用於建立加密連線並驗證對端身分;SNI 則在交握時指定伺服器名稱。連線位址可能是 IP,而憑證對應的是網域名稱;遇到這種情況,應依伺服器資料填寫名稱,不要直接照抄位址。發生驗證錯誤時,先檢查名稱、憑證有效期限與系統時間,再排查伺服器端問題。
03 / RULE KEYWORDS
規則關鍵字
先看比對條件,再看末尾策略。以下語法僅供理解規則,不代表應直接取代使用者的整份設定。
- Rule
- 規則依據網域、位址或其他要求特徵選擇處理策略,通常由上而下比對,命中後依該條規則執行。前面的寬泛規則可能涵蓋後面的具體規則,因此順序與條件同樣重要。開始修改前,先確認 Global Routing 設為 Config,並保留目前檔案的副本。
- DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
- DOMAIN 比對完整網域名稱;DOMAIN-SUFFIX 比對網域本身及其子網域;DOMAIN-KEYWORD 比對網域中包含的關鍵字。三者範圍不同,關鍵字太短可能影響原本不打算處理的網域。若只需處理單一主機,優先確認完整網域名稱;若要涵蓋一組子網域,再考慮使用後綴條件。
- IP-CIDR / IP-CIDR6
- 分別用於比對 IPv4 與 IPv6 位址網段,斜線後的前綴長度決定涵蓋範圍。前綴長度越小,通常涵蓋的位址範圍越大;填寫錯誤可能使無關要求套用相同策略。網域解析結果變動時,位址規則的命中情況也可能改變,須配合實際目標位址檢查。
- GEOIP
- 依 IP 地理資料庫的分類結果比對,並非依使用者目前所在位置判斷。資料庫紀錄、服務部署地點與網域用途不一定一致,因此不能把分類結果當成存取行為的絕對依據。個別網站的策略不符預期時,可先確認目標 IP,再考慮使用更具體的網域規則。
- FINAL
- 前面的規則都未命中時使用的預設規則,通常放在規則末尾。
FINAL,PROXY表示將未命中的要求交由 PROXY 處理,不代表先前的要求都會經過代理。若大量要求意外套用 FINAL,應先檢查上方規則是否涵蓋實際要求的網域或位址。
- PROXY / DIRECT / REJECT
- 規則末尾常見的處理策略,分別表示交由代理策略處理、直接連線與拒絕連線。PROXY 的實際出口仍須配合目前選取的伺服器與設定確認;DIRECT 也不保證目標一定可連線。此處的大寫策略詞屬於規則語法,不是 Global Routing 中的 Proxy、Direct 介面選項。
- URL Rewrite
- 依比對條件處理要求 URL 的設定功能,與更換伺服器、修改 DNS 或一般網域分流並非同一回事。實際效果取決於要求是否可見、協定類型與相關設定,不能認為新增規則後所有 HTTPS 要求都會受到處理。排查頁面跳轉異常時,應記錄原有規則,每次只停用一項並比較結果。
04 / CONFIGURATION
訂閱與設定
區分伺服器項目與規則檔案:更新其中一項,不代表另一項也已更新。訂閱與 QR Code 都只處理使用者現有的資料。
- Subscribe
- 用來匯入或更新使用者現有訂閱資訊的入口,連結通常會提供一組伺服器項目。訂閱與規則設定不一定是同一份內容,匯入後應確認取得的是伺服器清單還是設定檔。連結可能包含存取憑證,不應放入公開截圖、聊天紀錄或排查說明。
- SERVER
- 用來標示伺服器資訊的介面用語。可用項目通常由協定、位址、連接埠與驗證參數組成。項目顯示名稱只是識別標籤;名稱相同不代表參數或實際出口相同。連線異常時,應確認具體欄位,而非只改顯示名稱。
- Config
- 在設定檔管理情境中,Config 指用來檢視、匯入及選取設定檔的頁面;檔案可包含 General、Rule 等內容。匯入後須確認目前實際使用的檔案,不能只因清單中出現檔名就認定已生效。它與 Global Routing 中同名的 Config 模式相關,但不是同一個操作入口。
- Scan QR Code
- 透過 QR Code 讀取現有伺服器或設定資料的入口。QR Code 只是資料載體,不代表內容完整或來源可信。成功識別後應確認協定類型、位址與驗證欄位,確認內容符合預期後再儲存。包含憑證的 QR Code 和原始連結一樣需要妥善保存,不可公開展示。
05 / SYSTEM & STORE
系統與商店
系統授權、資料同步與購買紀錄各自獨立。重新下載 App,不代表設定與伺服器資訊也已還原。
- DNS
- 將網域名稱解析為 IP 位址的機制,是網域存取流程的一環。若連線測試有結果,但網頁網域仍無法存取,應確認解析設定與實際回傳的位址,並比較目前網路的狀況。
dns-server = system表示使用系統 DNS 設定,不代表每種網路都會得到相同結果。
- VPN 設定
- Apple 系統允許 Shadowrocket 建立網路通道所需的設定與授權。首次啟用連線時,系統可能會顯示確認提示。授權成功只代表系統允許建立連線,不代表伺服器驗證、DNS 或規則設定正確。若開關無法啟用,先檢查系統 VPN 設定,再依故障排除手冊檢查後續環節。
- iCloud 同步
- 在帳號與 App 設定允許的範圍內同步相關資料;可同步的具體項目請以目前 App 內的說明為準。iCloud 資料與 App Store 購買紀錄屬於不同範圍,不能據已購紀錄判斷設定是否存在。更換裝置前應確認同步狀態並保留必要備份,還原後再確認檔案與伺服器項目。
- 已購項目
- 在 App Store 查詢過往購買紀錄及重新下載 App 的入口。帳號頁面的具體名稱可能隨系統介面而異。找不到 Shadowrocket 時,先確認「媒體與購買項目」使用的是原購買帳號,再檢查商店地區與購買紀錄。完整確認步驟請見已購項目復原說明;重新下載後仍須確認設定資料。
- 一次買斷
- 指購買 Shadowrocket 用戶端的付費方式。此 App 為閉源商業應用,唯一取得管道是 App Store。用戶端一次買斷 ≠ 連線方案;實際連線仍須由使用者備有自己的訂閱或伺服器資訊。價格、通用購買與家人共享的適用範圍,請以 App Store 頁面標示為準。
- App Store 相容性
- 商店產品頁中用來確認支援裝置與系統需求的欄位,購買前應展開詳閱。Shadowrocket 主要供 iPhone 與 iPad 使用;Mac、Apple TV、Apple Vision 也列於同一商店頁的相容性欄位,系統需求一律以 App Store 頁面標示為準。確認為正版時,也請核對官方圖示、開發者 Shadow Launch Technology Limited 與 App ID
932747118。
需要操作步驟時,請依任務接續閱讀;遇到故障時,先記錄目前模式與錯誤訊息原文。