Cómo publicar una aplicación Node.js: Sites, Projects o VPS

Una aplicación Node.js necesita que su proceso siga activo en un servidor. Subir sus archivos a un espacio estático no arranca ese proceso. Antes de contratar, revisa cómo se inicia la app, qué servicios externos necesita y cuánto control quieres asumir.

En Hostbrid hay tres recorridos distintos: Sites para administrar una aplicación Node.js asociada a un dominio, Projects para desplegar servicios desde Git y VPS para operar el sistema y sus contenedores. No ofrecen el mismo flujo ni las mismas responsabilidades.

Comprueba el proyecto antes de elegir

En la raíz del repositorio, identifica package.json, el archivo de entrada y el comando de inicio. Revisa también si la app necesita PostgreSQL, Redis, almacenamiento persistente, tareas programadas o variables secretas. El nombre del framework, por sí solo, no confirma que sea estático ni determina el tamaño del servidor.

El proceso debe escuchar en el puerto que recibe desde el entorno (PORT). No fijes un puerto de desarrollo como si fuese el de producción. Prueba la URL pública después de desplegar y revisa los logs si la app no arranca. Una app que responde en tu ordenador todavía puede fallar al instalar dependencias, resolver rutas o conectarse a una base de datos.

Si usas Express

Express es un servidor Node: subir sus archivos como sitio estático no ejecuta sus rutas. Este fragmento asume que app ya es la instancia Express creada antes; exige PORT en producción y solo usa 3000 en desarrollo local:

const port = process.env.PORT ?? (process.env.NODE_ENV === 'development' ? 3000 : undefined);
if (!port) throw new Error('PORT must be configured');
app.listen(port);

La guía de Node Apps explica cómo preparar el archivo de entrada y usar PORT en Sites. No presupongas que el proceso, el proxy o el almacenamiento se configuran igual en Projects o en un VPS.

Elige el flujo que encaja

Necesidad	Producto que conviene revisar	Qué debes comprobar
Subir archivos y administrar una app Node asociada a un sitio	Sites	La guía de Node Apps requiere un sitio existente, `package.json` y archivo de entrada. La aplicación usa el dominio y, mientras está activa, sustituye el sitio anterior servido en ese dominio. Hay una app por dominio.
Desplegar desde Git al enviar cambios y conectar un servicio backend	Projects	Comprueba el plan actual: los procesos backend requieren un plan de servicio de pago. Revisa variables, logs y cualquier base de datos externa o gestionada que use tu app.
Administrar Docker Compose, paquetes del sistema o toda la máquina	VPS	Tú asumes la configuración, actualizaciones, seguridad, copias y operación del sistema. Mide la carga antes de escoger recursos.

Si tu repositorio genera solo HTML, CSS y JavaScript estáticos, puede que no necesite un proceso Node en producción. Distingue el servidor usado para compilar (build) del servidor que debe atender peticiones (start). La guía para elegir alojamiento de una web creada con IA explica esa diferencia a nivel de arquitectura.

Publica en Sites y verifica el dominio

La documentación de Node Apps indica el flujo de Sites: crea primero el sitio, prepara package.json y el archivo de entrada, y administra la app desde la sección Node.js. La instalación de dependencias de producción, el puerto, el estado de ejecución y los logs se gestionan desde ese flujo; sigue las instrucciones vigentes del panel para tu aplicación.

Antes de activarla, confirma que el dominio seleccionado es el correcto y que sabes qué sitio está publicado ahí. La app Node toma el dominio mientras está activa; si la web actual debe seguir disponible, utiliza un dominio de prueba separado. Una ruta dentro del mismo dominio no evita que la app sustituya al sitio anterior. Tras el arranque, abre la URL desde una ventana privada, comprueba las rutas principales y consulta los logs. Revisa aparte si los datos de la app sobreviven a reinicios: no des por persistente el disco ni por incluida una base de datos sin confirmarlo en el producto.

Evita tres fallos habituales

El proceso no arranca: confirma el archivo de entrada, el comando esperado y que las dependencias de producción estén declaradas.
El despliegue arranca pero no responde: haz que el servidor escuche en PORT y revisa los logs del proceso.
La web anterior desaparece: la app puede ocupar el dominio mientras esté activa; verifica el dominio antes de habilitarla.

Si necesitas Git, varios servicios o recursos del sistema, compara Projects y VPS antes de mover el dominio. Para depurar un proceso Node en Docker localmente, consulta la guía de puerto, salud y estado; ese diagnóstico no sustituye los pasos de despliegue de Sites.