Node.js Uygulaması Hostinge Nasıl Yüklenir

Son doğrulama: Kasım 2026 · Narhost test cPanel hesabında panel özellikleri kontrol edildi

Hızlı çözüm

Node.js uygulaması hostinge nasıl yüklenir sorusunun Narhost için kısa yanıtı: paylaşımlı ve Linux hosting paketlerinde Node.js uygulaması çalıştırılamaz. Node.js uygulaması sürekli ayakta duran bir süreç gerektirir; paylaşımlı pakette bunu sağlayacak panel aracı (Node.js Selector / Application Manager) ve SSH erişimi bulunmaz. Node.js uygulaması için kök erişimi olan bir VPS ya da VDS gerekir.

  1. Uygulamanızın kalıcı bir süreç gerektirdiğini doğrulayın (Node.js uygulamalarının hemen tamamı gerektirir).
  2. Kök erişimli bir VPS ya da VDS edinin.
  3. Sunucuya Node.js ve PM2 kurup uygulamayı arka planda başlatın.
  4. Alan adını uygulamanın portuna yönlendirin ve SSL’i tanımlayın.
Panel Yok — kurulum SSH üzerinden yapılır
Sistem VPS veya VDS (paylaşımlı / Linux hostingde desteklenmez)
Yetki root ya da sudo
Narhost ürünü VPS Sunucu, VDS Sunucu

Başlamadan önce

  • Uygulamanın kaynak dosyaları yerelde ya da bir Git deposunda hazır olsun.
  • package.json içinde bağımlılıklar ve varsa engines alanı tanımlı olsun.
  • Uygulamanın hangi ortam değişkenlerine (API anahtarı, veritabanı bağlantısı) ihtiyaç duyduğunu not edin.
  • Veritabanı kullanıyorsanız hangi sürümü istediğini belirleyin; VPS’te veritabanını siz kurarsınız.

Paylaşımlı hostingde Node.js neden çalıştırılamıyor

PHP ile Node.js’in sunucuda çalışma biçimi farklıdır. PHP’de her istek için kısa ömürlü bir işlem açılır ve iş bitince kapanır; paylaşımlı hosting tam olarak bu modele göre kurgulanmıştır. Node.js uygulaması ise sürekli ayakta duran, bir portu dinleyen tek bir süreçtir. Bu sürecin başlatılması, çökerse yeniden ayağa kaldırılması ve sunucu yeniden başladığında otomatik açılması gerekir.

Paylaşımlı pakette bunu sağlamanın iki yolu vardır ve Narhost’un paylaşımlı paketlerinde ikisi de kapalıdır:

  • Panel aracı. cPanel tarafında bu işi CloudLinux Node.js Selector (panelde Setup Node.js App adıyla görünür) ya da cPanel Application Manager üstlenir. Kasım 2026’da Narhost test hesabında yaptığımız kontrolde iki özellik de kapalıydı ve panelde görünmüyordu. Narhost, paylaşımlı paketlerde Node.js Selector’ın açılmayacağını bildirdi.
  • SSH erişimi. Komut satırından süreci kendiniz başlatıp canlı tutabilirsiniz, ancak paylaşımlı ve Linux hosting paketlerinde SSH erişimi verilmez.

Dikkat

İnternetteki pek çok rehber “cPanel’de Setup Node.js App aracını açın” diye başlar. Bu araç cPanel’in her kurulumunda bulunmaz; barındırma sağlayıcısının paketinde etkinleştirmesi gerekir. Narhost paylaşımlı paketlerinde etkin değildir, bu yüzden o rehberlerdeki adımlar burada uygulanamaz. cPanel de bu aracın neden bazı hesaplarda görünmediğini kendi destek kaydında açıklıyor.

node.js uygulaması hostinge nasıl yüklenir sorusunun cevabını gösteren barındırma türü karar şeması
Node.js uygulaması sürekli çalışan bir süreç gerektirdiği için paylaşımlı pakette değil, kök erişimli bir sunucuda barındırılır.

Node.js uygulaması hostinge nasıl yüklenir: gereken bileşenler

Uygulamayı yayına almak için kök erişimli bir sunucu ve üç bileşen gerekir:

  • Node.js çalışma ortamı. Sürümü uygulamanızın package.json dosyasındaki engines alanına göre seçersiniz; sunucuda birden fazla sürümü yan yana tutabilirsiniz.
  • Süreç yöneticisi. PM2 gibi bir araç uygulamayı arka planda başlatır, çökerse yeniden kaldırır ve sunucu yeniden başladığında otomatik açar. Bu olmadan SSH oturumunu kapattığınızda uygulama durur.
  • Ters vekil (reverse proxy). Uygulamanız 3000 gibi bir portu dinler; ziyaretçi ise 80 ve 443’ten gelir. Nginx ya da Apache gelen isteği uygulamanın portuna iletir ve SSL sertifikasını burada sonlandırırsınız.

Kurulumun komut düzeyinde anlatımı ayrı bir kartta: VPS’te Node.js kurulumu ve PM2 ile süreç yönetimi. Node.js sürümünü sunucuda yönetmek isterseniz nvm ile Node.js kurulumu kartına bakın.

