官方手冊 · 術語查閱

Shadowrocket 術語手冊

介面用語、協定名稱與規則關鍵字

先確認名稱出現在哪個位置,再判斷它的作用。相似的拼法可能分別指頁面、路由模式或規則策略;本頁保留英文原文,並依使用情境說明差異。

  • 5 類術語
  • 33 個項目
  • 英文原文對照

介面與開關

分清楚「在哪裡操作」和「如何處理連線」。尤其要留意 Config、Proxy、Direct 與大寫規則策略的使用情境。

Home
Home 是查看伺服器紀錄、選擇連線對象及操作主要連線開關的頁面。先確認清單中已有可用紀錄,再檢查 Global Routing,最後開啟連線;清單中看得到紀錄,不代表 VPN 已連線。連線後的存取結果也取決於所選伺服器、目前設定及網路狀態。
Global Routing
Global Routing 決定連線採用哪種全域處理模式,常見選項為設定(Config)、代理(Proxy)及直連(Direct)。Config 依目前設定中的規則處理連線,Proxy 主要使用所選代理,Direct 則主要直接存取目標。排查分流結果前,先核對此處設定,避免修改規則後仍在其他模式下測試。
Config
Config 常見有兩種使用情境:作為頁面名稱時用來管理設定檔,作為 Global Routing 選項時則表示依設定處理連線。匯入檔案與選用檔案是兩個不同操作,儲存後還要確認目前生效的設定。閱讀教學時先確認指的是頁面入口還是模式選項,不要只憑相同名稱判斷操作位置。
Proxy
Proxy 是 Global Routing 中的模式名稱,主要將連線交由目前選取的代理處理。它不是伺服器協定類型,也不代表目前伺服器已通過連線測試。與規則中的 PROXY 相比,前者控制整體模式,後者則是符合某條規則後採用的處理策略。
Direct
Direct 是 Global Routing 中主要讓連線直接存取目標的模式,適合用來比較目前網路直接存取的情況。選取此模式不代表從系統移除 VPN 設定,也無法據此判斷主要連線開關是否關閉。若要暫停用戶端連線,應另外確認 Home 的開關狀態。
On Demand
On Demand 是依已設定條件觸發 VPN 連線的機制,不是另一種伺服器協定。啟用後,符合條件的網路要求可能再次觸發連線,因此手動停止後又重新連線時,應先檢查相關條件。調整前先確認希望在哪些情境連線,再逐項驗證,避免同時變更多項網路設定。
Add Server
Add Server 是手動新增伺服器資訊的入口,須依現有資料選擇類型並填寫位址、連接埠及驗證參數。不同協定的必填欄位各異,不能將一組參數直接套用到另一種類型。資料不完整時,應先核對原始資訊;伺服器位址、密碼及其他驗證資料也不宜出現在公開截圖中。
Data
Data 可用來查看用戶端記錄的流量,實際統計項目以 App 目前頁面為準。這裡的數字反映用戶端的統計方式,不等同於服務商提供的流量額度或計費帳單。比對數據時應確認統計期間、是否曾歸零,以及連線期間的實際流量;不能只憑單次讀數判斷計費異常。
Settings
Settings 集中管理 App 偏好設定及相關行為,與 Config 中的設定內容並非同一層級。修改前先記下原值,並確認變更影響的是整個 App 還是目前設定。排查時每次只調整一項,再以相同目標重新測試,方便判斷是哪項設定改變了結果。

協定

協定描述用戶端與伺服器之間的通訊方式。支援某種協定,不代表任意位址與驗證資訊都能搭配使用。

