Shadowrocket 官方手冊

Shadowrocket 術語表

依介面、協定與規則查找術語。先辨認術語所屬層級，再確認它影響的是連線對象、路由方式，還是設定內容。

介面用語與規則關鍵字保留英文原文。操作步驟以 iPhone / iPad 介面為例，其他平台的入口位置可能不同；完整步驟請見使用手冊。

介面與開關

這些名稱會出現在頁面、選單或連線設定中。名稱相似，不代表作用範圍相同。

Home: 查看伺服器清單、選擇連線對象並操作連線開關的主要頁面。選取項目只代表選定連線對象，不表示已建立連線；還須確認連線開關與狀態。匯入後先在此核對項目，再進行測試。

Global Routing: 決定用戶端如何處理連線的全域路由設定。包含 Config（設定）、Proxy（代理）、Direct（直連）三種模式，並非伺服器協定選擇器。排查流量是否依預期分流時，先確認此處的模式，再檢查個別規則。

Config / Proxy / Direct: Config 依目前設定檔比對規則；Proxy 將流量交由代理處理；Direct 直接連線至目標。這些首字母大寫的名稱是 Global Routing 介面選項，與規則中的全大寫 PROXY、DIRECT 不屬於同一層級。暫時切換模式後，記得恢復日常使用的設定。

On Demand: 依已設定的網路條件觸發連線，也就是隨選連線。此功能控制何時嘗試建立連線，不負責決定特定網域套用哪條規則。若手動關閉後連線又被觸發，請先檢查 On Demand 條件，再排查其他設定。

Connectivity Test: 依所選方式檢查伺服器連線狀態；結果會受測試目標、目前網路與伺服器狀態影響。測得的耗時不是下載頻寬，也無法保證所有網站都能存取。比較結果時請使用相同測試方式；若逾時，還須檢查位址、連接埠與驗證參數。

Data: 查看用戶端流量與連線記錄的入口，可用來觀察是否有請求，以及流量是否經過預期路徑。用戶端統計範圍可能與服務商帳戶帳單不同，不能據此推算訂閱剩餘用量。分享記錄前，請移除伺服器位址、個人網域與驗證資訊。

Settings: 管理用戶端常用選項的設定入口。部分行為也受目前 Config 設定檔控制，因此變更開關後，應一併確認是否有相關設定項目。排查問題時一次只修改一項並記下原值，避免多項變更疊加後難以判斷原因。

協定

協定名稱描述連線方式，不代表線路品質。請依使用者已有的伺服器資料填寫，不要只憑名稱猜測參數。

Shadowsocks: 使用伺服器位址、連接埠、加密方式與密碼等參數建立代理連線的協定。匯入後應確認加密方式與伺服器設定一致，不要只檢查密碼。部分項目還包含額外參數，請依原始資料保留；分享連結通常以 ss:// 開頭。

VMess: 以 UUID 等資訊識別使用者的代理協定，分享連結通常以 vmess:// 開頭。除了位址與連接埠，傳輸方式、路徑、Host 與 TLS 等設定也可能影響連線。即使 UUID 正確，傳輸參數不一致仍可能導致連線失敗。

VLESS: 採用 UUID 身分資訊的代理協定，分享連結通常以 vless:// 開頭。協定名稱不表示傳輸自動具備特定安全設定，仍須確認伺服器指定的傳輸與安全參數。不要直接套用其他項目的設定，即使兩者位址相同。

Trojan: 通常搭配 TLS 使用、以密碼驗證的代理協定，分享連結通常以 trojan:// 開頭。連線需要伺服器位址、連接埠、密碼及對應的 TLS 參數；伺服器名稱等資訊也須與原始資料一致。若出現憑證錯誤，請檢查網域名稱與裝置時間，不要直接略過驗證。

