Calitatea hostingului dă valoare site-ului tău.

Node.js și aplicații web · Ghid practic

Node.js în producție: reverse proxy, procese și depanarea API-ului

O aplicație Node.js publică are nevoie de un proces persistent, un reverse proxy configurat și un flux sigur de actualizare. Află cum urmărești portul, semnalele de oprire, dependențele și blocajele event loop-ului.

Leagă domeniul de procesul Node prin reverse proxy

Într-o arhitectură obișnuită, reverse proxy-ul primește traficul public și îl transmite aplicației Node pe o adresă și un port intern. Confirmă adresa de bind, portul procesului și upstream-ul proxy-ului; aplicația poate răspunde local pe loopback fără să fie accesibilă din alt container sau server dacă rețeaua nu este configurată.

Configurează proxy-ul să trimită hostul și headerele necesare aplicației. Dacă hostul ori schema originală se pierd, linkurile absolute, redirecturile și cookie-urile pot reflecta portul intern sau HTTP în locul HTTPS. Ai încredere numai în proxy-urile controlate când interpretezi headerele forwarded, pentru a evita acceptarea unor valori arbitrare de la vizitatori.

Pentru WebSocket, verifică explicit upgrade-ul, timeout-urile și păstrarea conexiunilor. O rută HTTP poate funcționa în timp ce canalul WebSocket se închide imediat, fiindcă proxy-ul nu transmite protocolul actualizat sau întrerupe conexiunea idle.

Gestionează procesul și oprirea grațioasă

Nu porni singur aplicația într-o sesiune SSH pentru producție. Un manager de procese ori systemd trebuie să o pornească după reboot, să o repornească după o ieșire neașteptată și să trimită logurile către un loc monitorizat. Definește un singur mecanism responsabil pentru fiecare instanță, ca să eviți conflictele de port.

La primirea SIGTERM, aplicația poate opri acceptarea cererilor noi, lăsa cererile active să se finalizeze într-un timp limitat și închide conexiunile către baze sau cozi. Managerul trebuie să acorde timp pentru această oprire și să trimită SIGKILL numai după expirarea termenului stabilit. Testează comportamentul înainte de deploy și la restartul serverului.

Fă instalarea și configurarea repetabile

Folosește lockfile-ul npm și o instalare curată în pipeline sau release, astfel încât manifestul și arborele de pachete să corespundă. Evită actualizarea liberă a dependențelor direct pe serverul activ și nu expune credentiale de deploy în scripturi de instalare. Înregistrează versiunea de Node și configurația de build pentru a putea reproduce un release.

Variabilele din `process.env` sunt șiruri și pot lipsi, deci validează configurația la pornire. Dacă portul, cheia ori DSN-ul este invalid, e mai sigur să oprești pornirea cu un mesaj tehnic controlat decât să rulezi într-o stare parțială. Nu tipări secretele în loguri.

Investighează latența și erorile prin straturi

Un 502 sugerează o problemă de răspuns upstream, iar un 504 indică expirarea așteptării gateway-ului; verifică logurile ambelor servicii la același timestamp. Un API poate fi inaccesibil din cauza procesului oprit, a portului, a TLS, a timeout-ului sau a unei dependențe lente. Testează întâi local backendul, apoi proxy-ul, apoi cererea externă.

Node folosește event loop-ul pentru callbackuri; o operație sincronă sau un calcul CPU lung poate întârzia multe cereri simultan. Măsoară latența runtime-ului, profilează rutele care parsează payloaduri mari și folosește worker threads ori o coadă pentru calcule grele atunci când este potrivit. Limitează dimensiunile inputului și urmărește memory RSS, nu numai heap-ul JavaScript.

După fiecare deploy, verifică endpointurile critice, healthcheck-ul, logurile și conexiunile la dependențe. Păstrează artefactul anterior și o procedură de revenire; codul vechi poate fi incompatibil cu datele deja scrise de schema nouă.

Întrebări frecvente

De ce aplicația ascultă local, dar primește 502 prin domeniu?

Verifică portul și adresa de bind, apoi upstream-ul și logurile proxy-ului la aceeași oră.

Trebuie să tratez SIGTERM?

Da, o oprire grațioasă reduce cererile întrerupte și permite închiderea conexiunilor înainte de restart.

Ce blochează event loop-ul?

Operațiile sincrone și calculele mari pot ocupa firul principal și întârzia alte cereri. Profilează și mută procesarea grea în worker-e sau joburi.

Surse și documentare

Explicație editorială generală, bazată pe documentația de mai jos. Configurația concretă și condițiile furnizorului pot diferi. Documentare: 22 noiembrie 2026.