Shadowsocks
Shadowsocks 是一種加密代理協定,常見參數包括伺服器位址、連接埠、加密方法及密碼。加密方法必須與伺服器端一致,只有位址正確仍可能無法連線。匯入既有紀錄後,應核對參數是否完整,尤其不要混用密碼、加密方法及其他協定的驗證欄位。
VMess
VMess 是一種代理協定,通常使用 UUID 作為部分驗證資訊,並搭配特定傳輸設定。除了位址與連接埠,還可能需要核對 TLS、傳輸路徑及 Host 等參數。UUID 正確不代表其他欄位可以留白,應以你現有的完整伺服器資料為準。
VLESS
VLESS 是一種代理協定,驗證識別碼、傳輸方式及安全層設定須分別相符。協定名稱本身無法完整說明連線是否加密,也不能取代 TLS 等安全參數的核對。連線失敗時,先比對原始資料與匯入欄位,再檢查網路,不要只是不斷更換 UUID。
Trojan
Trojan 是一種通常搭配 TLS 使用的代理協定,伺服器密碼及憑證驗證相關參數都須相符。伺服器位址與用於憑證驗證的名稱可能各有不同用途,填寫時應依照原始資料。遇到憑證錯誤時,應檢查名稱、裝置時間及憑證狀態,不要把關閉驗證當作一般解決方法。
Hysteria2
Hysteria2 是以 QUIC 為基礎的代理協定,連線需要網路支援 UDP。即使驗證資訊正確,連線逾時也可能與目前網路或伺服器端 UDP 是否可連通有關。它與其他協定中同名欄位的意義不一定相同,匯入及核對時應使用對應類型的參數。
WireGuard
WireGuard 是以金鑰為基礎的通道協定,本機與對端的金鑰、位址及端點資訊都須正確配對。私鑰屬於敏感資訊,不應與用於核對的公鑰混淆,也不應公開分享。匯入設定後仍須檢查位址、路由範圍及 DNS 設定;即使交握成功,也不代表所有目標都能存取。

規則關鍵字

規則先描述比對條件,再指定處理策略。通常會依序判斷;若太早放入範圍寬泛的條件,後面的精確規則可能就不會生效。

DOMAIN
DOMAIN 會比對完整網域名稱,例如 DOMAIN,example.com,DIRECT 只適用於指定網域。它不會自動涵蓋 www.example.com 等子網域,也不會比對網址中的路徑。若要涵蓋整組子網域,應進一步了解 DOMAIN-SUFFIX 的比對範圍。
DOMAIN-SUFFIX
DOMAIN-SUFFIX 依網域後綴比對;填入 example.com 時,可涵蓋該網域及其子網域。此處應填網域部分,不要加上網址的協定前綴或頁面路徑。確認規則範圍時,應考量整個網域下的服務,避免只因一個頁面就改變所有子網域的處理方式。
DOMAIN-KEYWORD
DOMAIN-KEYWORD 會檢查網域名稱是否包含指定字串,比對範圍通常比精確網域規則更廣。同一字串可能出現在多個不相關的網域中,因此不能據此可靠判定網域歸屬。若只要處理某個確定的網域,優先考慮範圍更明確的條件。
GEOIP
GEOIP 依據 IP 地理資訊資料庫判斷目標 IP 所屬地區,例如 GEOIP,CN,DIRECT。它判斷的不是網頁語言、帳號地區或網站營運者所在地。資料庫紀錄、DNS 回傳結果及內容傳遞網路都會影響實際比對結果,應搭配連線紀錄檢查,不能只根據網站名稱推斷。
IP-CIDR
IP-CIDR 使用 CIDR 網段表示法比對目標 IPv4 位址,例如 IP-CIDR,192.0.2.0/24,DIRECT;其中的位址僅供文件示範。斜線後的前綴長度決定涵蓋範圍,不是連接埠號碼。IPv6 位址請使用相應的 IP-CIDR6 規則,編輯前應先確認位址類型與網段界線。
FINAL
FINAL 是前面的規則都未符合時採用的後備規則,例如 FINAL,PROXY。它通常放在規則清單末尾,因為太早套用後備規則會讓後續條件失去比對機會。若大量連線都套用 FINAL,應檢查前面的比對條件是否過於狹窄或有誤,以及目前是否處於 Config 模式。
PROXY
PROXY 是規則策略關鍵字,表示符合規則後交由代理路徑處理;實際出口取決於目前選擇與設定。它本身不包含伺服器位址、驗證資訊,也不保證代理可用。不要將這個大寫關鍵字與 Global Routing 的 Proxy 模式混淆:規則策略只有在相關規則參與判斷並符合時才會生效。
DIRECT
DIRECT 是符合規則後直接存取目標的策略關鍵字,這條連線不會使用代理伺服器作為出口。直連能否成功仍受目前網路、DNS 結果及目標服務狀態影響。它也不代表關閉整個用戶端;同一份設定中,其他連線仍可能依照其他規則採用不同策略。
REJECT
REJECT 表示拒絕符合規則的連線,不是「換一條線路重試」。如果條件範圍過廣,可能連帶阻擋登入、圖片或 App 介面等正常要求。遇到單一功能無法使用時,應先檢查是否符合拒絕規則,再縮小規則範圍,不宜直接刪除整份設定。

