节点

节点是运行 Xray 的代理服务器。面板保存它的设置、 下发配置并监控其状态。容器的启动方式见 节点安装一节。

添加节点

Nodes → Create node。至少需要名称、地址和配置配置文件。

字段	必填	说明
name	是	3–30 个字符
address	是	服务器的 IP 或域名
port	否	管理端口（NODE_PORT，默认 2222）
configProfile	是	配置文件和已启用的 inbound
proxyUrl	否	socks5://[user:pass@]host:port，用于通过代理管理
countryCode	否	两位国家代码，默认 XX
tags	否	最多 10 个标签
isTrafficTrackingActive、trafficLimitBytes、trafficResetDay	否	节点流量统计
consumptionMultiplier、nodeConsumptionMultiplier	否	流量扣费系数
activePluginUuid、integrationUuids、note	否	插件、集成、备注

保存后，面板会显示一次 SECRET_KEY——节点容器需要它。该密钥 一次性使用，且每个节点各不相同。

状态

指示符	含义
绿色，Connected	节点有响应，Xray 正在运行
黄色，Connecting	面板正在建立连接
灰色，Disabled	节点已被管理员关闭
红色，Disconnected	节点无响应

如果节点长时间保持 Disconnected，请从面板服务器检查 NODE_PORT 是否可达，以及 SECRET_KEY 是否完整。

Xray 版本与负载

节点卡片显示：

• versions.xray 和 versions.node —— 内核与 agent 的版本；
• system.stats —— 空闲和已用内存、loadAvg、uptime 以及按网络接口 统计的流量；
• xrayUptime —— Xray 的连续运行时间；
• usersOnline —— 在线用户数。

节点的负载和流量历史单独保存（表 nodes_usage_history），并按 NODES_USAGE_HISTORY_RETENTION_DAYS 清理。

重启

Restart node 会重启节点上的 Xray。面板会比较 用户集合，仅在发生变化时重启内核；forceRestart 标志 会强制重启内核，即使配置没有 变化。对所有节点同时操作——Restart all nodes。

注意

重启 Xray 会短暂中断该节点上的活动连接。请在 非高峰时段进行。

日志

Xray 日志位于节点的 /var/log/xray，限制为 10 MB 且不归档。 在面板中可通过 Logs 页面查看，位于「Node system logs」一节。 清理——Clear logs 按钮：节点会轮转文件，此时 Xray 不会 重启，流量也不会中断。手动操作：

docker exec -it xpanel-node cli --clear-logs

启用与关闭

Disable node 将节点切换为 Disabled：其上的 Xray 会停止， 用户不会再被分配到该节点。Enable node 让节点恢复工作。 节点流量计数器可以单独清零——Reset node traffic；这不影响 用户限制。

批量操作（启用、关闭、重启、一次性为多个节点更换配置） 集中在 Bulk actions 页面。

提示

多个节点的配置文件和 inbound 列表可通过一次操作更改。这在 从一个配置文件迁移到另一个时很方便——参见 配置配置文件。

接下来

• 节点安装 —— 启动容器和 SECRET_KEY。
• 主机 —— 节点如何变得对客户端可用。
• 配置配置文件 —— Xray 究竟启动了什么。
• 常见错误 —— 如果节点无法连接。