nexcore-x-ui 安装与运维教程(Xray 节点面板)
Astrenix/nexcore-x-ui Xray 节点面板完整教程:一键安装脚本、systemd 沙箱加固、/api/v1 接口、CLI 凭据找回与常见排障。
- 纯 Go 静态二进制配合 Vue 3 + Element Plus 前端与 Xray-core,消除对宿主机 GLIBC 版本的强依赖。
- 完整的 /api/v1 REST 接口设计,便于外部主控系统、脚本或多节点批量编排集成。
- 内置 systemd 沙箱加固(如 ProtectSystem=strict、NoNewPrivileges=true),目录权限 0700、数据库权限 0600,API Token 以 SHA256 哈希存储。
- VLESS:支持 XTLS-Reality、TCP、WebSocket 与 gRPC 等传输方式,兼顾低开销与连接稳定性。
架构与核心特性
nexcore-x-ui 基于 vaxilu/x-ui 深度重构,针对云主机自动化部署与长期稳定运行做了全面加固:
- 纯 Go 静态二进制配合 Vue 3 + Element Plus 前端与 Xray-core,消除对宿主机 GLIBC 版本的强依赖。
- 完整的 /api/v1 REST 接口设计,便于外部主控系统、脚本或多节点批量编排集成。
- 内置 systemd 沙箱加固(如 ProtectSystem=strict、NoNewPrivileges=true),目录权限 0700、数据库权限 0600,API Token 以 SHA256 哈希存储。
- 安装路径、服务名与 CLI(nexcore-x-ui)与原版 x-ui 完全独立,同机运行互不冲突。
系统与环境要求
- 操作系统 — 现代带 systemd 的 64 位 Linux(推荐干净的 Ubuntu 22.04 / 24.04 LTS 或 Debian 12)。
- 运行权限 — 需要 root 权限安装 systemd 服务、放行端口与写入受保护数据目录。
- 网络环境 — 服务器需具备公网 IP 且可访问 GitHub Releases 下载安装包;防火墙需放行面板与协议端口。
- 推荐机型 — 可搭配本平台原生 IP VPS、双 ISP VPS、住宅 IP VPS 或物理服务器。
一键安装与自动化部署
通过 SSH 以 root 身份登录服务器后,运行官方一键安装脚本即可自动下载静态二进制、初始化服务并生成随机安全凭据:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
如果你通过云初始化脚本或自研主控批量部署,可以在运行安装脚本前传入安全入口与 Webhook 回调环境变量:
REPORT_URL=https://your-controller.example/callback \
REPORT_KEY=your_secret \
SECURE_ENTRY=1 \
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
从 v2.1.3 起,出于安全考虑,首次安装生成的随机账号、密码与入口不再落盘写入明文 install-info.txt 文件,只会输出在终端横幅并记录到 systemd journal。
查看或找回首次登录凭据
如果安装完成后不慎关闭终端,可以通过内置 CLI 或直接查询 systemd 日志找回首装横幅与连接信息:
nexcore-x-ui creds
journalctl -u nexcore-x-ui --no-pager --since "1 day ago"
首次登录面板后,建议尽快通过面板设置或 nexcore-x-ui passwd 修改默认随机密码,并开启防火墙限制面板端口的访问来源。
nexcore-x-ui 命令行(CLI)速查
安装完成后全局注册 nexcore-x-ui 命令,日常启停、查日志、改密、升级与卸载都无需记忆复杂路径:
- nexcore-x-ui — 打开交互式运维菜单,按数字编号选择常用管理操作。
- nexcore-x-ui start | stop | restart | status — 启动、停止、重启面板服务或查看当前运行状态。
- nexcore-x-ui creds / info — 查看当前面板端口、入口路径与首装凭据信息。
- nexcore-x-ui reset — 强制重新生成随机管理员账号、密码与随机面板端口。
- nexcore-x-ui passwd <user> <new_password> — 将指定管理员账号的登录密码手动修改为新密码。
- nexcore-x-ui log / log-tail — 查看最近 200 行面板运行日志,或实时跟踪输出日志流。
- nexcore-x-ui update — 将面板平滑升级到 GitHub Releases 最新版本并热重启服务。
- nexcore-x-ui uninstall — 彻底卸载面板二进制、systemd 服务与数据目录(执行前请先备份配置)。
支持的协议与传输方式
面板完整继承 Xray-core 生态,支持多用户独立凭据、流量限额与到期时间控制:
- VLESS:支持 XTLS-Reality、TCP、WebSocket 与 gRPC 等传输方式,兼顾低开销与连接稳定性。
- VMess 与 Trojan:适配各类存量客户端与 TLS 域名配置场景。
- Shadowsocks 与 Shadowsocks-2022:轻量高效,适合常规客户端与高速内网/中转链路。
- SOCKS、HTTP 与 Dokodemo-door:适合程序代理、定点转发与多节点链式出站。
开启入站并测试连通后,建议把服务器出口 IP 放进本站 IP 质量查询核对原生与运营商标记,确认符合业务要求。
常见问题排查
- 浏览器打不开面板登录页 — 服务器防火墙或云安全组未放行随机面板端口,或漏填安全入口路径。 — 先执行 nexcore-x-ui status 与 nexcore-x-ui info 确认监听端口与路径,再在控制台防火墙放行对应 TCP 端口。
- 忘记首次安装的随机密码 — v2.1.3 及以上版本不再保存明文文件,关闭窗口后容易遗漏。 — 执行 nexcore-x-ui creds 从 journal 查看,或运行 nexcore-x-ui passwd <用户名> <新密码> 重设密码。
- 入站已创建但客户端连不上 — 协议端口未放行、Reality 目标域名握手失败,或系统时间偏差过大。 — 确认对应 TCP / UDP 端口已放行,校对服务器 NTP 时间,并通过 nexcore-x-ui log-tail 查看 Xray 报错详情。
- 面板内触发升级后未生效 — 网络拉取 GitHub Releases 超时或残留旧进程。 — 在 SSH 终端手动运行 nexcore-x-ui update 并观察输出日志,完成后检查 nexcore-x-ui status。
常见问题
nexcore-x-ui 可以和原版 vaxilu/x-ui 装在同一台机器吗?
可以。nexcore-x-ui 使用独立的二进制路径、数据目录、systemd 服务名与 CLI 命令,只要两者端口不冲突即可共存。
升级 nexcore-x-ui 会清空现有入站和用户配置吗?
不会。通过面板在线升级或执行 nexcore-x-ui update 只替换程序二进制并保留数据库与现有节点配置。
怎么用 /api/v1 接口自动化管理节点?
登录面板后在设置中生成 API Token(服务端仅存 SHA256 哈希),之后即可使用标准 REST 请求创建入站、增删用户与读取流量统计。
相关页面: nexcore-s-ui 安装与配置教程(sing-box 节点面板) · 自建节点面板选型:nexcore-x-ui、nexcore-s-ui 与独享代理 · 专属网络部署解决方案 · 原生 IP 与住宅 IP 的 VPS
正在加载…