訂閱與設定

訂閱負責更新伺服器紀錄,設定則描述連線行為。先判斷缺少哪類資料,再選擇相應的匯入及排查步驟。

Subscribe
Subscribe 可透過訂閱網址匯入及更新伺服器紀錄;訂閱須向你的服務商取得。更新通常只會更新該訂閱管理的紀錄,不代表已選取新的伺服器,也不代表已建立連線。訂閱網址可能含有個人憑據,請妥善保管;更新失敗時,先檢查網址是否有效、網路狀態及回傳內容格式。
伺服器紀錄
伺服器紀錄是用戶端儲存的一組位址、連接埠、協定及驗證參數,也常稱為節點。清單中的名稱只是方便辨識的標籤,不能據此判斷實際位置、速度或是否可用。修改參數前,先確認紀錄是手動輸入還是由訂閱管理,因為後續更新訂閱可能會覆蓋訂閱管理的內容。
設定檔
設定檔描述規則、DNS 與相關連線行為,不等同於包含伺服器紀錄的訂閱。匯入設定檔不一定會取得可用伺服器,匯入訂閱也不代表已完成規則設定。使用前應確認設定檔來源、內容及是否符合目前需求,並在 Config 中核對生效的檔案,避免只儲存檔案卻未選用。
DNS
DNS 會將網域名稱解析為 IP 位址,是存取目標前的重要環節,但解析成功不代表連線一定成功。解析所走的路徑與業務連線最後採用的路徑須分別檢查,不能只憑一個 IP 結果推斷流量出口。排查時先分辨網域無法解析、解析結果異常或連線目標逾時,再調整相應設定。
Connectivity Test
Connectivity Test 依目前測試方式檢查伺服器連線狀態,顯示的時間只代表這次測試結果。延遲較低不代表下載速度較快,單次測試成功也不表示所有網站與服務都能正常存取。比較結果時,請維持相同的測試方式與網路,並實際測試目標服務,避免只看單一數值。

App Store 與購買

購買紀錄決定 App 的取得資格,伺服器與訂閱資訊則屬於另一類資料。更換裝置時,應分別檢查這兩部分。

App Store
App Store 是 Shadowrocket 唯一的購買與取得管道,iPhone 與 iPad 使用者應在產品頁核對 App 資訊。是否能看到 App 會因目前帳號所屬的商店地區而異;搜尋結果出現相似名稱時,也應逐項確認。相容裝置及系統需求以 App Store 頁面標示為準,取得前可閱讀正版下載說明。
App ID
Shadowrocket 的 App ID 為 932747118,產品頁網址中顯示為 id932747118。核對正版時,也應一併確認開發者 Shadow Launch Technology Limited 與官方圖示,不能只憑相似名稱判斷。App ID 是產品識別碼,不是帳號識別碼,也不是訂閱驗證資訊。
一次性買斷
一次性買斷是指購買用戶端的使用資格;美國商店價格約為 2.99 美元,各商店會以當地貨幣顯示,實際金額以 App Store 頁面為準。用戶端一次性買斷 ≠ 連線方案;購買 App 不會自動取得伺服器或訂閱。既有訂閱仍須向你的服務商取得,並依使用說明另外匯入。
已購項目
已購項目是指 App Store 中與購買帳號連結的 App 紀錄,可在更換裝置或重新安裝時用來重新取得 App。先確認登入的是購買時使用的 Apple ID,再到帳號的 App 或購買紀錄中查找;實際入口名稱以裝置介面為準。重新取得 App 與還原訂閱、設定是不同事項,詳見已購項目還原說明。

依照操作步驟繼續查閱

確認術語後,請回到對應步驟核對設定。涉及規則時,先檢查 Global Routing 與目前設定,再比對規則順序及符合結果。