Node.js Hosting

Node.js hosting nedir, hangi projeler için uygundur?

Node.js hosting, V8 motoru üzerinde çalışan JavaScript ya da TypeScript sunucu uygulamalarının internete açık, sürekli erişilebilir biçimde barındırılmasıdır. Klasik PHP hostingden farkı, her istekte bir betiğin baştan çalışması yerine uygulamanın bellekte yaşayan bir süreç olarak istekleri karşılamasıdır. Bu yüzden Node.js barındırmada iki soru belirleyicidir: süreci kim başlatıp ayakta tutuyor ve ne kadar bellek ayrılıyor?

Node.js hosting şu projeler için iyi bir başlangıçtır:

• Mobil uygulama ya da tek sayfa uygulaması (React, Vue) için REST veya GraphQL API
• Express ile yazılmış form, ödeme bildirimi (webhook) ve e-posta gönderim arka uçları
• Next.js, Nuxt veya Astro ile sunucu tarafında işlenen (SSR) kurumsal siteler
• NestJS ile katmanlı yazılmış küçük ve orta ölçekli iş uygulamaları

Bu senaryolarda Linux hosting paketleri panelden Node.js sürümü seçimi, SSH erişimi ve Git ile dağıtım sunar; sunucu yönetimi bilgisi gerekmez. Uygulamanız sürekli açık kalması gereken bir bot, gerçek zamanlı sohbet ya da kuyruk işçisi ise hosting yerine sanal sunucuya geçmeniz gerekir; aşağıdaki bölümler bu sınırı somut olarak anlatır.

Hangi Node.js sürümünü seçmelisiniz?

Üretim ortamında her zaman bir LTS (Long Term Support, uzun süreli destek) sürümü seçmelisiniz; Ekim 2026 itibarıyla bu Node.js 24’tür ve Node.js 26, 28 Ekim 2026’da LTS aşamasına geçer. Node.js 22 bakım (maintenance) aşamasındadır ve Nisan 2027’de desteği sona erer. Node.js 20 ise 30 Nisan 2026’da destek dışına çıktı; bu sürümde çalışan uygulamalar artık güvenlik yaması almaz.

Node.js projesi 27. sürümden itibaren yılda tek ana sürüm yayımlama modeline geçiyor. Pratikte bunun anlamı şudur: yeni projeye güncel LTS ile başlayın, mevcut projeyi bir LTS’ten diğerine yılda bir planlı olarak taşıyın.

Sürümü projede sabitlemek için package.json içine "engines": { "node": ">=24" } ekleyin ve depoya bir .nvmrc dosyası koyun. Böylece yerel makineniz, CI ve hosting aynı ana sürümle çalışır; “bende çalışıyordu” sorunlarının büyük kısmı ortadan kalkar.

Linux hostingde Node.js uygulaması nasıl çalışır?

Linux hostingde Node.js uygulaması, paneldeki Node.js uygulama aracıyla tanımlanır ve web sunucusu tarafından yönetilen bir süreç olarak çalışır. cPanel tabanlı ortamlarda bu araç Setup Node.js App, Plesk Obsidian’da Node.js bölümü olarak görünür; ikisi de arka planda Phusion Passenger ile isteği uygulamanıza iletir.

Tanımlamanız gereken alanlar şunlardır:

• Node.js sürümü: Panelde listelenen LTS sürümlerden biri
• Uygulama kökü (application root): package.json dosyasının bulunduğu klasör; genel web klasörünün (public_html) dışında tutmanız güvenlik için daha iyidir
• Uygulama URL’si: Alan adı ya da alt klasör
• Başlangıç dosyası: app.js, server.js ya da derlenmiş dist/main.js
• Ortam değişkenleri: NODE_ENV=production, veritabanı bilgileri, API anahtarları

Uygulamanız portu kendisi seçmemeli, process.env.PORT değerini dinlemelidir; Passenger bu değeri atar. Bağımlılıklar panelden “npm install” düğmesiyle ya da SSH’de sanal ortamı etkinleştirip npm ci --omit=dev komutuyla kurulur.

Bu modelde süreç bir süre istek gelmezse uykuya geçebilir ve ilk istekte yeniden başlar. Web sitesi ve API için bu sorun değildir; ancak arka planda sürekli çalışması gereken işler (zamanlayıcılar, bot bağlantıları) için uygun değildir. Bu tür işleri cron job ile tetiklenen kısa betiklere bölebilir ya da VPS’e taşıyabilirsiniz.

Hangi Node.js projeleri hosting yerine VPS gerektirir?

