Xray-core 流量统计功能配置要点解析

Xray-core 作为一款优秀的网络工具，提供了强大的流量统计功能，但配置不当会导致统计失效。本文将深入分析流量统计功能的正确配置方法，帮助用户避免常见错误。

流量统计的基本原理

Xray-core 的流量统计功能通过 Stats API 实现，能够记录 inbound（入站）、outbound（出站）以及用户级别的流量数据。统计功能需要同时满足三个条件才能正常工作：

1. 启用 StatsService API 服务
2. 配置 stats 模块
3. 在 policy 中明确启用各项统计选项

典型配置错误分析

在常见配置错误中，最典型的是 policy 配置的嵌套错误。错误示例如下：

"policy": {
    "policy": {  // 错误的嵌套层级
        "levels": {
            "0": {
                "statsUserUplink": true,
                "statsUserDownlink": true
            }
        }
    }
}

这种配置会导致整个统计功能失效，因为 Xray-core 无法正确解析嵌套的 policy 结构。

正确的配置方法

正确的配置应该遵循以下结构：

{
    "stats": {},
    "api": {
        "services": ["StatsService"]
    },
    "policy": {
        "levels": {
            "0": {
                "statsUserUplink": true,
                "statsUserDownlink": true
            }
        },
        "system": {
            "statsInboundUplink": true,
            "statsInboundDownlink": true,
            "statsOutboundUplink": true,
            "statsOutboundDownlink": true
        }
    }
}

配置项详解

1. stats 模块：空对象 {} 表示启用基础统计功能

2. API 服务：必须在 api.services 中包含 "StatsService"

3. policy 配置：

   • levels：定义用户级别的统计
     • statsUserUplink：记录用户上传流量
     • statsUserDownlink：记录用户下载流量
   • system：定义系统级别的统计
     • statsInboundUplink/Downlink：记录入站流量
     • statsOutboundUplink/Downlink：记录出站流量

验证统计功能

配置完成后，可以通过以下命令验证：

xray api statsquery -s 服务器地址:端口 -pattern ''

如果返回空对象 {}，通常表示：

1. 配置仍有问题
2. 尚未产生任何流量
3. 查询的统计名称不正确

最佳实践建议

1. 始终检查配置文件的 JSON 结构，避免嵌套错误
2. 先启用所有统计选项，确认功能正常后再按需调整
3. 使用 loglevel: "debug" 帮助排查问题
4. 测试时确保产生足够的流量（至少几十MB）

通过正确配置，Xray-core 的流量统计功能可以精确记录各类流量数据，为用户提供有价值的网络使用情况分析。