cPanel'de Node.js Uygulaması Nasıl Çalıştırılır? Hosting Ne Zaman Yeter, VDS Ne Zaman Gerekir? (2026)

Kısa cevap: cPanel'de Node.js uygulaması, "Setup Node.js App" aracıyla altı adımda yayına alınır: uygulamayı oluşturur, dosyaları yükler, bağımlılıkları kurar ve yeniden başlatırsınız. Express ile yazılmış bir API, küçük bir yönetim paneli ya da form işleyen basit bir servis için paylaşımlı hosting yeterlidir. Sürekli açık kalan bağlantılar (WebSocket), arka planda kesintisiz çalışan işler, Docker, Redis ya da MongoDB gerektiğinde ise VDS'e geçmeniz gerekir. TuemCloud hosting paketlerinde Node.js 20 kullanılabilir.

Öne Çıkanlar

  • cPanel'de Node.js uygulamaları "Setup Node.js App" bölümünden yönetilir; SSH bilmeden kurulum yapılabilir.
  • Uygulamanız belirli bir portu dinlemek zorunda değildir; sunucu isteği uygulamaya kendisi iletir. Kodda process.env.PORT kullanmak yeterlidir.
  • Hostingde uygulama bir süre istek almazsa uyur ve ilk istekte yeniden başlar. Bu yüzden zamanlayıcıyla sürekli çalışması gereken işler hostinge uygun değildir.
  • WebSocket, kuyruk işçisi, Docker ve kendi veritabanı sunucunuz gerekiyorsa doğru adres VDS'tir.
  • Hosting paketleri aylık 35,95 TL'den, VDS paketleri aylık 200 TL'den başlar.

cPanel Hostingde Node.js Çalışır mı?

Evet, hosting firması bu özelliği açtıysa çalışır. cPanel tek başına Node.js uygulaması yönetmez; bu özellik CloudLinux'un Node.js Selector bileşeniyle gelir ve cPanel'de "Setup Node.js App" adıyla görünür. TuemCloud'un cPanel hosting paketlerinde bu araç etkindir ve Node.js 20 sürümü kullanılır. Panelinizde "Yazılım" başlığı altında bu simgeyi görüyorsanız kuruluma hazırsınız.

cPanel'de Node.js Uygulaması 6 Adımda Nasıl Kurulur?

  1. Setup Node.js App bölümünü açın. cPanel'e girin, "Yazılım" başlığı altındaki "Setup Node.js App" simgesine tıklayın ve "Create Application" düğmesine basın.
  2. Uygulama ayarlarını girin.
    • Node.js version: 20
    • Application mode: Production
    • Application root: Dosyaların duracağı klasör, örneğin uygulamam. Bu klasörü public_html dışında tutun; kaynak kodunuz tarayıcıdan erişilebilir olmasın.
    • Application URL: Uygulamanın açılacağı alan adı ya da alt alan adı, örneğin api.siteniz.com.
    • Application startup file: Başlangıç dosyası, örneğin app.js.
    "Create" düğmesine basın.
  3. Dosyaları yükleyin. Dosya Yöneticisi, FTP ya da Git ile proje dosyalarınızı uygulama klasörüne yükleyin. node_modules klasörünü yüklemeyin; sunucuda kurulacak.
  4. Bağımlılıkları kurun. Uygulama sayfasında package.json algılandığında "Run NPM Install" düğmesi etkinleşir. Tıklayın ve bitmesini bekleyin.
  5. Ortam değişkenlerini ekleyin. Veritabanı şifresi ve API anahtarı gibi değerleri koda yazmak yerine aynı sayfadaki "Environment variables" bölümüne girin.
  6. Uygulamayı yeniden başlatın. "Restart" düğmesine basın ve adresi tarayıcıda açın.

En Basit Express Örneği Nasıl Olmalı?

Aşağıdaki iki dosya, kurulumun doğru çalıştığını görmek için yeterlidir.

package.json:

{
  "name": "uygulamam",
  "version": "1.0.0",
  "main": "app.js",
  "dependencies": {
    "express": "^4.19.2"
  }
}

app.js:

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Node.js uygulaması çalışıyor');
});

app.listen(process.env.PORT || 3000);

Dikkat edilecek tek nokta son satırdır: portu sabit yazmayın. Hostingde isteği uygulamanıza sunucu iletir; process.env.PORT ifadesi hem hostingde hem kendi bilgisayarınızda çalışır.

En Sık Karşılaşılan Hatalar Nelerdir?

  • 503 ya da "Incomplete response" hatası: Uygulama başlarken çöküyor demektir. Başlangıç dosyasının adını ve bağımlılıkların kurulduğunu kontrol edin; hata ayrıntısı uygulama klasöründeki stderr.log dosyasında yazar.
  • "Cannot find module" hatası: "Run NPM Install" çalıştırılmamış ya da package.json eksiktir.
  • Değişiklik görünmüyor: Dosyayı güncelledikten sonra "Restart" düğmesine basmanız gerekir.
  • Derleme sırasında bellek hatası: Büyük ön yüz projelerinde derleme adımı paketin bellek sınırını aşabilir. Projeyi kendi bilgisayarınızda derleyip çıktıyı yükleyin ya da daha yüksek bellekli bir pakete geçin.
  • İlk istek yavaş: Uygulama bir süre istek almayınca uyur; ilk istekte yeniden başladığı için birkaç saniye gecikir. Bu, paylaşımlı hostingin normal davranışıdır.