Hysteria2: 以 QUIC 為基礎的代理協定，連線需要目前網路支援 UDP。驗證資訊、伺服器名稱與其他附加參數都須符合伺服器端設定。某個網路環境下無法連線，不代表伺服器一定失效；應配合網路環境與實際測試結果排查。

WireGuard: 使用金鑰組與 Peer 資訊建立加密通道的協定。設定通常包含私密金鑰、公開金鑰、端點與位址範圍，各欄位用途不同，不可互換。私密金鑰屬於敏感資訊，不應出現在公開截圖、記錄或求助內容中。

HTTP / SOCKS5: 兩種常見的代理協定，通常使用伺服器位址與連接埠，部分伺服器也要求使用者名稱和密碼。驗證方式、傳輸加密與 UDP 支援情形須依伺服器能力確認，不能把協定名稱當成加密保證。選擇項目類型時，應與使用者已有的伺服器說明一致。

規則關鍵字

先撰寫比對條件，再指定處理策略。閱讀規則時也要確認順序；通常較早符合的規則會先決定結果。

Rule: 將連線目標與處理策略相互對應的一條規則。常見格式為「類型、比對內容、策略」，例如 DOMAIN,example.com,DIRECT。Global Routing 設為 Config 時，會依目前設定中的規則順序比對；有設定規則不代表每次連線都會符合該規則。

DOMAIN: 精確比對指定網域，例如 DOMAIN,example.com,DIRECT。此規則不會自動涵蓋 www.example.com 等子網域。若要涵蓋整個網域及其子網域，請參考 DOMAIN-SUFFIX，不要反覆新增不完整的精確規則。

DOMAIN-SUFFIX: 比對指定網域及其子網域，例如 DOMAIN-SUFFIX,example.com,PROXY。可涵蓋 example.com 與 www.example.com，但不是比對任意包含該字串的內容。新增後也要檢查前面是否已有更早符合的規則。

DOMAIN-KEYWORD: 比對網域中包含的指定關鍵字，例如 DOMAIN-KEYWORD,example,PROXY。比對範圍通常比指定網域後綴更廣，可能涵蓋原本不打算處理的網域。若只針對單一網站及其子網域，請先確認是否應使用更明確的比對條件。

GEOIP: 依 IP 地理資料庫中的國家或地區歸屬比對目標，例如 GEOIP,CN,DIRECT。判斷依據是 IP 資料庫中的歸屬，不是頁面所用文字、網域後綴或使用者所在地。解析結果、資料庫內容與規則順序都可能影響最終比對結果。

IP-CIDR / IP-CIDR6: 分別用來比對 IPv4 與 IPv6 位址範圍；斜線後的數字代表前綴長度。例如 IP-CIDR,192.0.2.0/24,DIRECT 指定一段 IPv4 位址範圍。網域解析成不同位址後，可能符合不同規則，因此應配合 DNS 結果理解位址範圍規則。

FINAL: 前面的規則都未符合時採用的最終規則，例如 FINAL,PROXY。通常放在規則清單末尾，用來指定其餘連線的處理方式。FINAL 不是指定網域的規則；若大量請求都套用此規則，請回頭檢查前面的條件是否涵蓋實際目標。

PROXY / DIRECT / REJECT: 規則中的處理策略：PROXY 交由代理處理，DIRECT 直接連線，REJECT 拒絕連線。這些策略位於規則的策略欄位，不用來描述伺服器採用的協定。全大寫的 DIRECT 只影響符合該規則的連線，與將 Global Routing 切換為 Direct 不同。

訂閱與設定

請區分伺服器清單、規則檔案與同步資料。匯入前，應先備妥自己的訂閱或伺服器資訊。

Server / Add Server: Server 指由協定、位址、連接埠與驗證等參數組成的伺服器項目；Add Server 是手動新增項目的入口。中文說明中的「節點」通常指這類項目，不是購買 App 時附帶的服務。新增後先核對欄位並測試連線，再選取該項目進行連線。

