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…