Sürekli açık kalan bağlantı, uzun ömürlü arka plan süreci, yüksek bellek ya da işletim sistemi seviyesinde paket isteyen her Node.js projesi paylaşımlı hosting yerine VPS gerektirir. Hostingdeki kaynak sınırları (eşzamanlı süreç, bellek, CPU süresi) çok kiracılı ortamın adil çalışması için vardır ve bu iş yükleriyle çakışır.

Aşağıdaki durumlardan biri sizin için geçerliyse doğrudan VPS sunucu seçin:

• WebSocket ve Socket.IO: Binlerce açık bağlantı, sürecin hiç uyumamasını gerektirir.
• Kuyruk işçileri: BullMQ, Agenda gibi kütüphaneler Redis’e ve sürekli çalışan işçiye ihtiyaç duyar.
• Headless tarayıcı: Puppeteer ve Playwright, Chromium ve sistem kütüphaneleri ister; paylaşımlı ortamda kurulamaz.
• Botlar: Discord, Telegram ve WhatsApp botları 7/24 açık bağlantı tutar; ayrıntılar için Discord bot hosting sayfasına bakın.
• Kapsayıcı (container) tabanlı dağıtım: Projeniz Dockerfile ile geliyorsa Docker sunucu kiralama daha uygundur.

VPS’te uygulamayı PM2 ile süreç yöneticisine bağlar, Nginx’i reverse proxy olarak önüne koyarsınız. Adım adım kurulum için Node.js uygulaması yayınlama: PM2 ve Nginx rehberini izleyin. Trafik büyüyüp komşu etkisinden tamamen kurtulmak istediğinizde çekirdeklerin size ayrıldığı VDS sunucu bir sonraki basamaktır.

Node.js için Linux hosting mi, VPS mi, VDS mi?

Kısa yanıt: istek geldiğinde çalışan web uygulaması ve API için Linux hosting, sürekli açık süreç ya da sistem paketi gerektiren işler için VPS, sabit ve öngörülebilir performans gereken yoğun üretim yükü için VDS seçin. Üç seçenek aynı kodu çalıştırır; fark, yönetim sorumluluğu ve kaynak garantisindedir.

Tam root ile gelen esnekliğin bedeli, işletim sistemi güncellemelerinin, güvenlik duvarının ve yedek planının sizde olmasıdır. Sunucu yönetimi deneyiminiz yoksa projenin ilk aşamasını hostingde başlatıp darboğaz ortaya çıktığında taşımak çoğu ekip için en verimli yoldur. Karar verirken paylaşımlı hosting mi VPS mi yazısındaki ölçütler de işinize yarar. Paket içerikleri ve güncel değerler bu sayfadaki paket tablosunda yer alır.

Git ile Node.js dağıtımı nasıl otomatikleştirilir?

En sade otomatik dağıtım; kodu Git deposundan çekmek, üretim bağımlılıklarını kurmak, gerekiyorsa veritabanı geçişlerini çalıştırmak ve uygulamayı yeniden başlatmaktan oluşan dört adımlık bir betiktir. Bu betiği SSH üzerinden elle ya da CI hattından tetikleyebilirsiniz.

cd ~/uygulamalar/api
git pull --ff-only origin main
npm ci --omit=dev
npx prisma migrate deploy
mkdir -p tmp && touch tmp/restart.txt

Son satır Passenger’a uygulamayı bir sonraki istekte yeniden başlatmasını söyler; panelden “Restart” düğmesine basmakla aynı etkiyi yapar. VPS’te bunun yerine pm2 reload api komutu kesintisiz yeniden yükleme yapar.

İyi bir dağıtım düzeni için şu alışkanlıkları edinin:

• Doğrudan sunucuda dosya düzenlemeyin; her değişiklik depodan gelsin.
• Ana dal (main) yalnız test edilmiş kodu içersin; denemeleri ayrı bir alt alan adında (ör. test.alanadiniz.com) ikinci bir Node.js uygulaması olarak çalıştırın.
• Her yayından önce veritabanının anlık bir dökümünü alın; geri dönüş planı olmadan şema değişikliği yapmayın.

SSH anahtarıyla parolasız bağlantı kurmak hem güvenliği artırır hem de CI’ın sunucuya bağlanmasını kolaylaştırır; SSH anahtarınızı panele ekleyerek başlayabilirsiniz.

Express, Next.js, NestJS ve Nuxt için nelere dikkat etmelisiniz?

Çatının (framework) türü, uygulamanın nasıl derleneceğini ve hangi dosyanın başlangıç noktası olacağını belirler. Express ve Fastify gibi yalın çatılar doğrudan çalışır; Next.js, Nuxt ve NestJS ise önce derlenip sonra derlenmiş çıktıdan başlatılır.

