Home
Home 是查看伺服器與訂閱項目、選取目前伺服器及操作連線的主要入口。選取某個項目只代表指定可用的代理對象,哪些請求會使用它仍由 Global Routing 與設定決定。排查時先確認清單中的選取項目,再檢查連線狀態,避免將「已有項目」誤認為「已連線」。
官方手冊 · 名稱與用途
先區分介面入口、連線協定、比對條件與處理策略,再查閱具體參數。本頁保留 Home、Config、Global Routing 等英文原文;同一名稱出現在不同位置時,請依所在層級理解,勿將伺服器清單、設定檔與系統連線狀態混為一談。
適用於 iPhone/iPad/Mac(Apple 晶片與 Intel)/Windows/Android/Linux 版 Shadowrocket 的概念查閱。各平台的入口位置可能不同,操作路徑請以目前的應用程式介面為準。
使用前須備有自己的訂閱或伺服器資料。本網站不提供、販售或推薦節點或訂閱;用戶端一次買斷 ≠ 線路方案。取得方式:iPhone/iPad 版於 App Store 一次性付費 $2.99;Mac/Windows/Android/Linux 版免費,詳情請見全平台下載。
這類名稱說明「在哪裡操作」及「目前採用哪種處理方式」。開關已開啟、伺服器已選取、規則已生效是三種不同狀態,須分別確認。
Home 是查看伺服器與訂閱項目、選取目前伺服器及操作連線的主要入口。選取某個項目只代表指定可用的代理對象,哪些請求會使用它仍由 Global Routing 與設定決定。排查時先確認清單中的選取項目,再檢查連線狀態,避免將「已有項目」誤認為「已連線」。
Add Server 用於手動輸入現有伺服器資料,先選擇協定,再填寫相應欄位。位址和連接埠相同,不代表不同協定可以共用其他參數;驗證方式、傳輸方式與 TLS 設定仍須逐項對應。資料不完整時,應向原服務提供者確認,不要根據欄位名稱猜測。
Global Routing 決定整體流量處理模式:依設定處理對應 Config,代理對應 Proxy,直連對應 Direct。Config 依目前設定中的規則處理請求;Proxy 與 Direct 則讓整體流量走代理或直連路徑。檢查特定網域規則時,應先確認目前模式為 Config,否則規則檔案的修改可能不會影響目前請求路徑。
Proxy 與 Direct 是 Global Routing 中的介面選項,不是伺服器協定名稱。前者讓整體流量走代理路徑,後者則走直連路徑;這些選項有助於縮小故障範圍,但切換後的連線結果仍會受 DNS、目標服務與網路條件影響。規則檔案中的大寫 PROXY、DIRECT 是策略關鍵字,請參閱策略說明。
On Demand 依設定條件觸發連線行為,處理的是何時建立或恢復連線的問題。它不會判斷每個網域要走哪條路徑,因此不能取代規則分流。手動關閉後又重新連線時,應檢查 On Demand 條件及系統中的相關設定,而非只刪除 Home 中的伺服器項目。
Connectivity Test 依目前選用的測試方式與目標檢查回應情況,結果只反映這次測試。某部伺服器測試成功,不代表所有網站、UDP 請求或應用程式服務都可使用。測試失敗時,先核對測試目標、協定參數與目前網路,再搭配 Log 判斷問題發生在哪一層。
協定描述用戶端與伺服器如何交換資料,並非速度等級。輸入資料時以使用者現有資料為準;協定、驗證、傳輸與安全層參數須一併核對。
Shadowsocks 使用雙方約定的加密方式、密碼等參數建立代理連線。伺服器位址、連接埠、加密方式與密碼都須一致,只核對密碼無法排除設定錯誤。若資料包含額外參數,也應依原始說明填寫,不要直接套用其他項目的設定。
VMess 使用使用者身分參數進行驗證,並可搭配不同傳輸方式運作。除了 UUID,也應核對實際提供的傳輸方式、Host、Path 與 TLS 等參數。裝置時間明顯不準也可能影響驗證;發生握手或驗證錯誤時,可一併檢查系統時間。
VLESS 將身分識別與傳輸、安全層設定分開,UUID 只是連線資料的一部分。伺服器要求的傳輸參數與安全參數,必須與用戶端設定相符;不能因協定名稱相近就認為可以互換。匯入後若連線失敗,應先逐項比對原始資料,不要任意關閉安全檢查。
Trojan 通常搭配 TLS 使用,並以密碼完成驗證。連線位址、憑證對應的網域名稱及 TLS 相關參數可能各有用途,不能因位址可解析就省略其他檢查。憑證錯誤應從網域名稱、裝置時間與伺服器憑證狀態著手排查,不應將略過驗證當作一般處理方式。
Hysteria2 是以 QUIC 為基礎的代理協定,運作時須有相應的 UDP 通訊路徑。位址與驗證參數正確但仍無法連線時,須確認目前網路是否允許相關 UDP 流量。頻寬等可調參數應依實際網路與伺服器說明設定,填入更高數值不代表可用頻寬會增加。
WireGuard 使用公私鑰與對端參數建立通道;PrivateKey 應妥善保密,PublicKey 用於識別相應對端。AllowedIPs 涉及路由範圍,MTU 會影響封包大小,兩者都不是驗證密碼。部分請求卡住時,除了檢查握手,也須核對位址、路由範圍與 MTU。
HTTP 與 SOCKS5 是兩種代理協定,都可能需要位址、連接埠與驗證資訊。協定名稱本身無法證明傳輸已加密,UDP 支援範圍也須依實際實作與設定確認。將其作為代理入口時,也應限制存取範圍,避免讓不需要使用的裝置連到可用連接埠。
理解一條規則時,須同時看懂比對條件與末尾策略。以下範例僅示範語法;example.com 是示範網域,不是伺服器或訂閱網址。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
規則將請求的比對條件與處理策略連結起來,通常依設定順序檢查,採用第一條符合的項目。較具體的條件通常應排在較寬泛的條件之前,否則後面的細項規則可能無法命中。排查時應確認目前使用的檔案、規則順序與實際命中記錄,而非只搜尋檔案中是否有某個網域。
DOMAIN 比對完整網域名稱,DOMAIN-SUFFIX 比對指定網域及其子網域,DOMAIN-KEYWORD 則比對網域名稱中包含的關鍵字。例如 DOMAIN-SUFFIX,example.com,PROXY 可涵蓋 example.com 及其子網域。關鍵字比對範圍較廣,使用前應考量是否會一併比對到其他無關網域。
GEOIP 依 IP 地理位置資料庫中的地區標記比對目標位址,不依頁面顯示的語種或使用者所在地判斷。資料庫紀錄、DNS 解析結果及服務的位址分布都可能影響比對結果。同一網域使用多個位址時,若不同請求的結果不一致,須依實際解析出的位址檢查。
IP-CIDR 用於比對 IPv4 網段,IP-CIDR6 用於比對 IPv6 網段;斜線後的前綴長度決定範圍大小。前綴越短,通常涵蓋範圍越大,因此網段設錯可能影響大量請求。網域同時回傳 IPv4 與 IPv6 位址時,只檢查其中一類規則,無法說明所有連線情況。
USER-AGENT 依可見請求中的 User-Agent 欄位比對,並非通用的應用程式識別方式。加密請求中的相關欄位通常無法直接讀取,不能只憑這類規則推斷某個應用程式的所有流量都會命中。使用前應確認協定、欄位是否可見,以及實際比對記錄。
FINAL 為未符合前面規則的請求指定最終處理策略,通常放在規則清單末尾。FINAL,DIRECT 表示其餘請求走直連路徑,不代表前面已命中的請求也改走直連。修改最終策略可能影響大量未個別列出的目標,應先保留原始檔案以便還原。
PROXY、DIRECT、REJECT 是規則中的策略關鍵字,分別代表交由代理、直接連線與拒絕請求。它們不是網域比對條件,也不是三種伺服器協定。請求遭拒時,應先找出命中的 REJECT 規則;出口與預期不符時,則須核對命中的策略及其實際指向。
伺服器項目提供連線資料,訂閱用於成組更新,Config 則管理設定內容。成功匯入只代表資料已讀取,仍須確認連線及規則是否符合預期。
Subscribe 用於儲存並更新一組伺服器項目,連結來自使用者現有的服務資料。更新可能變更項目名稱、數量或參數,但不能因此假設目前的 Config 也已同步替換。訂閱連結可能含有個人存取憑證,截圖、記錄或求助內容中應移除完整連結。
此處的伺服器或節點指一組可供用戶端選用的遠端連線參數,通常包含位址、連接埠、協定與驗證資訊。清單中的顯示名稱方便辨識,但無法單獨證明實際位置、頻寬或可用性。手動修改訂閱產生的項目之前,應先考量後續更新是否會覆蓋修改內容。
Config 既可指管理設定檔的介面入口,也可指 Global Routing 中依設定處理請求的模式。設定檔可能包含規則、DNS 及其他設定,但具體內容取決於檔案本身,不能把訂閱清單直接當成完整設定。切換或遠端更新前應備份目前檔案,並確認引用的資源與最終策略。
Scan QR Code 會從 QR Code 讀取連線資料;其中可能包含單一伺服器資訊,也可能是可識別的連結。掃描不代表連線已驗證,匯入後仍應檢查協定、位址、連接埠及驗證欄位。QR Code 本身可能含有敏感資訊,不宜公開展示實際使用的完整影像。
URL Rewrite 依比對條件處理請求 URL,與決定請求走代理或直連的規則分流並非同一層功能。其處理範圍受協定、加密狀態與具體設定條件限制,不能視為對所有請求都有效。使用現有設定時應逐條確認作用範圍,避免不明規則改變正常請求。
調整設定前先記錄原始值,每次只變更一個變數。預設值與可用選項以目前的應用程式介面為準;術語說明不能取代依實際網路條件進行的判斷。
DNS 將網域名稱解析為位址;解析成功與目標連線成功是不同階段。DNS 查詢所走的路徑,也不能直接證明實際流量的最終出口,須分別核對規則與連線記錄。若無法以網域存取但位址可連線,可先檢查解析回應、快取及設定中的 DNS 選項。
Ping 或延遲結果反映指定測試條件下的回應時間,不直接代表下載速度。不同測試方式、目標與網路負載都會造成結果差異,比較時應使用相同方法。某次逾時也不一定表示伺服器完全無法使用,應搭配實際請求與 Connectivity Test 繼續判斷。
Log 記錄連線、比對或錯誤資訊,可用來區分解析失敗、驗證失敗及目標拒絕等情況。排查時先重現一次問題,再查看相近時間的記錄,避免受先前錯誤干擾。分享記錄前應移除伺服器位址、驗證資訊、訂閱連結及可識別個人存取資料的內容。
Widget 是由系統顯示應用程式狀態或提供操作入口的小工具,可顯示的內容取決於平台與目前應用程式功能。小工具更新時間受系統機制影響,顯示內容可能不是即時狀態。確認是否已連線時,應回到應用程式與系統連線狀態核對,不要只依據小工具某次顯示判斷。
在裝置與帳號條件允許時,iCloud 同步會同步應用程式支援的資料,但不等同於完整裝置備份。系統權限、連線授權與部分本機設定仍可能需要在新裝置上重新確認。更換裝置前應確認同步已完成,並另外匯出重要的 Config 檔案;還原後再確認伺服器選取與規則運作。
Proxy 連接埠是提供代理服務時在本機監聽的連接埠,與遠端伺服器使用的連接埠不是同一參數。其他裝置能否連線,還取決於監聽位址、區域網路權限與防火牆設定。若不需供其他裝置使用,應限制存取範圍;變更連接埠後,也要一併檢查使用端設定的位址與連接埠。