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

Son gözden geçirme: Eylül 2026 · cPanel Application Manager (Setup Node.js App) resmî dokümanına göre

Node.js uygulaması cPanel’de nasıl çalışır

Paylaşımlı ve Linux hosting paketlerinde SSH erişimi yoktur; komut satırından bir süreci başlatıp arka planda canlı tutamazsınız. Setup Node.js App aracı bu işi Phusion Passenger üzerinden yönetir: uygulamanızı arka planda başlatır, çökerse yeniden ayağa kaldırır ve gelen istekleri sizin tanımladığınız URL üzerinden uygulamaya iletir. Kurulum, güncelleme ve yeniden başlatma dahil tüm işlemler panelden yapılır.

Uygulamanız kalıcı bir soket sunucusuna, özel bir arka plan işçisine (worker) ya da belirli bir Node.js paket sürümüne bağımlıysa panel aracı yetersiz kalabilir. Bu durumda kök erişimi olan bir sunucuda kendi sürecinizi kurmanız gerekir; VPS’te Node.js PM2 kurulumu kartı bu yöntemi anlatır. Hangi hosting türünün projenize uygun olduğuna henüz karar vermediyseniz Python ve Node.js için hangi hosting yazısı karar tablosunu içerir.

Node.js uygulaması hostinge nasıl yüklenir — adım adım

1. cPanel Ana Sayfa → Yazılım → Setup Node.js App aracını açın ve Uygulama Kaydet (Register Application / Create Application) ile yeni bir kayıt başlatın.

   Beklenen sonuç: uygulama listesinde yeni satır “Durduruldu” (stopped) durumuyla görünür.

2. Deployment Domain, Application Root ve Application URL alanlarını doldurun: alan adını, kaynak dosyalarının ev dizinine göre yolunu (ör. nodeapp) ve uygulamanın erişileceği adresi girin; Application Startup File kutusuna giriş dosyasını (genelde app.js ya da server.js) yazın.

   Beklenen sonuç: kayıt formunda alan adı, kök dizin ve başlangıç dosyası özet olarak listelenir.

3. Node.js sürümünü açılır listeden seçip kaydı tamamlayın; uygulamanız belirli bir sürüme bağımlıysa package.json içindeki engines alanıyla uyumlu olanı seçin.

   Beklenen sonuç: uygulama sayfası seçtiğiniz sürümü ve kayıtlı yolu gösterir.

4. Kayıttan sonra açılan uygulama sayfasında Bağımlılıkları Etkinleştir eylemini çalıştırın; panel package.json dosyasındaki paketleri sunucu tarafında kurar, SSH gerekmez.

   Beklenen sonuç: işlem tamamlanınca node_modules dizini oluşur; hata varsa ekranda paket adıyla birlikte listelenir.

5. Veritabanı bağlantısı, API anahtarı gibi bilgileri kodun içine yazmak yerine Environment Variables (Ortam Değişkenleri) bölümünden ad ve değer olarak ekleyin.

   Beklenen sonuç: eklenen değişkenler uygulama sayfasındaki listede görünür.

6. Değişiklikten sonra uygulamayı yeniden başlatın; durum “Çalışıyor” (running) olarak değişmiyorsa aynı sayfadaki günlük bağlantısından hatayı inceleyin.

   Beklenen sonuç: durum satırı “running” olur; hata varsa modül veya dosya adıyla birlikte günlükte görünür.

7. Hata sürüyorsa uygulama dizinindeki logs/ klasöründeki Passenger günlük dosyasını açın (bkz. cPanel bilgi bankası kaydı); dosya adında genelde stderr.log ya da uygulama adı geçer.

   Beklenen sonuç: son satırlar hangi modülün, portun ya da bağımlılığın sorun çıkardığını gösterir.

Doğrulama

Hâlâ çözülmediyse

• Setup Node.js App aracı panelde görünmüyor. Paketinizde bu özellik kapalı olabilir; barındırma paketinizi Linux Hosting üzerinden kontrol edin ya da destek talebi açın.
• Bağımlılıkları Etkinleştir adımında paket kurulum hatası veriyor. Node.js sürümünü package.json içindeki engines alanıyla uyumlu bir sürüme değiştirip yeniden deneyin.
• Uygulama kalıcı bir soket ya da arka plan işçisi gerektiriyor. Panel aracı bu tür süreçleri desteklemez; VPS’te Node.js PM2 kurulumu kartındaki yöntemi izleyin.