Kendi sunucunuzda Node.js hosting
Zefily Node.js uygulamanızı yerel bir port üzerinde systemd hizmeti olarak çalıştırır. Önündeki web sunucusu alan adını, HTTPS'i ve statik dosyaları yönetir; her dağıtım yeni sürüme geçmeden önce uygulamayı derler.
Başlamadan önce
- Web yığını kurulu, Zefily'ye bağlı bir sunucu.
- Git'te package-lock.json dosyası commit edilmiş bir Node.js uygulaması.
- DNS'i sunucuya işaret eden bir alan adı.
Adımlar
-
1. Node.js'i kurun
Sunucunun web yığınında Node.js'i kur'a tıklayın ve 22, 24 ya da 26'yı seçin. Uygulamanızın derlendiği ve test edildiği sürümü seçin.
-
2. Siteyi ekleyin
Siteler, ardından Site ekle'yi seçin. Çalışma ortamı: Node.js ve sürümünü seçip alan adını girin. Zefily uygulamaya boş bir yerel port atar.
-
3. Git dağıtımını ayarlayın
Sitenin Dağıtım sekmesinde Node.js ön ayarını ve deponuzu seçin. Derleme komutları npm ci ve npm run build --if-present, başlatma komutu npm start'tır.
-
4. Atanan adres ve porttan dinleyin
Uygulama 127.0.0.1 üzerinde ve ortamın verdiği PORT'tan dinlemelidir; sabit bir port kullanmayın. Ortam ayrıca HOST=127.0.0.1 ve NODE_ENV=production değerlerini verir.
-
5. Kilit dosyasını commit edin
package-lock.json dosyasını commit edin. Bu dosya olmazsa ön ayar npm ci yerine npm install çalıştırır ve sürümler dağıtımlar arasında değişebilir. Yalnızca yarn.lock ya da pnpm-lock.yaml olan bir sürüm de şimdilik npm ile kurulur.
-
6. Yapılandırmayı ekleyin
Ayarları ve gizli bilgileri sitenin .env dosyasına koyun; DATABASE_URL almak için bir veritabanı bağlayın. .env dosyasını Git'e eklemeyin.
-
7. Arka plan işlerini daemon olarak çalıştırın
Kuyruk tüketicileri, zamanlayıcılar ve botlar site kullanıcısının daemon'ları olarak çalışır; çalışma klasörleri sitenin canlı current klasörüdür.
-
8. Dağıtın ve kontrol edin
Şimdi dağıt'a tıklayın. Hizmet yeni sürümde yeniden başlar. Dağıtımdan sonra yanıt vermezse site önceki sürüme kendiliğinden geri döner.
Çalıştığını doğrulama
Alan adını açın: uygulamanız HTTPS üzerinden yanıt vermelidir. Günlükler sekmesindeki Uygulama süreci çıktısı hizmetin başladığını gösterir ve bildiğiniz bir yol beklediğiniz yanıtı döndürür.
Sorun giderme
- Dağıtımdan sonra 502 Bad Gateway
- Uygulama 127.0.0.1 ve $PORT üzerinde dinlemiyor ya da başlarken çöküyor. Günlükler sekmesindeki Uygulama süreci çıktısını okuyun; site bu arada kendiliğinden geri döner.
- Sunucuda npm ci başarısız oluyor
- Kilit dosyası package.json ile uyuşmuyor. Bilgisayarınızda npm install çalıştırın, güncellenen package-lock.json dosyasını commit edip yeniden dağıtın.
- Derlemenin ihtiyaç duyduğu bir araç eksik
- Üretim kurulumları devDependencies paketlerini atlar. Derleme aracını dependencies bölümüne taşıyın.
Sorular
Hangi Node.js sürümlerini kurabilirim?
Node.js 22, 24 ve 26 kurulabilir. Uygulamanızın desteklediğini seçin; farklı siteler için birden fazla sürüm kurabilirsiniz.
pm2 ya da başka bir süreç yöneticisi gerekli mi?
Hayır. Zefily uygulamayı systemd hizmeti olarak çalıştırır ve her dağıtımda yeniden başlatır. WEB_CONCURRENCY, uygulamaya sunucunun kaç işçi süreci çalıştırabileceğini bildirir.
Nuxt, SvelteKit, Astro veya Express uygulamaları çalışır mı?
Evet. 127.0.0.1 ve atanan portta dinleyen her Node.js uygulaması aynı kurulumla ve aynı dağıtım adımlarıyla çalışır.
Devamında okuyun
Kendi sunucunuzda başlayın
Hesabınızı oluşturun, bir sunucu bağlayın ve rehberi izleyin. Sunucu size aittir: sağlayıcınıza ödersiniz.