Geliştiricilerin vazgeçilmezi olan NodeJS uygulamalarını (ExpressJS, React SSR vb.) yıllarca pahalı Terminal / Linux sunucularında Varnish ve PM2 arkasında kurmaya çalıştık. Ancak modern cPanel NodeJS Selector uygulamasıyla bu süreç sadece 3 dakikaya düştü. NodeJS'i cPanel'de nasıl canlandıracağınıza bakıyoruz.
Paylaşımlı Hosting Üzerinde NodeJS Olur mu?
Geçmişte NodeJS sadece root izni olan bir VDS (Sanal Sunucu) istiyordu. Ancak CloudLinux işletim sisteminin geliştirdiği Node.js Selector modülü sayesinde, HazalHost'un sağladığı cPanel hostinglerde SSH terminaline dahi 1 saniye bile girmeden uygulamanızı (npm install ve run) tek tıklamayla arkaplanda daemon olarak çalıştırabilirsiniz.
Adım 1: Dosyaları Sunucuya Yükleme
Dosyalarınızı File Manager (Dosya Yöneticisi) ile yüklerken en sık yapılan hata kodları doğrudan public_html altına atmaktır. NodeJS dosyalarınızı GÜVENLİK GEREĞİ public_html içine atmayın!
Ana dizinde (Örn: /home/kullaniciadi klasöründe), public_html ile yan yana "uygulamam" isminde gizli bir klasör oluşturun (/home/kullaniciadi/uygulamam/) ve zip içindeki app.js, package.json kodlarınızı buraya çıkarın.
Adım 2: Setup Node.js App (Uygulama Kurulumu)
Dosyalar yerinde, şimdi de çalıştıralım:
- cPanel arayüzünüze girin, Yazılım (Software) sekmesi altından "Setup Node.js App" ikonuna tıklayın.
- CREATE APPLICATION diyerek yeni uygulama ekleyin.
- Node.js versiyonu: Kodunuzun çalıştığı (Tercihen 18.x veya 20.x) modern bir sürüm seçin.
- Application Mode: Canlı bir siteyse
Productionseçin ki hata kodları ekrana basılmasın, loglar kapansın. - Application Root: Kodları az önce attığımız gizli klasörün adını girin (Örn:
uygulamam). - Application URL: Sitenizi hangi alanda yayınlayacaksanız (Genelde Domaininiz - hazalhost.com boş bırakılarak) onu seçin.
- Application Startup File: Projenizin ayaklandıran ilk ana tetikleyici dosyasını yazın (Sıklıkla
app.js,server.jsveyaindex.jsolur).
Create tuşuna basın. Uygulamanız sisteme tanımlandı!
Adım 3: NPM Paketlerini Kurma (NPM Install)
Karşınıza çıkan ekrandaki bilgilerin okturduğu sütunda "Run NPM Install" tuşu belirecektir.
Bu tuşa bastığınızda, sistem sizin yerinize terminal üzerinde girip (Sizin Linux komutu yazmanıza gerek bırakmadan) package.json dosyanızı okuyacak ve ihtiyaç duyduğunuz modülleri node_modules klasörüne yükleyecektir.
🚀 HazalHost Cpanel'de Tam NodeJS Desteği!
Klasik hostinglerin desteklemediği Python, Ruby ve Node.js yazılım dilleri, HazalHost'un premium barındırma alt yapısında CloudLinux teknolojisiyle %100 yerleşik (Native) olarak desteklenmektedir. Yeni nesil uygulamalarınız için sunucu yönetmekle zaman kaybetmezsiniz.
Adım 4: Başlatma ve Hata Tespiti
Her şey bittiğinde "START APP" diyebilirsiniz. Siteniz belirttiğiniz domainde yayına geçecektir.
Neden 503 Hatası Alıyorum?:
Eğer site 503 verirse ya kodlarınızda bir bug (hata tespit) vardır ya da port dinleme sorunu vardır. Phusion Passenger (cPanel nodejs yöneticisi), Node sunucunuza varsayılan portu enjekt eder. Kodunuzda port kısmını sert olarak (Örn: listen(3000)) yazmak yerine Çevresel Değişken (ENV) kullanarak ayarlayın:
// Hatalı Kod = app.listen(3000);
// Cpanel Uyumlu Doğru Kod:
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => console.log('Sunucu Başladı!'));
Sonuç
Kullanıcı yetkilendirmesi, Express API yönlendirmeleri devasa olan NodeJS projelerinizi yayınlamak için sadece Docker beklemeyin. cPanel'in CloudLinux Node.js yöneticisi işleri 3 dakikada üretim ortamına (Production) hazırlar.