Config: 在設定檔的語境中，Config 包含規則、DNS 等設定，不等同於伺服器訂閱清單。在 Global Routing 的語境中，同名的 Config 則代表依設定檔分流的模式。匯入檔案後還須確認是否已選用；只有檔案存在但未啟用，不代表其中規則正在生效。

DNS: 將網域名稱解析為 IP 位址的機制，解析結果可能參與後續 IP 類規則比對。若能連上伺服器但部分網域無法開啟，DNS 是應檢查的項目之一。修改解析設定時請保留原值，分別測試網域解析與目標連線，避免把所有問題都歸因於伺服器。

Scan QR Code: 透過 QR Code 讀取伺服器或訂閱資訊的匯入入口；使用相機掃描時須授予相應權限。QR Code 只是資訊載體，不保證內容完整、有效或適用於目前的用戶端。匯入前請確認來源，匯入後核對項目類型；含有憑證的 QR Code 不應公開轉傳。

URL Rewrite: 依比對條件改寫請求網址或執行指定處理的功能，不等同於決定直連或代理的一般路由規則。修改 HTTPS 請求內容可能還需要額外設定與授權，並非新增一條 Rewrite 就會生效。請先了解規則來源、比對範圍與影響再使用，並保留可還原的原始設定。

iCloud 同步: 透過 iCloud 在適用裝置間同步 App 支援的資料，不等同於向服務商更新訂閱。可同步的內容以 App 實際提供的選項為準，也會受帳戶、系統權限與網路狀態影響。請勿將同步視為完整備份；更換裝置前，另行保存必要的設定資料並妥善保管其中的憑證。

平台與安裝

Shadowrocket 支援 iPhone、iPad、Mac、Windows、Android 與 Linux。取得安裝檔與授予系統權限是兩個不同步驟。

App Store／已購項目: App Store 是 iPhone / iPad 的取得管道，「已購項目」可查看對應帳戶的購買記錄。請核對產品頁上的開發者 Shadow Launch Technology Limited、官方圖示與 App ID 932747118。更換裝置或重新安裝時，請先確認使用原購買帳戶，再查找已購記錄；購買記錄與 App 內的伺服器資料是不同的資料。

Apple 晶片／Intel: Mac 安裝檔分為兩種處理器版本，可先在「關於這台 Mac」查看晶片或處理器資訊，再選擇對應的 dmg。首次開啟若提示無法驗證開發者，請先確認安裝檔來自本站，再到「隱私權與安全性」查看「仍要打開」。若提示檔案已損毀，請先重新下載；仍有問題時，依安裝放行說明檢查，不要將系統封鎖誤認為連線故障。

SmartScreen／允許安裝未知的應用程式: 前者是 Windows 的風險提示機制，後者是 Android 針對安裝來源的授權選項。確認使用本站安裝檔後，若 Windows 提示中提供相應選項，可選擇「更多資訊 → 仍要執行」；Android 則依系統提示，為目前來源開啟「允許安裝未知的應用程式」。這些操作只處理安裝權限，無法修復伺服器、訂閱或 DNS 設定；詳細步驟請見安裝放行說明。

deb / rpm / AppImage: Linux 常見的軟體發行格式。deb 通常用於 Debian 系發行版；rpm 通常用於 Fedora 等採用相應套件管理方式的發行版。AppImage 通常須先授予執行權限再執行，能否使用仍取決於系統環境與相依套件。請依發行版選擇格式，不要以更換格式作為解決所有啟動錯誤的方法；命令與權限步驟請見Linux 安裝說明。

VPN 設定: 系統授予用戶端處理網路流量所需的設定與權限；首次連線時可能會要求使用者確認。這不是伺服器帳戶或訂閱網址，也不表示系統已確認遠端服務可用。若不慎刪除相關設定，可返回 Shadowrocket 發起連線，並依系統提示重新授權；完成授權後仍須另外確認連線狀態。