Esta guía le ayudará a diagnosticar rápidamente la causa de un problema si su sitio Node.js, alojado en la infraestructura de Infomaniak, no funciona como se espera.

Comprobar el estado de la aplicación

Desde el panel de control de su sitio Node.js, puede consultar el estado actual de la aplicación:

• Activa: su aplicación funciona correctamente.
• Reiniciando: la aplicación se está reiniciando, espere unos instantes.
• Detenida o Con error: hay un problema.

En caso de error o interrupción:

• Haga clic en «Iniciar» o «Reiniciar» la aplicación.
• Consulte inmediatamente la consola de ejecución para identificar posibles errores técnicos.

Consultar la consola de ejecución

La consola muestra los mensajes de error que se generan al iniciar su aplicación. Estos son algunos de los errores más comunes:

• Comando de inicio incorrecto: compruebe que está utilizando la sintaxis correcta (por ejemplo, npm start, node app.js, etc.).
• Error en el código fuente: puede tratarse de una excepción no gestionada, de un módulo que falta o de un puerto definido incorrectamente.

Comprobar la configuración de la aplicación

En la sección Configuración avanzada del sitio, asegúrese de que todos los ajustes sean correctos:

• Directorio de ejecución: directorio en el que se ejecutan los comandos build y start.
• Comando de compilación (opcional): por ejemplo, npm run build si su aplicación lo requiere.
• Comando de inicio: por ejemplo, node index.js, npm start, etc.
• Puerto de escucha: el puerto en el que la aplicación espera las solicitudes (por ejemplo, 8080, 3000, etc.).
  • El puerto configurado en su aplicación debe coincidir con el definido en el Administrador.
• Versión de Node.js: asegúrese de que sea compatible con su código.

Infomaniak ofrece los gestores de paquetes NPM y Yarn. Puede elegir el que mejor se adapte a su proyecto en el asistente de configuración.

¿Sigue teniendo problemas?

¿El sitio web sigue inaccesible?

• Es posible que su aplicación esté en modo de mantenimiento.
• El puerto de escucha de la aplicación puede ser incorrecto o estar bloqueado.
• La aplicación no devuelve una respuesta HTTP correcta (por ejemplo, falta res.send() o res.end() en su servidor).

¿Ha utilizado un método de instalación avanzado?

Si ha importado su código mediante Git, ZIP, SSH o SFTP, asegúrese de que:

• El código se ha descomprimido o clonado correctamente en la carpeta adecuada.
• Los archivos esenciales (package.json, server.js, index.js, etc.) están presentes.
• Las dependencias se han instalado correctamente (la carpeta node_modules está presente después de ejecutar npm install o yarn install).

Si el problema persiste después de realizar todas estas comprobaciones:

• Intente crear un nuevo sitio web utilizando el método sencillo para probarlo con un ejemplo funcional.
• Compare su configuración con la del ejemplo proporcionado.
• Consulte la documentación oficial de Node.js para obtener información sobre errores específicos.
• Si es necesario, póngase en contacto con el soporte de Infomaniak y adjunte una copia de los registros que se muestran en la consola.