Tovanix
Tovanix

Tutorial de instalación y operación de nexcore-x-ui (panel Xray)

Guía paso a paso de Astrenix/nexcore-x-ui: instalación en un comando, binario Go estático, Vue 3, endurecimiento systemd, API REST /api/v1 y CLI.

  • Binario Go estático junto con SPA Vue 3 + Element Plus y Xray-core, sin dependencia estricta de la versión de GLIBC del host.
  • API REST /api/v1 completa preparada para controladores externos, scripts y orquestación multinodo.
  • Endurecimiento systemd (ProtectSystem=strict, NoNewPrivileges=true), directorios 0700, base de datos 0600 y tokens API guardados con hash SHA256.
  • VLESS con XTLS-Reality, TCP, WebSocket y gRPC para conexiones eficientes y estables.

Arquitectura y características clave

Refactorizado a partir de vaxilu/x-ui para despliegues modernos en la nube y seguridad en producción, nexcore-x-ui aporta:

  • Binario Go estático junto con SPA Vue 3 + Element Plus y Xray-core, sin dependencia estricta de la versión de GLIBC del host.
  • API REST /api/v1 completa preparada para controladores externos, scripts y orquestación multinodo.
  • Endurecimiento systemd (ProtectSystem=strict, NoNewPrivileges=true), directorios 0700, base de datos 0600 y tokens API guardados con hash SHA256.
  • Rutas, unidad systemd y comando CLI (nexcore-x-ui) totalmente independientes para no chocar con el x-ui original.

Requisitos del sistema

  • Sistema operativo — Linux moderno de 64 bits con systemd (se recomienda Ubuntu 22.04 / 24.04 LTS limpio o Debian 12).
  • Privilegios — Se necesita acceso root para registrar la unidad systemd, configurar puertos y proteger el directorio de datos.
  • Red — IP pública con salida hacia GitHub Releases para descargar binarios y reglas de cortafuegos abiertas para el panel y los protocolos.
  • Servidores recomendados — Encaja con VPS de IP nativa, VPS doble ISP, VPS residencial o servidores físicos de Tovanix.

Instalación en un comando y aprovisionamiento automático

Inicia sesión por SSH como root y ejecuta el script oficial para descargar el binario estático, iniciar el servicio y crear credenciales aleatorias:

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

Si aprovisionas nodos desde cloud-init o tu propio controlador, define las variables de ruta segura y webhook antes de ejecutar el instalador:

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)

Desde la versión v2.1.3, las credenciales iniciales en texto plano ya no se guardan en install-info.txt; solo aparecen en el banner de terminal y en systemd journal.

Recuperar credenciales iniciales de acceso

Si cerraste la terminal al terminar la instalación, recupera el banner inicial con la CLI o consultando systemd journal directamente:

nexcore-x-ui creds
journalctl -u nexcore-x-ui --no-pager --since "1 day ago"

Tras el primer inicio de sesión, cambia la contraseña generada desde el panel o con nexcore-x-ui passwd y restringe el acceso al puerto del panel en el cortafuegos.

Referencia rápida de comandos nexcore-x-ui

El instalador registra el comando global nexcore-x-ui para gestionar el servicio, los registros, las contraseñas, las actualizaciones y la desinstalación:

  • nexcore-x-ui — Abre el menú interactivo de administración en terminal.
  • nexcore-x-ui start | stop | restart | status — Inicia, detiene, reinicia o muestra el estado del servicio del panel.
  • nexcore-x-ui creds / info — Muestra el puerto actual, la ruta de entrada y las credenciales iniciales.
  • nexcore-x-ui reset — Genera de nuevo un usuario, una contraseña y un puerto aleatorios.
  • nexcore-x-ui passwd <user> <new_password> — Cambia manualmente la contraseña de acceso del administrador indicado.
  • nexcore-x-ui log / log-tail — Muestra las últimas 200 líneas de registro o sigue el flujo en directo.
  • nexcore-x-ui update — Actualiza a la última versión en GitHub Releases y reinicia el servicio.
  • nexcore-x-ui uninstall — Elimina binarios, unidad systemd y directorio de datos (haz copia de seguridad antes).

Protocolos y transportes compatibles

Construido sobre Xray-core, permite gestionar usuarios individuales, cuotas de tráfico y fechas de vencimiento en:

  • VLESS con XTLS-Reality, TCP, WebSocket y gRPC para conexiones eficientes y estables.
  • VMess y Trojan para compatibilidad con clientes clásicos y configuraciones con dominio TLS.
  • Shadowsocks y Shadowsocks-2022 para clientes ligeros y enlaces de relé rápidos.
  • SOCKS, HTTP y Dokodemo-door para proxies de aplicaciones, reenvío de puertos y salidas encadenadas.

Después de probar tu entrada, revisa la IP de salida en nuestra herramienta gratuita de calidad de IP para validar su clasificación nativa y de operador.

Solución de problemas

  • La página de acceso al panel no carga en el navegador — El puerto aleatorio está bloqueado en el cortafuegos o falta la ruta de entrada segura. — Ejecuta nexcore-x-ui status y nexcore-x-ui info para comprobar puerto y ruta, luego permite ese puerto TCP en el cortafuegos.
  • Se perdió la contraseña aleatoria inicial — Las versiones v2.1.3 y posteriores no guardan archivos de credenciales en texto plano. — Ejecuta nexcore-x-ui creds para leer el journal o restablécela con nexcore-x-ui passwd <usuario> <nueva_clave>.
  • La entrada está activa pero los clientes no conectan — Puerto de protocolo cerrado, fallo de handshake Reality o desfase excesivo del reloj del servidor. — Comprueba reglas TCP / UDP, sincroniza la hora por NTP y revisa los errores de Xray con nexcore-x-ui log-tail.
  • La actualización desde el panel no se aplicó — Tiempo de espera agotado al descargar de GitHub Releases o proceso anterior bloqueado. — Ejecuta nexcore-x-ui update por SSH para ver la salida completa y verifica luego con nexcore-x-ui status.

Preguntas frecuentes

¿Puede convivir nexcore-x-ui con vaxilu/x-ui en un mismo servidor?

Sí. Sus binarios, directorio de datos, unidad systemd y comando CLI están separados; mientras los puertos no coincidan pueden convivir.

¿Actualizar nexcore-x-ui borra entradas o usuarios existentes?

No. Tanto la actualización desde el panel como nexcore-x-ui update reemplazan solo los binarios conservando la base de datos SQLite.

¿Cómo automatizar la gestión de nodos con /api/v1?

Genera un API Token en los ajustes del panel (almacenado en servidor como hash SHA256) y usa peticiones REST estándar para entradas, usuarios y tráfico.

Páginas relacionadas: Tutorial de instalación y configuración de nexcore-s-ui (sing-box) · Guía de paneles de nodos: nexcore-x-ui, nexcore-s-ui y Proxy dedicado · Solución de despliegue de red privada · VPS con IP nativa e IP residencial

Cargando…