Skip to content

Xray-core — 配置结构

Xray-core 启动时读取单个 JSON 文档。根对象直接映射到 infra/conf/xray.go:346 中的 Go 结构体 Config,下表中的每一个顶层 字段都对应一个 JSON 键。

根字段

Go 字段类型页面描述
logLogConfigLogConfig日志访问与错误日志流、日志级别、DNS 查询日志与 IP 脱敏。
dnsDNSConfigDNSConfigDNSDNS 解析器、服务器列表、查询策略与 FakeDNS 联动。
routingRouterConfigRouterConfig路由域名策略、规则与负载均衡器。
inboundsInboundConfigs[]InboundDetourConfig入站监听服务列表。
outboundsOutboundConfigs[]OutboundDetourConfig出站上游代理目标列表。
policyPolicyPolicyConfig策略按等级的超时、缓冲区大小、用户统计与系统统计开关。
apiAPIAPIConfigAPIgRPC 管理 API 入站(tag + listen + 服务列表)。
statsStatsStatsConfig统计空结构体;存在即启用统计子系统。
metricsMetricsMetricsConfig指标Prometheus 导出端(tag + listen)。
reverseReverseReverseConfig反向反向代理的 bridge 与 portal。
fakeDnsFakeDNSFakeDNSConfigFakeDNSFake-IP 池配置(单对象或数组)。
observatoryObservatoryObservatoryConfigObservatory出站延迟探测。
burstObservatoryBurstObservatoryBurstObservatoryConfigBurst Observatory并发延迟探测,附带健康检查参数。
versionVersionVersionConfig版本可选的 min / max 版本要求。
transportTransportmap[string]json.RawMessage已弃用仅保留用于在旧配置中给出友好错误。

一览

json
{
  "log": { "loglevel": "warning" },
  "dns": {},
  "routing": { "rules": [] },
  "inbounds": [],
  "outbounds": [],
  "policy": { "levels": { "0": { "handshake": 4 } } },
  "api": { "tag": "api", "listen": "127.0.0.1:10085", "services": ["HandlerService", "StatsService"] },
  "stats": {},
  "metrics": { "tag": "metrics", "listen": "127.0.0.1:9099" }
}

源码: infra/conf/xray.go:346-365 · v1.260327.0 (d2758a0)

由 Argsment 出品的 Core Tutorial