Tovanix
Tovanix

Tutorial de instalación y configuración de nexcore-s-ui (sing-box)

Guía completa de Astrenix/nexcore-s-ui: instalación sing-box en un paso, binarios musl, certificados SSL Cloudflare DNS-01, API /api/v1 y CLI.

  • Interfaz Vue 3 + Element Plus reescrita para gestionar entradas, salidas, enrutamiento y usuarios de sing-box.
  • Binarios estáticos musl compatibles con amd64, arm64 y otras arquitecturas Linux sin depender de la GLIBC del host.
  • API REST /api/v1 completa con registro de auditoría, compatible con los flujos de controlador de nexcore-x-ui.
  • Integración nativa con Cloudflare API Token para emitir y renovar certificados SSL vía DNS-01 sin usar el puerto 80.

Arquitectura y características clave

Rediseñado sobre alireza0/s-ui para despliegues modernos de sing-box y automatización por API, nexcore-s-ui ofrece:

  • Interfaz Vue 3 + Element Plus reescrita para gestionar entradas, salidas, enrutamiento y usuarios de sing-box.
  • Binarios estáticos musl compatibles con amd64, arm64 y otras arquitecturas Linux sin depender de la GLIBC del host.
  • API REST /api/v1 completa con registro de auditoría, compatible con los flujos de controlador de nexcore-x-ui.
  • Integración nativa con Cloudflare API Token para emitir y renovar certificados SSL vía DNS-01 sin usar el puerto 80.

Requisitos de sistema y arquitectura

  • Sistema compatible — Ubuntu 24.04 LTS (verificado de extremo a extremo); también compatible con Ubuntu 20.04+, Debian 11+ y CentOS Stream 8+ con systemd.
  • Arquitecturas CPU — Binarios estáticos disponibles para amd64, arm64, 386, armv5, armv6, armv7 y s390x.
  • Privilegios — Requiere acceso root para enlazar puertos 80 / 443, escribir certificados ACME y crear interfaces tun si se configuran.
  • Coexistencia — Rutas, unidad systemd y puerto aleatorio independientes que permiten convivir con el s-ui original.

Instalación en un comando, versión fija y reinstalación

Accede por SSH como root y ejecuta el instalador oficial. La primera instalación genera usuario, contraseña y puerto aleatorios:

bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh)

Para fijar una etiqueta de lanzamiento concreta o sobrescribir binarios conservando la base de datos actual, pasa el tag o --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

Las credenciales aleatorias iniciales y la URI del panel se muestran una sola vez al finalizar; guárdalas antes de cerrar la terminal.

Configurar certificados SSL automáticos con Cloudflare DNS-01

Para Hysteria2, Trojan, AnyTLS o cualquier entrada con TLS, utiliza Cloudflare DNS-01 para emisión y renovación sin intervención:

  • Apunta un dominio gestionado en Cloudflare al servidor: Registra un dominio en Tovanix Cloud (o usa uno propio) y crea un registro A / AAAA hacia la IP pública del nodo.
  • Crea un Cloudflare API Token de permisos mínimos: En Cloudflare crea un API Token limitado a tu zona con permiso único Zone:DNS:Edit en lugar de usar la clave global.
  • Introduce el dominio y el Token en el panel: En la sección de certificados de nexcore-s-ui elige DNS-01, pega tu dominio y el API Token y guarda para emitir y renovar automáticamente.

DNS-01 valida la propiedad mediante registros TXT en DNS, por lo que funciona incluso con el puerto 80 ocupado o cerrado.

Referencia rápida de comandos nexcore-s-ui

Utiliza el comando nexcore-s-ui para controlar el servicio, consultar registros, actualizar o desinstalar:

  • nexcore-s-ui — Abre el menú interactivo de administración del panel.
  • nexcore-s-ui start | stop | restart | status — Inicia, detiene, reinicia o verifica el estado del servicio nexcore-s-ui.
  • nexcore-s-ui log — Consulta registros recientes del panel y del núcleo para diagnosticar entradas o ACME.
  • nexcore-s-ui update — Actualiza a la versión más reciente en GitHub Releases manteniendo la base de datos.
  • nexcore-s-ui uninstall — Desinstala por completo binarios, servicio systemd y datos locales (haz respaldo previo).

Solución de problemas

  • La URL del panel no responde tras la instalación — El puerto aleatorio no está abierto en el cortafuegos o falta la ruta URI generada. — Revisa el puerto y la URI completa en la salida de instalación, abre el puerto y confirma con nexcore-s-ui status.
  • Falla la emisión del certificado Cloudflare DNS-01 — Al API Token le falta el permiso Zone:DNS:Edit en esa zona o el DNS aún no propagó. — Verifica el alcance del token y los permisos de zona, y consulta el detalle ACME con nexcore-s-ui log.
  • Hysteria2 u otros protocolos UDP no conectan — Solo se abrió TCP en el cortafuegos dejando UDP bloqueado, o no coincide el dominio / ALPN del certificado. — Permite tráfico UDP en el puerto de entrada y asegúrate de que el SNI del cliente coincida con el dominio del certificado.
  • Necesito reparar binarios sin perder configuraciones — Ejecutar uninstall elimina tanto los binarios como la base de datos. — No ejecutes uninstall; lanza install.sh --force para sobrescribir binarios conservando intacta la base de datos.

Preguntas frecuentes

¿Depende nexcore-s-ui de una versión concreta de GLIBC en el servidor?

No. Los binarios publicados se compilan estáticamente con musl para múltiples arquitecturas Linux; se recomienda Ubuntu 24.04 LTS.

¿Puede convivir nexcore-s-ui con el alireza0/s-ui original?

Sí. Sus directorios, servicio systemd y puertos están aislados, por lo que conviven sin problemas si no repiten puertos.

¿Por qué usar Cloudflare DNS-01 en lugar de HTTP-01?

DNS-01 no ocupa el puerto 80, soporta certificados comodín y evita choques con servidores web existentes.

Páginas relacionadas: Tutorial de instalación y operación de nexcore-x-ui (panel Xray) · Guía de paneles de nodos: nexcore-x-ui, nexcore-s-ui y Proxy dedicado · Solución de despliegue de red privada · Proxy dedicado

Cargando…