V2bX 节点后端安装配置教程（V2board/Xboard 面板）

什么是 V2bX

V2bX 是 V2board/Xboard 面板的节点后端程序（Node），负责承载 V2Ray、Xray、Trojan、Shadowsocks 等代理协议的实际流量，与面板 API 通信实现用户管理、流量统计、节点状态上报等功能。适合自建机场、团队共享节点等场景。

功能特点

支持 V2Ray/Xray/Trojan/Shadowsocks 多种代理协议；自动同步面板节点配置；支持多端口、多用户独立流量统计；支持 WebSocket、TCP、gRPC 等多种传输方式；一键安装脚本可自动配置环境。

安装方法

需要先部署 Xboard 或 V2board 面板并创建节点，然后在节点服务器执行以下一键安装脚本：

wget -N https://raw.githubusercontent.com/wyx2685/V2bX-script/master/install.sh && bash install.sh

系统要求

Linux x86_64 架构服务器，建议 1 核 1G 内存以上；需开放面板配置的通信端口；安装过程中会提示输入面板地址、通信密钥（在面板节点设置中获取）和节点 ID。

注意事项

1. 安装前请确认面板已创建对应节点并获取通信密钥；2. 节点服务器时间需与面板同步（NTP），否则可能导致认证失败；3. 安装完成后可在面板节点列表查看节点在线状态；4. 如使用宝塔面板，需在防火墙/安全组中放行节点端口。

常见问题排查（FAQ）

节点在面板显示离线，如何排查？

按以下顺序检查：① 确认节点服务器时间已同步（执行 chronyc tracking 或启用 systemd-timesyncd），与面板时间偏差超过 90 秒会导致通信密钥校验失败；② 核对面板地址与通信密钥是否正确（密钥在面板「节点管理」中查看）；③ 确认节点端口已放行（ufw status、宝塔安全组、云厂商安全组三处都要检查）；④ 查看日志定位：journalctl -u v2bx -n 50 --no-pager，出现 invalid token 说明密钥错误，connection refused 说明面板 API 地址不可达。

如何确认 V2bX 正在运行并正常监听端口？

先用 systemctl status v2bx 查看服务状态，正常应显示 active (running)；再用 ss -tlnp | grep -i v2bx 确认监听端口与面板中的节点配置一致。如果服务反复重启（activating 循环），用 journalctl -u v2bx -f 实时观察崩溃原因，常见是配置文件 JSON 语法错误或端口被占用。

V2bX 支持哪些协议与传输方式？

协议支持 V2Ray/Xray（VMess、VLESS）、Trojan、Shadowsocks 等；传输方式支持 TCP、WebSocket、gRPC、HTTP/2，可叠加 TLS 或走 CDN 回源。节点上的协议与传输方式必须与面板配置完全一致，否则客户端会连接失败或无法通过认证。

升级或迁移节点时要注意什么？

升级前先备份 /etc/V2bX/config.json；更换服务器 IP 或重装系统后，需要回到面板更新节点地址并重新获取通信密钥；若走 CDN，记得同步更新回源 IP，并保留原有 TLS 证书与 SNI 配置，避免证书不匹配导致握手失败。