Xray API 服务用于查询统计或控制入站。配置能通过解析,只说明 JSON 结构正确;是否可用还取决于 api.services、API 入站和路由是否分别接通。先备份配置,再逐层核对。
先确认配置边界
Xray API、API 入站和路由是不同层。先确认 services 中只列出需要的服务,再检查专用 API 入站是否存在,不要把业务代理端口当成 API 端口。
验证与回滚
- 备份当前配置并记录核心版本和错误时间。
- 运行官方配置检查命令,确认字段结构和引用对象。
- 建立一次新的最小连接,按日志阶段区分解析、监听、握手和路由问题。
- 一次只改一个变量,验证后保留可回滚副本。
不要把真实订阅、密码、令牌或会话密钥写入公开日志。可继续阅读 xray-core-config-test 与 xray-core-log-config。
官方来源
来源核验日期:2026-11-06。