En sık atlanan nokta şudur: derleme (build) ile çalıştırma (runtime) farklı kaynak ister. Next.js derlemesi birkaç dakika boyunca yüksek bellek tüketebilir; hostingde kaynak sınırına takılmak yerine derlemeyi kendi bilgisayarınızda ya da CI hattında (GitHub Actions, GitLab CI) yapın ve yalnız çıktıyı Git veya SFTP ile gönderin. Siteniz aslında hiç sunucu tarafı işleme kullanmıyorsa statik dışa aktarım ile Node.js’e hiç ihtiyaç duymadan web hosting üzerinde yayınlayabilirsiniz.

Veritabanı ve ortam değişkenleri nasıl yönetilir?

Linux hostingde Node.js uygulamanız aynı hesaptaki MySQL veya MariaDB veritabanını localhost üzerinden kullanır; PostgreSQL, MongoDB ya da Redis gerekiyorsa bunları VPS’te kendiniz kurmanız gerekir. Veritabanını panelde oluşturup kullanıcıyı yetkilendirdikten sonra bağlantı bilgisini kod yerine ortam değişkenine yazın.

Node.js tarafında mysql2 sürücüsü, Prisma, Drizzle, TypeORM ya da Sequelize ile MariaDB sorunsuz çalışır. Prisma kullanıyorsanız prisma generate adımını derleme sırasında, prisma migrate deploy adımını ise dağıtımdan sonra SSH’de çalıştırın.

Ortam değişkenleri için iki kural yeterlidir:

1. Gizli bilgiyi depoya koymayın. .env dosyasını .gitignore içine ekleyin; değerleri paneldeki ortam değişkeni alanına ya da uygulama kökünde, web’den erişilemeyen bir .env dosyasına yazın.
2. Ortamı açıkça belirtin. NODE_ENV=production tanımlı değilse Express ayrıntılı hata sayfası gösterir, birçok kütüphane önbelleği kapatır ve uygulama belirgin biçimde yavaşlar.

Node.js 24 ve sonrası node --env-file=.env app.js ile .env dosyasını ek paket olmadan okuyabilir; VPS’te PM2 ya da systemd ile bu bayrağı kullanmak dotenv bağımlılığını gereksiz kılar.

Node.js uygulaması nasıl hızlandırılır?

Node.js uygulamasını hızlandırmanın en etkili yolları üretim modunda çalıştırmak, statik dosyaları uygulamadan değil web sunucusundan sunmak ve tekrar eden sorguları önbelleğe almaktır. Node.js tek iş parçacıklı olay döngüsüyle çalıştığından, döngüyü bloklayan her senkron işlem tüm kullanıcıları bekletir.

• Statik dosyaları ayırın: Görseller, CSS ve JavaScript paketleri Express’in express.static ara katmanı yerine doğrudan web sunucusundan ya da bir CDN üzerinden sunulsun.
• Sıkıştırma ve önbellek başlıkları: Sıkıştırmayı uygulamada değil sunucu katmanında yapın; değişmeyen varlıklara uzun Cache-Control süresi verin.
• Senkron çağrılardan kaçının: fs.readFileSync, büyük JSON ayrıştırma ve şifre özetleme (bcrypt) gibi işleri ya asenkron sürümleriyle ya da işçi iş parçacığına (worker_threads) taşıyarak yapın.
• Bağlantı havuzu: Her istekte yeni veritabanı bağlantısı açmayın; mysql2 ya da ORM havuzunu kullanın.
• Kümeleme: VPS’te PM2’nin -i max küme modu, uygulamayı çekirdek sayısı kadar süreçle çalıştırır.

LIONFIN Linux hosting paketlerinde NVMe disk, node_modules gibi on binlerce küçük dosyadan oluşan klasörlerin okunmasını hızlandırır; yine de yavaşlığın kaynağı çoğu zaman diskte değil, ölçülmemiş bir sorgudadır. Sorunu bulmak için önce console.time ya da bir APM aracıyla en yavaş uç noktayı belirleyin.

Node.js uygulamasının güvenliği ve yedeklemesi nasıl sağlanır?

Node.js güvenliğinin temeli bağımlılık zincirini kontrol altında tutmak, gizli bilgileri korumak ve uygulamayı yalnız HTTPS üzerinden sunmaktır. npm ekosisteminde bir projenin yüzlerce dolaylı bağımlılığı olur; saldırıların önemli kısmı bu zincirden gelir.

