01 · 流量入口與出口

系統代理修改操作系統的代理設置,讓遵循該設置的應用把請求發往本地核心。它不會強制接管所有應用。核心收到請求後,再由路由決定 direct、proxy 或 block 等出站。

因此“自動配置系統代理 + 繞過部分地址的路由”可以同時成立。應用根本沒有把流量交給核心時,修改核心路由不會影響這個應用。

  1. 應用
  2. 系統代理 / 手動代理 / TUN
  3. 核心路由
  4. 直連 / 代理 / 阻止

02 · 四種系統代理模式

這些選項控制啓動或重啓服務時如何處理系統設置;選擇前應知道當前是否有其他軟件維護代理。

模式行爲適用場景
清除系統代理移除系統代理配置停止使用代理或恢復普通網絡
自動配置系統代理指向客戶端的本地監聽地址和端口使用遵循系統設置的瀏覽器等應用
不改變系統代理保留現有設置手動配置應用,或由其他工具管理入口
PAC(Windows)由腳本按地址選擇直連或代理需要在進入核心前分流的應用

03 · 普通使用的操作順序

先導入並激活一個有效節點,確認核心啓動;選擇自動配置系統代理,再選擇適合當前網絡環境的現有路由規則。瀏覽器發起請求後,查看日誌中的目標和出站是否符合預期。

如果只想讓某個支持手動代理的應用使用客戶端,可將該應用的 HTTP 或 SOCKS5 代理地址設爲 127.0.0.1,端口填寫客戶端實際混合監聽值。這裏的端口不是遠程節點的服務器端口。

本地端口說明

04 · PAC 與自動代理的區別

自動代理先把應用請求交給核心,再由核心路由判斷出口。PAC 則先在應用側執行腳本:選爲 DIRECT 的請求不會進入核心,選爲代理的請求進入後仍會經過核心路由。

PAC 文件是 Windows 存儲目錄下的 pac.txt,包含 FindProxyForURL 等 JavaScript 邏輯。修改前備份,保持腳本有效;瀏覽器可能緩存腳本,修改後需重新應用設置並重試。PAC 只能影響支持它的應用,不能代替 TUN。

05 · 路由預置與自定義規則

初次使用可保留客戶端生成的默認規則集。規則從上到下匹配,具體域名 / IP 規則應放在兜底規則前。需要指定目標直連或代理時,新增規則並確認當前選中的是修改後的規則集。

“全局”路由只表示進入核心的流量默認走代理,不能讓忽略系統代理的程序自動進入核心。

編寫路由規則

06 · 退出與恢復網絡

不用代理時先選擇清除系統代理,再正常退出客戶端。直接關機、強制結束進程或崩潰可能來不及恢復系統設置。

若客戶端未運行而瀏覽器不能聯網,先檢查系統代理是否仍指向 127.0.0.1。重新打開客戶端清除代理,或在操作系統網絡代理設置中關閉遺留項,然後再測試普通網絡。

07 · 規則是有順序的 JSON 數組

每個對象表示一條規則。enabled 控制啓用,remarks 爲備註,outboundTag 選擇已存在的出站。客戶端編輯器與核心原生配置並非完全相同;優先從客戶端導出規則,再在相同結構中修改。

保存後還要選中該規則集並重新應用配置。規則由上到下匹配,命中後不繼續向下查找。

08 · 常用匹配字段

同一條件中的多個值通常表示任選其一;不同條件同時填寫時需要共同滿足。客戶端會將同一條中的 Domain、IP、進程條件拆開處理,建議每條只選擇其中一種。

字段寫法與作用
domain域名數組;full:example.com 精確匹配,domain:example.com 包含其子域名,regexp: 爲正則,geosite: 爲分類
ip單個 IP、CIDR 或 geoip: 分類;geoip:private 匹配私有地址
port目標端口或範圍,如 443 或 1000-2000
sourcePort / source來源端口 / 來源 IP 條件,核心支持範圍需匹配
networktcp、udp 或二者
protocol嗅探得到的應用協議,如 http、tls、bittorrent;需要相應嗅探
inboundTag限定請求來自哪個入站
outboundTagdirect 直連、proxy 代理、block 阻止,或已經定義的自定義 tag
enabled / remarks客戶端規則啓用狀態 / 備註

09 · 從一條明確規則開始

下面的示例讓 example.com 及其子域名直連,其餘交給 proxy。示例中的最後一條是兜底規則,應始終位於後面;如果已有規則集有兜底規則,只新增需要的精確規則即可。

JSON · client routing rules複製
[
  {
    "remarks": "Example domain direct",
    "domain": [
      "domain:example.com"
    ],
    "outboundTag": "direct",
    "enabled": true
  },
  {
    "remarks": "Fallback proxy",
    "port": "0-65535",
    "outboundTag": "proxy",
    "enabled": true
  }
]

10 · 常見規則組合

把局域網 IP 和私有域名設爲 direct,可讓本地設備保持可達;使用 GEO 分類前應更新對應數據。需要阻止 UDP 443 時可寫 network=udp、port=443、outboundTag=block,這會影響 QUIC / HTTP/3,不應當成所有連接問題的通用修復。

域名規則需要客戶端擁有域名信息;如果應用直接連接 IP,純域名規則可能無法命中。嗅探、DNS 模式和應用自己的加密 DNS 都會影響可用信息。

11 · 域名解析策略

Xray 的 AsIs 在路由階段保留域名;IPIfNonMatch 會在域名未匹配時嘗試解析後匹配 IP;IPOnDemand 在匹配需要 IP 信息的規則時解析。解析策略與規則順序相互影響,不代表所有實際出站解析也使用相同 DNS。

將域名規則放在合適位置,避免過早觸發寬泛 IP 規則。DNS 出站解析的設置請在本站 DNS 章節中單獨覈對。

DNS 設置說明

12 · 導入、驗證與回退

規則可以從文件、剪貼板或訂閱 URL 導入。導入前保留舊規則集;JSON 不能包含尾隨逗號或註釋。確認 outboundTag 存在,分類數據有效,沒有將所有流量誤匹配到第一條。

用一個明確目標驗證:發起一次新連接,查看日誌中選擇的出站。舊的長連接可能繼續使用原出口,必要時重啓目標應用再測。失敗時切回舊規則集,不需要刪除所有配置。

參考資料官方文檔

步驟與參數已在本頁展開,參考鏈接用於標註資料來源。覈對日期:2026-10-19。