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

Verificar 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:

• Activo: su aplicación funciona normalmente.
• En proceso de reinicio: la aplicación se está reiniciando, espere unos instantes.
• Detenida o Con error: hay un problema.

En caso de error o detención:

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

Leer la consola de ejecución

La consola muestra los mensajes de error generados al iniciar su aplicación. Aquí están los errores frecuentes:

• Comando de inicio incorrecto: verifique 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 manejada, de un módulo faltante o de un puerto definido incorrectamente.

Verificar los parámetros de la aplicación

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

• Carpeta de ejecución: carpeta en la que se ejecutan los comandos build y start.
• Comando de construcció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 Manager.
• Versión de Node.js: asegúrese de que sea compatible con su código.

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

¿Sigue bloqueado?

¿El sitio sigue inaccesible?

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

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

Si ha importado su código a través de 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 están correctamente instaladas (node_modules presente después de npm install o yarn install).

Si el problema persiste después de todas estas verificaciones:

• Intente crear un nuevo sitio con el método simple para probar con un ejemplo funcional.
• Compare su configuración con la del ejemplo proporcionado.
• Consulte la documentación oficial de Node.js para errores específicos.
• En caso de necesidad, contacte con el soporte de Infomaniak con una copia de los registros mostrados en la consola.