Hosting Hangi Node.js Projeleri İçin Yeterli?

  • Express ya da benzeri bir çatıyla yazılmış REST API'ler
  • İletişim formu, teklif formu gibi veriyi alıp e-posta gönderen küçük servisler
  • Az kullanıcılı yönetim panelleri ve iç araçlar
  • MySQL veritabanı kullanan küçük ve orta ölçekli web uygulamaları
  • Önceden derlenmiş (statik) ön yüzü olan projelerin arka ucu

Bu tür projelerde hosting hem ucuz hem zahmetsizdir: sunucu güncellemesi, güvenlik duvarı ve SSL yenilemesiyle siz uğraşmazsınız.

Hangi Durumlarda VDS'e Geçmek Gerekir?

İhtiyaçPaylaşımlı hostingVDS
REST API, küçük web uygulamasıUygunUygun
WebSocket, canlı sohbet, anlık bildirimUygun değilUygun
Sürekli çalışan bot ya da kuyruk işçisiUygun değil (uygulama uyur)Uygun
Docker ile dağıtımYokVar
Redis, MongoDB, PostgreSQLYok (yalnızca MySQL)İstediğinizi kurarsınız
PM2 ile süreç yönetimi, birden çok çekirdekYokVar
İstediğiniz Node.js sürümüSunucuda kurulu sürümDilediğiniz sürüm
Root erişimiYokVar
Sunucu yönetimiBizdeSizde

Kısacası uygulamanız "istek gelir, cevap verir, biter" biçiminde çalışıyorsa hosting yeterlidir. Bağlantıyı açık tutuyor, arka planda kendi kendine iş yapıyor ya da MySQL dışında bir servise ihtiyaç duyuyorsa VDS gerekir.

Next.js, NestJS ve Socket.IO Hostingde Çalışır mı?

  • NestJS ve Express: Çalışır. NestJS'te projeyi derleyip başlangıç dosyası olarak dist/main.js göstermeniz gerekir.
  • Next.js: Statik dışa aktarılan siteler sorunsuz yayınlanır. Sunucu tarafında işleme (SSR) yapan projeler özel bir başlangıç dosyasıyla çalıştırılabilir, ama derleme belleği ve uyku davranışı yüzünden trafik alan projelerde VDS daha sağlıklıdır.
  • Socket.IO ve diğer WebSocket kütüphaneleri: Paylaşımlı hostingde kararlı çalışmaz; VDS kullanın.

VDS'te Node.js İçin Hangi Paket Seçilmeli?

  • Tek uygulama, küçük trafik: 1 çekirdek, 2 GB RAM'li başlangıç paketi yeterlidir. VDS paketleri aylık 200 TL'den başlar.
  • Uygulama ile birlikte Redis ya da veritabanı: 2 çekirdek ve 4 GB RAM ile başlayın.
  • Next.js SSR, birden çok servis ya da Docker: 4 çekirdek ve 8 GB RAM rahat çalışır.

Tüm paketlerde NVMe disk kullanılır ve sunucu ödeme sonrası ortalama 5 dakikada teslim edilir. Paketleri VDS sunucu kiralama sayfasında karşılaştırabilirsiniz. Önce hostingle başlayıp proje büyüdüğünde VDS'e geçmek de mümkündür; kodunuzda değişiklik yapmanız gerekmez.

Sıkça Sorulan Sorular

cPanel'de "Setup Node.js App" simgesini göremiyorum, neden?

Bu özellik her hosting firmasında açık değildir; sunucuda CloudLinux Node.js Selector kurulu olmalıdır. TuemCloud cPanel hosting paketlerinde etkindir. Göremiyorsanız destek ekibine yazmanız yeterlidir.

Hostingde hangi Node.js sürümünü kullanabilirim?

TuemCloud hosting paketlerinde Node.js 20 kullanılır. Farklı bir sürüme ihtiyacınız varsa VDS'te dilediğiniz sürümü kurabilirsiniz.

Node.js uygulamam ile WordPress sitem aynı hostingde çalışır mı?

Evet. Node.js uygulamasını bir alt alan adına (örneğin api.siteniz.com) kurarsanız ana alan adınızdaki WordPress sitesi etkilenmez.

Hostingde Node.js için ayrıca ücret ödenir mi?

Hayır, hosting paketine dahildir. Uygulamanız paketin işlemci ve bellek sınırları içinde çalışır.

Uygulamam çökerse kendiliğinden yeniden başlar mı?

Hostingde uygulamayı sunucu yönetir; çöken süreç bir sonraki istekte yeniden başlatılır. VDS'te bunu PM2 ya da systemd ile siz ayarlarsınız.

Hostingden VDS'e geçerken kodu değiştirmem gerekir mi?

Hayır. Portu process.env.PORT ile okuyan bir uygulama iki ortamda da aynı kodla çalışır. Yalnızca dağıtım yöntemi değişir.

Sonuç

Node.js uygulaması yayınlamak için her zaman sunucu yönetmeniz gerekmez. İstek alıp cevap veren bir API ya da küçük bir panel, cPanel'deki "Setup Node.js App" aracıyla dakikalar içinde yayına girer ve aylık maliyeti bir hosting paketinin fiyatıdır. Uygulamanız sürekli bağlantı tutuyor, arka planda iş çalıştırıyor ya da Docker ve Redis gibi bileşenlere ihtiyaç duyuyorsa VDS doğru seçimdir. Küçük projeler için cPanel hosting paketlerimize, daha fazlası için VDS sunucu paketlerimize göz atabilirsiniz.

İlgili Rehberler