Home
Home 是查看伺服器項目與操作連線開關的入口。清單中出現項目,只代表參數已儲存,不表示驗證成功或連線正在執行。匯入後,先確認選取的項目,再檢查 Global Routing,最後開啟連線並確認實際請求。
OFFICIAL GUIDE · TERMS
依介面名稱查詢意義,依規則關鍵字了解比對範圍。本頁保留英文原文,說明各術語的差異;實際按鈕位置與可用欄位以目前裝置上的 Shadowrocket 為準。
取得方式分為兩種:iPhone / iPad 版透過 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片版與 Intel 版;各平台取得方式與安裝說明請見全平台下載,電腦與 Android 安裝檔使用本站 /dl/ 路徑。
INTERFACE / 01
請先區分「選擇哪個伺服器」、「採用哪種路由模式」與「是否已建立連線」。這三者分別影響連線目標、請求去向與目前狀態,不能互相取代。
Home 是查看伺服器項目與操作連線開關的入口。清單中出現項目,只代表參數已儲存,不表示驗證成功或連線正在執行。匯入後,先確認選取的項目,再檢查 Global Routing,最後開啟連線並確認實際請求。
Global Routing 決定請求採用哪種整體處理方式:設定對應 Config,代理對應 Proxy,直連對應 Direct。Config 依目前設定分流,Proxy 將請求交由代理路徑處理,Direct 則直接連線。規則未生效時,請先確認目前是否使用 Config,而非立即改寫規則。
Config 既是設定管理入口,也會作為 Global Routing 的一種模式名稱。設定檔可包含規則、DNS 等設定,但伺服器清單與設定檔並非同一份資料。匯入設定檔不代表它已成為目前使用的設定;修改前請記下目前選項並保留備份。
On Demand 可讓系統在符合設定條件時觸發 VPN 連線。它控制連線何時啟動,不會修正密碼、伺服器位址或規則內容。啟用前請先確認手動連線正常;若手動關閉後又自動連線,請檢查既有的 On Demand 條件,而非反覆操作總開關。
Add Server 是手動輸入既有伺服器資訊的入口。先選擇協定類型,再填入位址、連接埠及對應的驗證欄位;TLS、傳輸方式等額外選項必須與伺服器端一致。不同協定所需欄位不同,不要直接照抄其他類型項目的整組參數。
Connectivity Test 檢查指定測試條件下的連線能力,結果會受測試目標、本機網路與伺服器狀態影響。測試成功不代表所有網站或 App 都能存取,數值較低也不代表下載速度一定較快。比較結果時,請維持測試方式與網路環境一致。
PROTOCOLS / 02
協定名稱說明雙方如何通訊,不代表速度排名。實際可用性取決於伺服器端設定、本機網路與傳輸條件;填寫時請以已有的伺服器參數為準。
Shadowsocks 是一種加密代理協定,常見參數包括伺服器位址、連接埠、加密方式與密碼。加密方式必須與伺服器端一致;即使密碼正確,方式不符仍可能無法連線。若既有項目還有其他傳輸選項,也須一併核對,不能只保留位址與密碼。
VMess 是一種代理協定,驗證識別碼與傳輸設定共同決定連線能否建立。UUID、傳輸方式、路徑及 TLS 等欄位各屬不同層次,某一項相同不代表整個項目相同。匯入後請逐項比對既有資訊;驗證異常時,也可檢查裝置時間是否正確。
VLESS 是一種代理協定,其驗證機制與底層傳輸安全須分開理解。選擇 VLESS 不代表 TLS 或其他安全設定已自動配妥。UUID、伺服器名稱與傳輸相關欄位應依伺服器的實際設定填寫,不要從其他項目拼湊參數。
Trojan 通常搭配 TLS 使用,密碼驗證與 TLS 交握是不同的檢查環節。位址、連接埠、密碼及伺服器名稱都應與既有設定相符。遇到憑證或名稱相關錯誤時,先核對網域名稱與裝置時間;不要將略過憑證驗證當成一般修復方式。
Hysteria2 以 QUIC 為基礎,仰賴底層 UDP 通訊條件。在部分高封包遺失的連線中可能適用,但若網路限制 UDP 或路徑不穩,也可能無法建立連線。協定名稱本身不保證速度;測試時應同時觀察切換網路前後的連線能力與實際使用狀況。
WireGuard 是以金鑰驗證的通道協定,端點、介面位址、對端公鑰及路由範圍須搭配設定。私鑰屬於敏感資訊,不應出現在公開截圖、記錄或分享內容中。通道成功建立也不代表所有目標都能連線,還須檢查路由範圍與 DNS 設定。
HTTP 與 SOCKS5 是兩種不同的代理協定類型,所需驗證方式與可用功能取決於伺服器實作。協定名稱本身不代表連線具有相同的加密保護,也不能只憑名稱就把 HTTP 代理視為 HTTPS 連線。請準確選擇伺服器實際提供的類型,並分別核對安全設定。
想了解傳輸條件,可接著閱讀Hysteria2 與 QUIC 的適用情境。
RULE KEYWORDS / 03
一條規則通常包含比對類型、比對內容與處理策略。規則順序會影響結果;以下說明有助於理解語法,不代表需要將所有範例加入目前設定。
Rule 描述「符合什麼條件時,採用哪種處理方式」。在依序檢查的規則清單中,前方最先符合的有效規則通常會決定請求去向,因此須留意較具體的規則應放置的位置。新增規則後應確認實際命中結果,不能只因檔案中有該行就認定規則已生效。
DOMAIN-SUFFIX 依網域後綴比對,例如 example.com 可涵蓋該網域及其子網域。它比對的是網域,不是 URL 路徑或查詢參數。使用時請確認涵蓋範圍,避免範圍過廣的後綴規則優先命中原本需要個別處理的子網域。
DOMAIN 用於比對完整網域,DOMAIN-KEYWORD 則檢查網域中是否包含指定關鍵字。後者涵蓋範圍較廣,可能命中名稱相似但用途不同的網域。若只需處理單一主機,請先了解完整比對的範圍,不要把關鍵字規則當成後綴規則使用。
GEOIP 依 IP 地理資料庫判斷位址歸屬,例如 GEOIP,CN,DIRECT 表示將符合的位址交由 DIRECT 處理。資料庫結果不等於公司註冊地或目前使用者的實際位置。網域解析結果與資料庫內容都會影響判斷;結果不符時,請檢查實際目標 IP。
IP-CIDR 用於 IPv4 位址範圍,IP-CIDR6 用於 IPv6 位址範圍,斜線後的數字表示網路前綴長度。這些規則依 IP 範圍比對,不會依網域文字比對。同一服務可能回傳多個位址,或同時使用 IPv4 與 IPv6,因此單一位址範圍未必涵蓋所有連線。
FINAL 為前面規則都未命中的請求提供預設處理方式,通常放在規則末尾。它決定其餘請求的去向,而非比對特定網域。修改 FINAL 前請確認既有策略可用,並了解未涵蓋請求的範圍,避免只測試少數網站就結束檢查。
這些大寫詞是規則中的處理策略:PROXY 交由代理路徑處理,DIRECT 直接連線,REJECT 拒絕請求。它們與 Global Routing 介面中的 Proxy、Direct 屬於不同層次。DIRECT 也不代表請求完全不經過用戶端處理,仍須配合目前設定理解解析與路由行為。
USER-AGENT 依可識別請求中的 User-Agent 資訊進行比對。並非所有連線都能看到這項資訊,也無法可靠取代應用程式識別;同一個 App 也可能產生多種請求。加密請求的可見範圍會受處理條件影響,不要假設新增這條規則就能識別所有 App 流量。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
SUBSCRIPTION & CONFIGURATION / 04
訂閱用於管理既有伺服器項目,設定則用於安排規則與相關行為。兩者可能同時使用,但匯入、更新與備份時應分別確認處理的對象。
Subscribe 透過使用者已有的訂閱網址,批次匯入或更新伺服器項目。更新可能變更名稱、參數或項目數量,不應假設本機手動修改會一直保留。訂閱網址可能包含存取憑據,請妥善保管;更新失敗時,先檢查網址是否完整及目前網路狀態。
SERVER 通常指伺服器位址欄位或相關項目識別資訊,可填寫網域名稱或 IP 位址。可用的伺服器項目還需要協定、連接埠與驗證等資訊,只有位址並不足以建立連線。顯示名稱只是方便辨識的標籤,不能據此判斷伺服器實際位置或連線品質。
Scan QR Code 用於讀取 QR Code 中編碼的匯入內容;QR Code 本身不是代理協定。辨識後請確認內容是單一伺服器參數、訂閱網址或其他文字,再決定是否儲存。含有密碼或訂閱憑據的 QR Code 不宜公開展示;匯入成功後仍須測試連線。
DNS 會將網域名稱解析為 IP 位址,是建立連線前的重要環節。解析請求使用的路徑與後續服務連線使用的路徑須分開理解;變更 DNS 不會自動修正所有分流問題。網域無法存取時,請區分是解析失敗、位址無法連線,還是伺服器驗證失敗。
URL Rewrite 依指定條件處理 URL 請求,與將請求分配至 PROXY 或 DIRECT 的路由規則不同。能否處理特定請求取決於規則、請求類型及相關條件。修改前請保留原設定,並在確實了解比對範圍後再啟用,以免影響正常請求。
延遲表示特定測試條件下的等待時間,不等於頻寬或持續下載速度。測試目標、網路壅塞與協定交握都會影響結果,因此不同測試方式的數值不適合直接比較。選擇項目時,應綜合考量穩定性、實際 App 使用狀況與多次測試結果,而非只看單次排序。
IPAD & APP STORE / 05
購買紀錄、App 安裝與設定資料屬於不同項目。在 iPad 上重新取得 App 後,仍須另外確認原有伺服器資訊與設定是否已還原。
Apple ID 是與 App Store 購買紀錄連結的帳號;查看已購紀錄時,請核對「媒體與購買項目」使用的帳號。該帳號與裝置上的 iCloud 登入狀態須分開檢查,不能只憑 iCloud 已登入就判定購買歸屬。商店地區也會影響 App 是否能搜尋及取得。
已購項目可用來尋找由原購買帳號取得的 App;使用同一購買帳號,可在 iPhone 和 iPad 上尋找 Shadowrocket 並重新下載。App 購買紀錄不等於伺服器資料備份,重新下載後請檢查設定是否仍在。若系統提示再次購買,請先核對帳號與 App 項目。
iCloud 同步取決於 App 實際支援的同步項目、帳號與系統開關,不代表所有本機設定都會自動複製。它與還原 App Store 購買紀錄不是同一個流程;還原 App 不代表設定已同步完成。更換裝置前請確認可同步的內容,並另外備份需要保留的設定。
需要核對 App 項目時,可查看Shadowrocket App Store 產品頁;帳號地區、已購項目還原與各平台取得方式,請參閱下載頁說明。
本頁是 Shadowrocket 官方手冊的術語索引。遇到實際連線問題時,建議記錄目前模式、選取的項目與錯誤訊息,再到故障排查逐項檢查;分享排查資料前,請先移除密碼、私鑰與完整訂閱網址。