nexcore-s-ui 安装与配置教程(sing-box 节点面板)
Astrenix/nexcore-s-ui sing-box 节点面板完整教程:一键安装、musl 静态编译、Cloudflare DNS-01 自动证书、/api/v1 接口与 CLI 运维。
- 完整重写的 Vue 3 + Element Plus 前端,统一管理 sing-box 的入站、出站、路由规则与多用户凭据。
- 采用 musl 静态编译,支持 amd64、arm64 等多架构 Linux,不依赖宿主机 GLIBC 版本。
- 提供完整的 /api/v1 REST 接口与 API 审计日志,接口规范兼容 nexcore-x-ui 主控对接。
- 内置 Cloudflare API Token 集成,支持 DNS-01 方式全自动申请与续签 SSL 证书,无需手动折腾 80 端口验证。
架构与核心特性
nexcore-s-ui 基于 alireza0/s-ui 二次开发重构,面向 sing-box 生态与自动化运维场景:
- 完整重写的 Vue 3 + Element Plus 前端,统一管理 sing-box 的入站、出站、路由规则与多用户凭据。
- 采用 musl 静态编译,支持 amd64、arm64 等多架构 Linux,不依赖宿主机 GLIBC 版本。
- 提供完整的 /api/v1 REST 接口与 API 审计日志,接口规范兼容 nexcore-x-ui 主控对接。
- 内置 Cloudflare API Token 集成,支持 DNS-01 方式全自动申请与续签 SSL 证书,无需手动折腾 80 端口验证。
系统与架构要求
- 推荐系统 — Ubuntu 24.04 LTS(已通过端到端验证);同时兼容 Ubuntu 20.04+、Debian 11+、CentOS Stream 8+ 等带 systemd 的现代 Linux。
- CPU 架构 — 支持 amd64、arm64、386、armv5、armv6、armv7 与 s390x 静态二进制。
- 运行权限 — 需要 root 权限运行,用于绑定 80 / 443 低端口、写入 ACME 证书及按需创建 tun 设备。
- 隔离共存 — 路径、服务名与默认随机端口均与上游原版 s-ui 隔离,支持同机独立共存。
一键安装、指定版本与强制重装
以 root 登录 Linux 服务器后,执行官方一键安装脚本。首次安装会自动生成随机用户名、随机密码与随机面板访问端口:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh)
如果需要锁定特定 Release 版本,或在不丢失数据库的情况下覆写程序二进制,可附加版本标签或 --force 参数:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) --force
# bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) v1.0.0
首次安装结束时终端会一次性打印随机用户名、密码与面板 URI,请立即复制保存;关闭终端后无法直接查看明文密码。
配置 Cloudflare DNS-01 自动证书
使用 Hysteria2、Trojan、AnyTLS 或需要 TLS 域名的入站时,推荐通过 Cloudflare DNS-01 自动签发并续签证书:
- 准备已接入 Cloudflare 解析的域名: 在 Tovanix 云服务注册域名(或使用自有域名),并将目标子域名的 A / AAAA 记录指向节点服务器公网 IP。
- 创建最小权限的 Cloudflare API Token: 在 Cloudflare 控制台为目标域名区域生成仅含 Zone:DNS:Edit 权限的 API Token,避免使用全局密钥。
- 在面板中填写 Token 与域名完成签发: 进入 nexcore-s-ui 证书管理页,选择 DNS-01 模式并填入域名与 API Token,保存后系统会自动完成证书申请与周期续签。
DNS-01 验证通过解析 TXT 记录完成,即使服务器的 80 端口被占用或未对外开放,也能正常签发和续签证书。
nexcore-s-ui 命令行(CLI)速查
安装完成后可通过 nexcore-s-ui 命令进行日常启停、查日志、升级与卸载:
- nexcore-s-ui — 打开交互式控制菜单,集中执行面板管理与维护项。
- nexcore-s-ui start | stop | restart | status — 启动、停止、重启 nexcore-s-ui 服务或检查运行状态。
- nexcore-s-ui log — 查看面板与核心服务的近期运行日志,辅助定位入站或证书报错。
- nexcore-s-ui update — 升级面板程序至最新 Release 版本,自动保留原有数据库与配置。
- nexcore-s-ui uninstall — 完整卸载面板程序、systemd 服务与本地数据(操作不可逆,请提前备份)。
常见问题排查
- 安装后访问面板地址无响应 — 随机生成的面板端口尚未在防火墙或安全组放行,或遗漏了面板 URI 路径。 — 核对安装横幅显示的完整端口与路径,在控制台放行对应端口后执行 nexcore-s-ui status 确认服务活跃。
- Cloudflare DNS-01 证书申请失败 — API Token 缺少对应域名的 DNS 编辑权限,或域名的解析尚未生效。 — 检查 Token 作用域是否包含目标域名且具备 Zone:DNS:Edit 权限,通过 nexcore-s-ui log 查看 ACME 返回的具体错误。
- Hysteria2 或 UDP 类协议连接失败 — 服务器防火墙只放行了 TCP 端口而漏放 UDP,或证书未包含正确的域名与 ALPN。 — 同时放行对应端口的 UDP 流量,确保证书有效且客户端 SNI 与证书域名一致。
- 二进制损坏需要修复但不想丢配置 — 直接卸载会连同数据库一并清除。 — 不要执行 uninstall,运行 install.sh --force 覆盖程序二进制即可完整保留原有数据库。
常见问题
nexcore-s-ui 对宿主机 GLIBC 版本有要求吗?
没有强依赖。发行包采用 musl 静态编译,兼容多种主流 Linux 发行版与不同架构,推荐优先使用 Ubuntu 24.04 LTS。
能否与原版 alireza0/s-ui 装在同一台服务器?
可以。nexcore-s-ui 的安装目录、服务名称与端口均独立隔离,只要避免监听端口重叠即可共存。
为什么推荐优先使用 Cloudflare DNS-01 申请证书?
DNS-01 不依赖服务器 80 端口,支持泛域名证书且不会与已有 Web 服务抢占端口,更适合自动化续签。
相关页面: nexcore-x-ui 安装与运维教程(Xray 节点面板) · 自建节点面板选型:nexcore-x-ui、nexcore-s-ui 与独享代理 · 专属网络部署解决方案 · 独享代理
正在加载…