Metrics

更直接（希望更好）的统计导出方式。

使用方法

pprof

访问 http://127.0.0.1:11111/debug/pprof/ 或者使用 go tool pprof 进行调试。

反馈内存占用过多/内存泄露问题需要提供 /debug/pprof/heap 和 /debug/pprof/goroutine 的文件

expvars

访问 http://127.0.0.1:11111/debug/vars

包含的变量:

stats 包括所有的 inbound outbound user 数据
observatory 包含了 observatory 观测结果

例如在 luci-app-xray 你可以得到这样的输出 (省略了 cmdline 和 memstats 等标准expvar内容)

点击查看

json

{
  "observatory": {
    "tcp_outbound": {
      "alive": true,
      "delay": 782,
      "outbound_tag": "tcp_outbound",
      "last_seen_time": 1648477189,
      "last_try_time": 1648477189
    },
    "udp_outbound": {
      "alive": true,
      "delay": 779,
      "outbound_tag": "udp_outbound",
      "last_seen_time": 1648477191,
      "last_try_time": 1648477191
    }
  },
  "stats": {
    "inbound": {
      "api": {
        "downlink": 0,
        "uplink": 0
      },
      "dns_server_inbound_5300": {
        "downlink": 14286,
        "uplink": 5857
      },
      "http_inbound": {
        "downlink": 74460,
        "uplink": 10231
      },
      "https_inbound": {
        "downlink": 0,
        "uplink": 0
      },
      "metrics": {
        "downlink": 6327,
        "uplink": 1347
      },
      "socks_inbound": {
        "downlink": 19925615,
        "uplink": 5512
      },
      "tproxy_tcp_inbound": {
        "downlink": 4739161,
        "uplink": 1568869
      },
      "tproxy_udp_inbound": {
        "downlink": 0,
        "uplink": 2608142
      }
    },
    "outbound": {
      "blackhole_outbound": {
        "downlink": 0,
        "uplink": 0
      },
      "direct": {
        "downlink": 97714548,
        "uplink": 3234617
      },
      "dns_server_outbound": {
        "downlink": 7116,
        "uplink": 2229
      },
      "manual_tproxy_outbound_tcp_1": {
        "downlink": 0,
        "uplink": 0
      },
      "manual_tproxy_outbound_udp_1": {
        "downlink": 0,
        "uplink": 0
      },
      "tcp_outbound": {
        "downlink": 23873238,
        "uplink": 1049595
      },
      "udp_outbound": {
        "downlink": 639282,
        "uplink": 74634
      }
    },
    "user": {}
  }
}

为了得到更好的可视化输出, 可以使用 Netdata (with python.d plugin):

编辑相关配置文件 (sudo /etc/netdata/edit-config python.d/go_expvar.conf)
使用下面这样的实力配置:

点击查看

xray:
  name: 'xray'
  update_every: 2
  url: 'http://127.0.0.1:11111/debug/vars'
  collect_memstats: false
  extra_charts:
     - id: 'inbounds'
       options:
         name: 'inbounds'
         title: 'Xray System Inbounds'
         units: bytes
         family: xray
         context: xray.inbounds
         chart_type: line
       lines:
         - expvar_key: stats.inbound.tproxy_tcp_inbound.downlink
           id: 'tcp.downlink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.tproxy_udp_inbound.downlink
           id: 'udp.downlink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.http_inbound.downlink
           id: 'http.downlink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.https_inbound.downlink
           id: 'https.downlink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.socks_inbound.downlink
           id: 'socks.downlink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.tproxy_tcp_inbound.uplink
           id: 'tcp.uplink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.tproxy_udp_inbound.uplink
           id: 'udp.uplink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.http_inbound.uplink
           id: 'http.uplink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.https_inbound.uplink
           id: 'https.uplink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.inbound.socks_inbound.uplink
           id: 'socks.uplink'
           algorithm: incremental
           expvar_type: int
     - id: 'outbounds'
       options:
         name: 'outbounds'
         title: 'Xray System Outbounds'
         units: bytes
         family: xray
         context: xray.outbounds
         chart_type: line
       lines:
         - expvar_key: stats.outbound.tcp_outbound.downlink
           id: 'tcp.downlink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.outbound.udp_outbound.downlink
           id: 'udp.downlink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.outbound.direct.downlink
           id: 'direct.downlink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.outbound.tcp_outbound.uplink
           id: 'tcp.uplink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.outbound.udp_outbound.uplink
           id: 'udp.uplink'
           algorithm: incremental
           expvar_type: int
         - expvar_key: stats.outbound.direct.uplink
           id: 'direct.uplink'
           algorithm: incremental
           expvar_type: int
     - id: 'observatory'
       options:
         name: 'observatory'
         title: 'Xray Observatory Metrics'
         units: milliseconds
         family: xray
         context: xray.observatory
         chart_type: line
       lines:
         - expvar_key: observatory.tcp_outbound.delay
           id: tcp
           expvar_type: int
         - expvar_key: observatory.udp_outbound.delay
           id: udp
           expvar_type: int

