Com allotjar una aplicació Node.js: Sites, Projects o VPS

Una aplicació Node.js necessita un procés actiu en un servidor. Pujar-ne els fitxers a un allotjament estàtic no engega aquest procés. Abans de triar un producte, comprova com s’inicia l’app, quins serveis externs necessita i quin control vols assumir del servidor.

Hostbrid ofereix tres recorreguts diferents: Sites per gestionar una aplicació Node.js associada a un domini, Projects per desplegar serveis des de Git i un VPS per operar el sistema i els contenidors. No tenen el mateix flux ni les mateixes responsabilitats.

Revisa el projecte abans de triar

A l’arrel del repositori, localitza package.json, el fitxer d’entrada i l’ordre d’inici. Comprova també si l’app necessita PostgreSQL, Redis, emmagatzematge persistent, tasques programades o variables secretes. El nom del framework, tot sol, no demostra que sigui estàtica ni indica quina mida de servidor necessita.

El procés ha d’escoltar al port que rep de l’entorn (PORT). No tractis un port de desenvolupament com si fos el de producció. Després del desplegament, prova l’URL pública i revisa els logs si l’app no s’engega. Una app que funciona al teu ordinador encara pot fallar en instal·lar dependències de producció, resoldre rutes o connectar-se a una base de dades.

Si fas servir Express

Express és un servidor Node: pujar-ne els fitxers com a lloc estàtic no executa les seves rutes. Aquest fragment pressuposa que app ja és la instància d’Express creada abans; exigeix PORT en producció i només fa servir 3000 en desenvolupament 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 guia Node Apps explica com preparar el fitxer d’entrada i fer servir PORT a Sites. No donis per fet que el procés, el proxy o l’emmagatzematge es configuren igual a Projects i en un VPS.

Tria el flux adequat

Necessitat	Producte que cal revisar	Què has de comprovar
Pujar fitxers i gestionar una app Node associada a un lloc	Sites	La guia Node Apps requereix un lloc existent, `package.json` i un fitxer d’entrada. L’app fa servir el domini i, mentre està activa, substitueix el lloc anterior servit en aquell domini. Es permet una app per domini.
Desplegar des de Git quan envies canvis i connectar un servei backend	Projects	Consulta el pla vigent: els processos backend requereixen un pla de servei de pagament. Revisa les variables, els logs i qualsevol base de dades gestionada o externa que utilitzi l’app.
Administrar Docker Compose, paquets del sistema o tota la màquina	VPS	Tu assumes la configuració, les actualitzacions, la seguretat, les còpies i l’operació del sistema. Mesura la càrrega abans de triar recursos.

Si el repositori només genera HTML, CSS i JavaScript estàtics, potser no necessita cap procés Node en producció. Distingeix el servidor que compila l’app (build) del que ha de respondre les peticions (start). La guia per triar allotjament per a una web creada amb IA tracta aquesta decisió d’arquitectura.

Desplega a Sites i verifica el domini

La documentació de Node Apps descriu el flux de Sites: primer crea el lloc, prepara package.json i el fitxer d’entrada, i després gestiona l’app des de la secció Node.js. La instal·lació de dependències de producció, el port, l’estat del procés i els logs es gestionen en aquest flux; segueix les instruccions vigents del panell per a la teva app.

Abans d’activar-la, confirma quin domini has seleccionat i què s’hi publica ara. L’app Node ocupa el domini mentre està activa; si la web actual ha de continuar disponible, fes servir un domini de prova separat. Una ruta dins del mateix domini no evita que l’app substitueixi el lloc anterior. Quan s’engegui, obre l’URL pública en una finestra privada, comprova les rutes principals i revisa els logs. Verifica per separat si les dades de l’app sobreviuen als reinicis: no donis per fet que el disc és persistent ni que hi ha una base de dades inclosa sense confirmar-ho al producte.

Evita tres errors habituals

El procés no s’engega: comprova el fitxer d’entrada, l’ordre esperada i les dependències de producció.
El desplegament s’engega però no respon: fes que el servidor escolti a PORT i revisa els logs del procés.
Desapareix el lloc anterior: l’app pot ocupar el domini mentre està activa; comprova’l abans d’habilitar-la.

Si necessites Git, diversos serveis o recursos del sistema, compara Projects i VPS abans de moure el domini. Per diagnosticar localment un procés Node amb Docker, consulta la guia de port, salut i estat; aquest diagnòstic no substitueix els passos de desplegament de Sites.