流量与 PROXY
读者：需要查看用量、对接面板流量展示或配置 PROXY 透传的运维人员。
Master 从节点汇总用户流量，并通过 Webhook / Events 回流业务面板；同时支持 PROXY 协议透传，便于在入口反代后保留真实源 IP（与设备统计、日志相关）。
1. 流量统计
Section titled “1. 流量统计”节点 3x-ui / Xray 统计各 client 上下行流量 → Client 上报 Master → 累加到用户 transfer_enable 配额。
- 控制台 用户 详情：已用 / 总量、重置记录
- 业务面板：通过 Adapter 拉取或接收 Webhook 事件（
traffic类） - Admin API：
GET /api/v1/users/{biz_ref}流量字段
与业务系统分工
Section titled “与业务系统分工”| 职责 | 归属 |
|---|---|
| 计量、累加、配额判断 | Master |
| 展示、套餐倍率、账单 | WHMCS / 面板 |
| 流量重置周期 | 由 Adapter 在续费时更新 transfer_enable |
倍率（rate）建议挂在 租户 × 权限组 维度，由面板换算后展示，Master 存原始字节。
2. PROXY 协议透传
Section titled “2. PROXY 协议透传”当用户流量经过 Nginx / CDN / 前置反代 进入节点时，可启用 PROXY protocol，使 Xray 看到真实客户端 IP，从而：
- 设备限制 统计准确
- 访问日志与风控更有意义
配置要点（概念层）：
- 反代监听层发送 PROXY v2 头
- 逻辑节点 / 模板中入站
listen或 stream 设置接受 PROXY（依协议与 XUI 版本） - 变更后走 配置同步 下发
具体 JSON 字段以当前 协议模板 与 XUI 文档为准。
3. 操作步骤（查看单用户流量）
Section titled “3. 操作步骤（查看单用户流量）”- 控制台 → 用户 → 搜索
biz_ref或邮箱备注 - 打开详情页查看 上行 / 下行 / 剩余
- 需要归零时执行 重置流量（写审计，面板侧应同步知悉）
4. 注意事项
Section titled “4. 注意事项”- 流量为累计值；异常暴涨时先查是否被共享订阅或遭受攻击
- 节点时钟漂移会影响统计周期，保持 NTP 同步
- PROXY 配置错误可能导致连接失败或 IP 全显示为反代地址
5. 常见问题
Section titled “5. 常见问题”Q：面板流量与 Master 不一致？
A：检查面板倍率、是否缓存；确认 Webhook / events 拉取正常；时区与重置时间点是否对齐。
Q：流量不更新？
A：Client 是否在线；UniProxy push 路径是否正常；用户是否已封禁或过期。