官方手冊 · 術語查詢
Shadowrocket 術語手冊
依介面用語、協定及規則關鍵字查閱詞義。先釐清連線對象、路由模式與處理動作,再調整個別設定。
本頁保留應用程式中的英文原文,每個術語都可透過標題旁的連結直接定位。介面入口與可用選項可能因平台而異,操作時請以目前應用程式顯示為準;需要連續操作步驟,請參閱入門教學;需要設定說明,請參閱設定手冊。
Shadowrocket 支援 iPhone / iPad / Mac(Apple 晶片與 Intel)/ Windows / Android / Linux。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。各平台取得方式請參閱全平台下載說明。
01 · 介面與開關
頁面入口與連線模式
頁面名稱代表操作位置,模式名稱則決定請求的處理方式,兩者不可混為一談。
- Home #
- Home 是查看伺服器項目、選擇連線對象及操作連線開關的主要頁面。選取項目不代表已建立連線,還須確認連線開關與系統授權狀態。排查時先確認此處實際選取的項目,再檢查規則,避免將選錯伺服器誤判為設定問題。
- Global Routing #
- Global Routing 用來選擇整體路由模式,不是選擇特定伺服器。設定、代理、直連分別對應介面中的 Config、Proxy、Direct。規則檔看似未生效時,應先確認是否處於 Config 模式,再檢查是否已選用該檔案。
- Config / Proxy / Direct #
- Config 依目前設定中的規則決定如何處理請求;Proxy 採用代理模式;Direct 採用直連模式。這些是整體模式,與規則列中的大寫動作關鍵字並非同一層級。暫時切換模式有助於縮小排查範圍;測試結束後,請恢復原本需要的模式。
- On Demand #
- On Demand 會依網路環境等條件觸發連線行為,適用於需要依條件連線或中斷連線的情境。它控制連線何時發生,不會取代網域或 IP 規則來決定請求的路由。若連線自動恢復,先檢查是否符合 On Demand 條件,不要只是不斷操作主開關。
- Add Server #
- Add Server 是手動新增伺服器項目的入口。請依使用者已有的伺服器資訊選擇協定,並逐一填寫位址、連接埠及驗證欄位,不要只憑欄位外觀猜測類型。儲存成功只代表項目已記錄,參數是否相符仍須透過實際連線確認。
- Settings #
- Settings 是查看及調整用戶端設定的頁面。設定項目可能影響測試、記錄、同步或連線行為,但並非所有項目都適用於每個平台。修改前先記下原值,每次只調整與目前問題相關的一項,方便判斷效果並還原設定。
02 · 協定
連線格式與驗證方式
協定名稱不代表速度等級。用戶端類型、驗證資訊、傳輸設定與伺服器端必須相符。
- Shadowsocks #
- Shadowsocks 是一種代理協定,連線通常需要伺服器位址、連接埠、密碼及加密方式。即使密碼正確,只要加密方式不一致,也可能連線失敗。手動輸入時請逐項核對原始資訊,不要將其他協定的使用者識別碼直接當成此處的密碼。
- VMess #
- VMess 使用使用者識別碼等參數進行驗證,完整連線設定也可能包含傳輸方式與安全性選項。匯入後請確認位址、連接埠、使用者識別碼及相關傳輸欄位,不要只看項目名稱。驗證失敗時也應檢查裝置時間,避免時間偏差影響判斷。
- VLESS #
- VLESS 是使用使用者識別碼的代理協定;協定名稱本身不代表已啟用傳輸加密。實際連線的安全性與相容性,還取決於搭配的傳輸及安全層設定。不要因為同樣使用使用者識別碼,就直接將 VMess 與 VLESS 項目的類型互換。
- Trojan #
- Trojan 通常搭配 TLS 使用,須使用正確密碼及符合伺服器設定的安全選項。伺服器名稱與憑證驗證會影響連線;填入伺服器 IP 不代表可以忽略名稱欄位。遇到憑證錯誤時,應先核對網域名稱、裝置時間及伺服器設定,不要直接關閉驗證。
- Hysteria2 #
- Hysteria2 是以 QUIC 為基礎的代理協定,運作仰賴相應的 UDP 通訊條件。所在網路的 UDP 可連通性、驗證欄位及伺服器設定都會影響連線。一般網頁能開啟,並不能證明此協定所需的通訊路徑也正常。
- WireGuard #
- WireGuard 使用公私鑰與對端設定建立加密通道。設定時須區分本機私鑰、對端公鑰、端點及位址範圍,不可對調公鑰與私鑰欄位。私鑰屬於敏感資訊,提交故障截圖或分享設定前請先移除。
- HTTP / SOCKS5 #
- HTTP 與 SOCKS5 是常見的代理協定類型,請依伺服器實際支援的方式填寫。連接埠相同不代表協定相容,是否需要驗證也由伺服器決定。SOCKS5 這個名稱本身不代表傳輸已加密,選用時應了解所用服務的實際連線方式。
03 · 規則關鍵字
比對條件與處理動作
先確認比對對象,再查看符合條件後的動作,最後檢查規則順序。
- 規則 #
- 規則通常由比對類型、比對內容與處理動作組成,用來決定如何處理特定請求。規則清單通常依序判斷,若前面的條件已符合,後續規則可能不再參與判斷。新增規則後請檢查所在位置,並確認 Global Routing 使用 Config。
- DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD #
- DOMAIN 用於精確網域比對,DOMAIN-SUFFIX 用於網域後綴比對,DOMAIN-KEYWORD 用於網域關鍵字比對。例如
DOMAIN-SUFFIX,example.com,PROXY表示符合後綴條件後交由代理處理。關鍵字比對範圍可能較廣,不宜用過短的詞取代明確網域。
- GEOIP #
- GEOIP 依 IP 位址資料庫中的地區歸屬進行比對,例如
GEOIP,CN,DIRECT。它不依網頁內容、網域後綴或訪客所在地判斷。解析結果、位址資料庫及服務使用的分散式基礎架構,都可能影響比對結果。
- IP-CIDR / IP-CIDR6 #
- IP-CIDR 比對 IPv4 網段,IP-CIDR6 比對 IPv6 網段,斜線後的前綴長度決定範圍。網段規則比對的是位址,不是網域文字;目標位址變更時,比對結果也可能不同。若只要處理單一位址,請確認前綴未意外涵蓋更大的範圍。
- FINAL #
- FINAL 是前面的規則都未符合時採用的預設規則,例如
FINAL,PROXY。通常應放在規則清單末尾,否則可能提前接手原本應繼續比對的請求。預設動作應符合實際需求;不要靠不斷新增更後面的規則來修正前面的預設規則。
- PROXY / DIRECT / REJECT #
- PROXY 表示交由代理處理,DIRECT 表示直接連線,REJECT 表示拒絕請求。這些是規則中的處理動作,不是協定名稱,也不是伺服器位址。閱讀規則時請保留這些大寫寫法,並與 Global Routing 中的 Proxy、Direct 模式區分。
- USER-AGENT #
- USER-AGENT 依可讀取的 HTTP User-Agent 欄位比對請求,不能直接視為依應用程式名稱分流。在加密連線中,該欄位不一定能讀取,因此有設定規則不代表所有請求都會符合。排查時先確認請求條件及欄位是否可見,不要只調整關鍵字。
04 · 訂閱與設定
連線資訊、檔案與復原
伺服器訂閱、規則設定與商店購買紀錄分別管理不同內容,不能互相取代。
- Subscribe #
- Subscribe 用來透過使用者已有的訂閱網址匯入或更新伺服器項目。更新訂閱可能變更項目內容,因此請先區分由訂閱管理的紀錄與自行新增的紀錄。訂閱網址可能含有存取憑證,不應放入公開截圖、記錄或分享文字。
- 伺服器項目 #
- 伺服器項目儲存位址、連接埠、協定及驗證等連線參數,常被稱為節點。項目名稱只是方便識別的標籤,無法據此判斷實際位置、可用性或效能。若名稱重複,請核對參數及所屬訂閱,避免誤刪正在使用的紀錄。
- Config 設定檔 #
- Config 設定檔可儲存規則、DNS 或策略等設定,與提供伺服器項目的訂閱並非同一概念。檔案已下載不代表已選用,修改檔案也不代表目前模式一定會依它處理。Config 同時出現在頁面名稱與路由模式中,閱讀操作步驟時應依所在位置判斷意思。
- Scan QR Code #
- Scan QR Code 是透過 QR Code 讀取可辨識連線資訊的入口;QR Code 可能包含單筆伺服器資訊或訂閱網址。掃描後請確認辨識出的類型及重要欄位,再決定是否儲存。QR Code 只是編碼形式,不代表內容可信;含有驗證資訊的 QR Code 也不應公開。
- iCloud 同步 #
- iCloud 同步會在符合相關帳號及系統權限條件時,同步應用程式支援的資料;實際範圍請以應用程式說明為準。開啟開關不代表所有內容都已上傳完成,換機前請在目標裝置確認復原結果。同步與獨立匯出備份用途不同,重要設定宜保留可供復原的副本。
- 已購項目 #
- 已購項目可透過原購買帳號查詢應用程式購買紀錄並重新下載,不能用來復原伺服器資訊或規則檔。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。商店應用程式 ID 為
932747118,開發者為 Shadow Launch Technology Limited;系統需求請以 App Store 頁面標示為準。
05 · 設定與診斷
解析、測試與執行紀錄
診斷結果只反映特定條件,須結合目標請求、目前模式與網路環境綜合判斷。
- DNS #
- DNS 將網域名稱解析為 IP 位址,解析結果會影響後續連線及部分規則判斷。若能連線至伺服器,但某個網域無法開啟,可分別檢查解析是否成功,以及請求最終採用的路徑。隨意疊加多個解析設定會增加排查難度,應先確認目前設定實際使用哪一項。
- Connectivity Test / 延遲 #
- Connectivity Test 用來觀察特定測試條件下的回應狀況,延遲則是該過程的耗時指標。延遲較低不代表下載速度一定較快,測試成功也不代表所有目標請求都能成功。比較結果時,應盡量保持網路、測試方式及目標一致,並以實際請求進一步確認。
- Log #
- Log 是協助找出連線、解析或請求處理問題的執行紀錄。排查時記下重現時間、目標網域及目前模式,再對照相關紀錄,會比單獨截取一則錯誤更有效。分享前請移除訂閱網址、驗證欄位及不必要的個人瀏覽紀錄。
- URL Rewrite #
- URL Rewrite 依比對規則修改可處理的請求網址或相關行為,與選擇代理或直連並非同一功能。是否生效取決於請求是否可處理、比對運算式及相關設定條件。修改運算式前,請先確認目標範圍,避免連正常請求也一併改寫。
- Proxy 連接埠 #
- Proxy 連接埠是本機代理服務接收連線的監聽連接埠,與遠端伺服器項目中的連接埠不同。其他程式使用時,須填入相應的監聽位址、連接埠及協定類型。開放給其他裝置存取會擴大可存取範圍,啟用前請確認監聽設定、網路信任範圍及存取控制。
- Data #
- Data 用來查看應用程式紀錄的資料流量資訊,統計範圍與週期應依目前介面理解。應用程式端的紀錄方式可能與服務商的用量計算不同,不能直接視為帳戶剩餘額度。若發現用量異常,應一併檢視統計時間、連線紀錄及實際使用情況。
從術語返回操作步驟
匯入與首次連線請參閱教學;DNS、On Demand 與診斷選項請參閱設定手冊;常見問題請參閱問答集。如需確認 iPhone / iPad 商店資訊,可前往 Shadowrocket App Store 產品頁面。
返回術語分類 ↑