你可以得到类似这样的结果:

HTTP API（本地）

以下接口均支持 CORS，返回 JSON（SSE 除外）。当设置 access_key 后需要鉴权。

UI 控制台通过 controller-ui 调用这些接口，详见 UI 面板。

连接与流量

GET /connections：连接快照（聚合后的连接组 + 统计）
GET /connections/stream?interval=1000：SSE 推送连接快照（默认 1000ms，最小 200ms）
POST /connections/close：关闭连接
请求体：{ "ids": [1,2,3] }
返回：{ "requested": 3, "closed": [1,2], "failed": [3] }

连接元数据字段：

network, type
sourceIP, sourcePort
localIP, localPort
xraySrcIP, xraySrcPort
destinationIP, destinationPort
host
inboundTag, outboundTag
user

节点 / 负载均衡 / 观测

GET /nodes：出站列表、负载均衡组、观测状态
POST /balancer/override：手动覆盖 balancer 目标
请求体：{ "balancerTag": "auto", "target": "proxy-a" }
说明：balancerTag 必填；target 传空字符串可清除覆盖并恢复自动选择；target 可填写 outbound tag（也可填写 balancer tag，由路由器在运行时继续解析）。
GET /observatory/probe：读取探测模式（tcp / http）
POST /observatory/probe：设置探测模式
请求体：{ "mode": "tcp" }
POST /observatory/probe/trigger：触发一次观测探测

路由与规则

GET /rules：返回当前路由规则与 balancer 配置（含原始 proto）

配置读写（JSON/JSONC）

GET /config/routing：读取 routing 配置
POST /config/routing：写入 routing 配置（支持 destination 合并与兼容字段）
请求体可为 { "routing": { ... } } 或直接传 routing 对象
GET /config/outbounds：读取 outbounds 配置
POST /config/outbounds：覆盖 outbounds 配置（仅接受 outbounds 数组）
GET /config/subscription：读取 subscription 配置
POST /config/subscription：写入/删除 subscription 配置
请求体示例（写入）：{ "subscription": { ... }, "path": "/path/to/config.json" }
请求体示例（删除）：{ "subscription": null }
GET /config/observatory：读取 observatory
POST /config/observatory：写入 observatory

TIP

上述 /config/* 写接口仅负责落盘，不会立即重建运行时实例。修改后请再调用 /core/hotreload 或 /core/restart 使配置生效。

启动信息

GET /startup：返回启动参数、配置文件、工作目录等

UI 设置与状态

GET /settings：读取 xray.ui.json（主配置为 YAML 时为 xray.ui.yaml）
POST /settings：更新 xray.ui.json（主配置为 YAML 时为 xray.ui.yaml）
GET /ui/state：读取 xray.ui.json 中的 controller.uiState（主配置为 YAML 时为 xray.ui.yaml）
POST /ui/state：更新 UI 状态（合并写入到 controller.uiState）

日志与重启

GET /logs?tail=200&level=info：读取日志尾部（默认 200 行，最大 2000）
GET /logs/stream?tail=200&level=info：SSE 推送日志（事件类型 init/append/error）
GET /logs/config：查询日志等级覆盖
POST /logs/config：设置日志等级
请求体：{ "level": "debug" } 或 { "debug": true }
POST /core/restart：读取启动配置并执行内核重启
GET /core/restart/status：查询最近一次重启任务状态（可选 ?id= 指定任务）
POST /core/hotreload：重新载入启动配置文件，并在不重启内核的情况下尽可能应用可热更新的部分（不会主动断开已有连接；通常只影响新连接）。当返回 needsRestart=true 时，表示存在无法热更新的变更，需要用 /core/restart 完整重载。

TIP

metrics 启动时会为启动配置文件生成 .xrayui.bak 备份；若 /core/restart 启动失败，会尝试回滚到备份并再次启动。

Metrics gRPC（MetricsService）

通过 api.services 启用 MetricsService/MetricsGrpcService。
鉴权使用 metadata x-access-key（同 access_key 设置）。

支持的 RPC：

Connections：GetConnections / StreamConnections / CloseConnections
Nodes/Observatory：GetNodes / OverrideBalancer / GetObservatoryProbe / SetObservatoryProbe / TriggerObservatoryProbe
Routing：GetRules / GetRoutingConfig / UpdateRoutingConfig
Outbounds：GetOutboundsConfig / UpdateOutboundsConfig
Settings/Startup：GetSettings / UpdateSettings / GetStartupInfo
Logs：GetLogs / GetLogsConfig / SetLogsConfig / StreamLogs
Control：RestartCore

ConnectionMetadata 附带 local_ip/local_port 与 xray_src_ip/xray_src_port 字段，便于定位真实落地连接。

Metrics ​

相关配置 ​

使用方法 ​

pprof ​

expvars ​

HTTP API（本地） ​

连接与流量 ​

节点 / 负载均衡 / 观测 ​

路由与规则 ​

配置读写（JSON/JSONC） ​

启动信息 ​

UI 设置与状态 ​

日志与重启 ​

Metrics gRPC（MetricsService） ​