1. Kilit dosyası: package-lock.json dosyasını depoya ekleyin ve sunucuda npm install yerine npm ci kullanın; böylece test ettiğiniz sürümlerin aynısı kurulur.
2. Düzenli denetim: npm audit çıktısını her dağıtımdan önce kontrol edin, kritik açıkları bekletmeyin.
3. Güvenlik başlıkları: Express’te helmet ara katmanı ve giriş/kayıt uç noktalarında istek sınırlama (rate limit) kullanın.
4. HTTPS: Panelden ücretsiz Let’s Encrypt sertifikasını etkinleştirin ve HTTP isteklerini HTTPS’e yönlendirin.
5. Uygulama kökü: Kaynak kod, .env ve node_modules web’den doğrudan indirilebilecek bir klasörde durmasın.

Yedeklemede kodu Git deponuz zaten korur; asıl korunması gereken veritabanı ve kullanıcıların yüklediği dosyalardır. Hosting hesabının otomatik yedeğine ek olarak kritik veritabanını düzenli olarak mysqldump ile dışarı alın ve farklı bir konumda saklayın. Dağıtımlarınızı sürüm etiketiyle (git tag) yaparsanız hatalı bir sürümde önceki etikete dönmek dakikalar sürer.

Node.js barındırmada altyapı neden önemlidir?

Node.js uygulaması ne kadar iyi yazılmış olursa olsun, yanıt süresini disk hızı, ağ kapasitesi ve kesintisiz izleme belirler. API’niz mobil uygulamanın her ekranında çağrılıyorsa birkaç saniyelik kesinti bile kullanıcıya hata ekranı olarak döner.

LIONFIN altyapısında Node.js uygulamalarınızı etkileyen başlıca unsurlar şunlardır:

• NVMe disk: Bağımlılık klasörlerinin ve veritabanı dosyalarının okunması, SATA SSD’ye göre belirgin biçimde daha az bekler.
• 600 Gbit/s toplam upstream kapasitesi: Yoğun saatlerde ve büyük dosya indirmelerinde ağ tıkanıklığı riskini azaltır.
• RouteFence firewall: Ağ seviyesinde DDoS filtreleme, uygulamanıza ulaşmadan önce saldırı trafiğini ayıklar.
• 7/24 NOC ve SOC izleme: Ağ ve güvenlik olayları gece de takip edilir; hedeflenen uptime oranı %99,99’dur (bu bir hedeftir, garanti değildir).
• Türkiye’de veri merkezi: Kullanıcılarınız Türkiye’deyse istekler kısa yoldan gider; kişisel veri işleyen projelerde veri konumu da önem kazanır.

Uygulama tarafında ise sağlık kontrolü (health check) uç noktası eklemek, harici bir izleme aracıyla dakikalık kontrol yapmak ve hata kayıtlarını düzenli okumak, sorunları kullanıcılardan önce görmenizi sağlar. Sunucu izleme ve uptime takibi yazısı bu konuda pratik araçlar önerir.

Node.js hostingde en sık karşılaşılan hatalar nelerdir?

Node.js hostingde hataların çoğu yanlış başlangıç dosyası, eksik bağımlılık, modül sistemi uyumsuzluğu ya da kaynak sınırından kaynaklanır. Sorunu bulmak için önce panelin uygulama günlüğüne (log) ya da SSH’de uygulama klasöründeki hata kaydına bakın.

• 503 veya “uygulama başlatılamadı”: Başlangıç dosyası yolu hatalıdır ya da uygulama açılırken istisna fırlatıyordur. SSH’de node app.js ile elle çalıştırıp hatayı görün.
• “Cannot find module”: Bağımlılıklar kurulmamış ya da derleme çıktısı (dist) yüklenmemiştir. npm ci çalıştırın, TypeScript projelerinde derlenmiş dosyayı başlatın.
• “require is not defined in ES module scope”: package.json içinde "type": "module" varsa require yerine import kullanmalı ya da dosyayı .cjs uzantısıyla adlandırmalısınız.
• EADDRINUSE / port hatası: Sabit port (ör. 3000) yazılmıştır; process.env.PORT kullanın.
• Derleme sırasında bellek hatası: “JavaScript heap out of memory” görüyorsanız derlemeyi sunucuda değil CI’da yapın.
• Değişiklik görünmüyor: Dosyaları güncelledikten sonra uygulamayı panelden yeniden başlatın (restart); Passenger eski süreci bellekte tutar.

Çözemediğiniz durumda müşteri panelinden destek talebi açarken uygulama kökünü, Node.js sürümünü ve hata kaydının son satırlarını eklemeniz çözümü hızlandırır.