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…