Paylaşımlı hostingden VPS’e geçerken hazırlanacaklar

  1. Uygulamanın gerçekten Node.js gerektirdiğini doğrulayın. Sitenizin yalnızca derlenmiş arayüz dosyalarından (HTML, CSS, JavaScript) oluştuğu durumlar vardır; böyle bir çıktı paylaşımlı pakette de yayımlanabilir.

    Beklenen sonuç: proje klasöründe package.json içinde bir start betiği ve bir sunucu dosyası (app.js, server.js) varsa kalıcı süreç gerekiyordur.

  2. Node.js sürümünü not edin.package.json içindeki engines alanına, yoksa yerelde node -v çıktısına bakın.

    Beklenen sonuç: sunucuya kuracağınız sürüm belirlenmiş olur.

  3. Ortam değişkenlerini listeleyin. Veritabanı bağlantısı, API anahtarı ve port gibi değerleri kodun içinden çıkarıp ayrı bir listeye alın.

    Beklenen sonuç: sunucuda tanımlanacak değişkenlerin adı ve değeri hazır olur.

  4. Veritabanı ihtiyacını belirleyin. VPS yönetimsizdir; MySQL, MariaDB, PostgreSQL ya da MongoDB’yi sunucuya siz kurarsınız. Paylaşımlı paketteki veritabanınızı taşıyacaksanız önce dışa aktarın.

    Beklenen sonuç: yedek dosyanız ve kurulacak veritabanı sürümü belli olur.

  5. Alan adı ve SSL planını yapın. Uygulama yayına alındıktan sonra alan adının DNS kaydını yeni sunucuya yönlendirecek, SSL sertifikasını ters vekil üzerinde tanımlayacaksınız.

    Beklenen sonuç: geçiş anında kesinti süresi önceden bilinir.

Doğrulama

Sonuç

Paylaşımlı paketinizde Node.js desteğinin bulunup bulunmadığını kesin olarak görmek için cPanel’e girip arama kutusuna Node ve ayrıca Application yazın. İki aramada da sonuç çıkmıyorsa pakette Node.js çalıştırılamaz. Bu durumda node.js uygulaması hostinge nasıl yüklenir sorusunun cevabı, kök erişimi olan bir VPS ya da VDS üzerinde kurulum yapmaktır.

Hâlâ çözülmediyse

  • Uygulamam küçük, VPS fazla gelir mi? Node.js uygulamasının boyutu değil, sürekli çalışma ihtiyacı belirleyicidir. En küçük uygulama bile kalıcı bir süreç ister; bu yüzden paylaşımlı paket uygun değildir.
  • Projem Next.js ya da Nuxt. Bu çatılar statik dışa aktarma (static export) destekliyorsa çıktı paylaşımlı pakette yayımlanabilir. Sunucu tarafı işlevler (API uçları, SSR) kullanıyorsanız yine kalıcı süreç gerekir.
  • Hangi ürünü seçeceğimi bilmiyorum.Python ve Node.js için hangi hosting yazısı karar tablosunu içerir.

Narhost desteği

Uygulamanızın hangi pakette çalışacağından emin değilseniz destek talebinize projenin çatısını (Express, Next.js, NestJS vb.), package.json içeriğini ve kullandığınız veritabanını ekleyin; uygun ürünü birlikte belirleyelim.

Destek talebi aç

Sıkça sorulan sorular

Narhost paylaşımlı hostingde Node.js çalıştırabilir miyim?

Hayır. Node.js uygulaması sürekli ayakta duran bir süreç gerektirir; paylaşımlı ve Linux hosting paketlerinde bunu sağlayacak panel aracı (Node.js Selector / Application Manager) etkin değildir ve SSH erişimi verilmez. Node.js uygulaması için VPS ya da VDS gerekir.

cPanel’de Setup Node.js App aracını neden göremiyorum?

Bu araç cPanel’in her kurulumunda bulunmaz; CloudLinux Node.js Selector’ın sunucuda kurulu ve pakette etkin olması gerekir. Narhost paylaşımlı paketlerinde etkin değildir, bu yüzden panelde görünmez.

Statik olarak dışa aktardığım bir Node.js projesini paylaşımlı pakette yayımlayabilir miyim?

Evet. Derleme sonunda yalnızca HTML, CSS ve JavaScript dosyaları üretiliyorsa bu çıktı paylaşımlı pakette yayımlanabilir; çalışan bir Node.js süreci gerekmez. Sunucu tarafı işlev kullanan projelerde bu yöntem işe yaramaz.

VPS’te Node.js uygulamasını canlı tutmak için ne gerekiyor?

Bir süreç yöneticisi gerekir. PM2 uygulamayı arka planda başlatır, çökerse yeniden kaldırır ve sunucu yeniden başladığında otomatik açar. Kurulum adımları VPS’te Node.js kurulumu ve PM2 kartında anlatılır.

Bu makale sorununuzu çözdü mü?

Çözemediniz mi?

Teknik ekibimiz sunucu tarafındaki ayarları sizin için kontrol edebilir. Destek talebinizde alan adınızı ve aldığınız hata metnini paylaşmanız süreci hızlandırır.

Etiketler: nodejs

İlgili çözümler