OFFICIAL MANUAL / GLOSSARY
Shadowrocket 術語速查
依設定所在位置理解含義,再核對具體參數。本頁是 Shadowrocket 官方手冊的術語索引,保留介面用語、協定名稱與規則關鍵字的英文原文,協助釐清「選擇什麼」、「比對什麼」與「如何處理」。
以下匯入說明均以使用者已有自己的訂閱或伺服器資訊為前提。術語解說不能取代完整操作步驟;初次設定可搭配使用教學閱讀。
01 / INTERFACE
介面與開關
先確認目前設定所在位置。同一個英文詞出現在不同入口時,可能分別代表頁面、選項或規則策略。
- Global Routing
- 用來選擇整體路由方式,共有三種模式:設定、代理、直連,對應介面用語 Config、Proxy、Direct。選擇 Config 時,連線會依目前設定中的規則決定去向;選擇其他模式時,就不能只根據規則清單推斷結果。排查分流問題前,請先確認此處設定,避免整體路由方式不符時仍反覆修改規則。
- Config
- 在設定管理頁面中,Config 指的是設定檔及其管理操作;在 Global Routing 中,Config 則代表依設定規則處理連線。開啟設定頁面查看某個檔案,不代表已將它設為目前使用的設定檔。修改前請確認目前檔案與啟用狀態,並保留可還原的副本。
- Proxy / Direct
- 這是 Global Routing 中的兩個選項,分別代表代理與直連,用來選擇整體連線的處理方式。兩者與規則文字中的大寫 PROXY、DIRECT 屬於不同層級,不能只因名稱相似就認定效果完全相同。Proxy 仍須有有效的伺服器參數,Direct 也會受到目前網路可連線狀況影響。
- On Demand
- 指系統依據已設定的條件,按需觸發連線的機制,可依網路環境或網域條件設定。此功能處理的是何時觸發連線,無法修正錯誤的密碼、憑證或伺服器位址。建議先確認手動連線正常,再逐一新增觸發條件;若要保持中斷連線,也請檢查是否仍有條件會觸發重新連線。
- Add Server
- 用來新增伺服器資料,須依現有資訊選擇協定並填入相應參數。位址與連接埠相同,不代表不同協定的驗證、TLS 或傳輸參數可以共用。儲存前請逐項核對,儲存後再確認實際選用的資料,避免測試到另一筆名稱相同的設定。
- Connectivity Test
- 用來查看指定測試條件下的連線結果,結果與測試目標、測試方式及當時的網路狀態有關。某次測試成功,只能表示該次檢測涉及的路徑完成了相應操作,不代表所有網站與 App 都能正常使用。排查問題時,應一併查看測試結果、實際請求、規則比對結果與 DNS 狀況。
- DNS
- 負責將網域名稱解析為網路位址,是建立許多連線前的其中一個環節。解析失敗、解析結果不適用與代理交握失敗是不同問題,表面上卻都可能呈現無法存取。修改 DNS 設定前請先記下原值,並釐清網域解析的路徑,以及解析後連線所採用的路由策略。
02 / PROTOCOLS
協定名稱與參數範圍
協定類型應符合現有伺服器資訊。只替換類型名稱無法完成協定轉換,也不能據此判斷實際連線表現。
- Shadowsocks
- 一種代理協定,連線時客戶端與伺服器必須使用相同的加密方式與密碼。若現有資訊包含外掛或其他擴充參數,也應依原始說明核對,不能只填寫基本欄位。若驗證失敗,請優先檢查參數是否完整、複製時是否帶入多餘空格,而非直接修改規則。
- VMess
- 一種代理協定,通常須核對 UUID 等識別資訊,以及傳輸方式、路徑與 TLS 相關參數。伺服器位址正確只是必要條件之一,傳輸層設定不一致也會導致交握失敗。匯入後請對照現有的原始資訊檢查,尤其留意未顯示在資料名稱中的欄位。
- VLESS
- 一種代理協定,身分驗證、傳輸方式與安全層參數都須符合伺服器要求。協定名稱本身不代表已啟用特定加密或安全設定,也不能取代對 TLS、伺服器名稱等欄位的檢查。排查 Shadowrocket VLESS 連線時,請先核對完整參數,再檢查規則與目標是否可連線。
- Trojan
- 通常搭配 TLS 使用的代理協定,密碼、伺服器名稱與憑證驗證設定都會影響連線。連線位址與 TLS 驗證用的伺服器名稱可能各有不同用途,不要因為兩個欄位不同就任意改成相同內容。若遇到憑證錯誤,應核對名稱、憑證有效性與裝置時間,不要直接關閉驗證。
- Hysteria2
- 以 QUIC 為基礎的代理協定,使用 UDP 傳輸,並具備相應的壅塞控制機制。實際網路表現仍受封包遺失、延遲、伺服器資源及參數影響,協定名稱並不保證速度。若目前網路限制 UDP 通訊,可能會連線失敗;檢查時須一併核對驗證與 TLS 相關設定。
- WireGuard
- 以金鑰進行身分驗證的通道協定,設定通常包含本端金鑰、通道位址、對端公鑰與路由範圍。金鑰彼此對應,不可互換公鑰與私鑰,也不應向他人展示私鑰。排查 Shadowrocket WireGuard 設定時,須一併核對端點資訊、位址範圍與 DNS,不能只確認是否儲存成功。
- HTTP / SOCKS5
- 兩種代理協定類型,連線前請確認伺服器實際支援哪一種,以及是否需要使用者名稱與密碼。類型名稱不代表傳輸已加密,驗證方式與安全層仍須依實際設定判斷。請勿混淆遠端代理伺服器的連接埠與本機 App 使用的服務連接埠。
03 / RULES & POLICIES
規則關鍵字與策略
關鍵字描述比對條件,策略則說明符合後的處理方式。以下範例僅用來解釋語法,example.com 是示例網域,並非服務位址。
- 規則
- 將比對條件與處理策略連結的設定項目,通常依序由上而下檢查,符合第一條後便執行相應策略。範圍較大的規則若排在前面,後方較精確的規則可能無法生效。編輯後須一併確認順序、策略名稱與目前的 Global Routing,不能只檢查單條語法是否正確。
- DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
- DOMAIN 比對完整網域名稱,DOMAIN-SUFFIX 比對指定網域及其子網域,DOMAIN-KEYWORD 比對網域中包含的關鍵字。例如
DOMAIN-SUFFIX,example.com,PROXY會將符合項目交由 PROXY 處理。關鍵字比對的範圍通常比精確網域更廣,新增前請考慮是否會涵蓋其他不相關網域。
- IP-CIDR / IP-CIDR6
- 分別用來比對 IPv4 與 IPv6 位址範圍,斜線後的前綴長度決定網段大小。例如
IP-CIDR,192.168.0.0/16,DIRECT表示該 IPv4 範圍採用 DIRECT。部分比對過程會涉及網域解析;排查時請區分目標原本就是 IP,還是透過 DNS 取得 IP 後再進行判斷。
- GEOIP
- 依據 IP 地理資料庫中的分類結果比對,不是根據網頁語言、網域後綴或帳號地區判斷。資料庫紀錄與實際服務部署可能不一致,同一項服務也可能使用多個地區的位址。若比對結果不如預期,請核對實際目標 IP、資料庫分類及前序規則,不要只憑網站名稱判斷。
- FINAL
- 用來處理未符合前序規則的連線,是規則清單最後的預設規則,應放在末尾。例如
FINAL,DIRECT表示前面都未符合時採用 DIRECT,不代表所有連線都會直連。若大量連線套用 FINAL,請先檢查前面的條件是否涵蓋目標,再決定是否調整預設策略。
- PROXY / DIRECT / REJECT
- 這些是規則中的處理策略:PROXY 交由代理處理,DIRECT 直接連線,REJECT 拒絕連線。PROXY 實際使用的出口取決於目前選擇與相關設定,並非伺服器位址。符合 REJECT 後產生的失敗是規則處理結果;排查連線問題時,請先檢查是否符合拒絕規則。
04 / SUBSCRIPTION & CONFIGURATION
訂閱與設定檔
先確認手上的內容是訂閱網址、單筆伺服器資訊還是完整設定檔,再選擇匯入位置。本網站不提供、不銷售,也不推薦節點或訂閱。
- 訂閱 / Subscribe
- 訂閱通常透過使用者現有的網址取得伺服器資料,更新時會重新讀取內容;Subscribe 是相關介面用語。這與在 App Store 購買 App 不同,也不保證其中每筆資料都能一直使用。訂閱網址可能包含存取憑證,請妥善保管為敏感資訊,排查問題的截圖中不要顯示完整網址。
- 伺服器資料
- 描述連線端點的一組參數,常見內容包括協定、伺服器位址、連接埠及驗證資訊,也可能包含傳輸與 TLS 設定。資料名稱只是方便辨識的標籤,重新命名不會改變實際連線參數。兩筆同名資料也可能指向不同端點,核對時應查看具體欄位,而非只比較名稱。
- 設定檔
- 用來組織一般設定、規則及其他設定區段,常見區段包括
[General]與[Rule]。伺服器訂閱與設定檔用途不同,更新訂閱不代表所有分流邏輯也已替換。匯入新設定檔前請保留原檔,並確認最後實際使用的是哪一份。
- 延遲
- 表示指定測試方式下的回應時間,會受測試目標、協定流程及當時網路狀況影響。Shadowrocket 的延遲測試數值不能直接換算成下載速度,也無法單獨反映網頁、影片或其他服務的使用體驗。比較前請保持測試條件一致,並另行確認實際服務請求是否成功。
- URL Rewrite
- 依比對條件改寫請求 URL 等內容,與決定連線走向的路由規則並非同一項功能。規則未符合、請求不在可處理範圍內,或加密內容無法讀取,都可能導致預期的改寫未發生。使用前請確認改寫目的與適用範圍;涉及加密請求時,也須了解相關憑證與隱私界線。
05 / APP STORE & ACCOUNT
App Store 與帳號
Shadowrocket 僅在 Apple 平台發行,以 iPhone 與 iPad 為主,唯一取得管道為 App Store。相容性、系統需求及是否支援通用購買,請以 App Store 頁面標示為準。
- App Store 正版確認
- 請在產品頁一併核對開發者 Shadow Launch Technology Limited、官方圖示與 App ID 932747118,不要只看搜尋結果中的名稱。可從產品頁網址中的
id932747118辨認 App ID,圖示也應與本站使用的官方圖示相同。取得步驟與確認位置請參閱下載指南。
- Apple ID 商店地區
- 指「媒體與購買項目」帳號所屬的商店地區,會影響 App 是否顯示、可用付款方式與當地貨幣。裝置語言、目前所在位置與商店地區是不同設定。搜尋不到 App 時,請先確認目前使用的購買帳號與商店地區;更改地區也受 Apple 的帳號條件限制,不能只根據語言切換判斷結果。
- 已購項目
- 指 App Store 中與購買帳號連結的 App 紀錄,換機或重新安裝時可在相應的 App 清單中查找。請先確認「媒體與購買項目」使用的是購買時的帳號;具體入口名稱可能因系統介面而異。重新下載 App 與還原本機訂閱、設定檔是不同事項,後者須另外確認備份。
- 一次買斷
- 說明 App 的購買方式,美國商店價格約為 2.99 美元;各地價格與當地貨幣請以 App Store 頁面目前顯示為準。客戶端一次買斷 ≠ 連線方案,購買 App 不會自動提供伺服器或訂閱。使用者仍須備妥自己的連線資訊,App 購買與相關服務費用分開計算。
- 家人共享
- Apple 提供的家庭購買共享機制,能否使用取決於產品頁標示、家庭設定與帳號條件。這與在另一部裝置上使用自己的購買紀錄不同,也不會自動共享 Shadowrocket 內的訂閱與設定。若無法取得,請確認家庭購買共享設定及商店適用條件,不能只因已加入家庭就認定可以使用。