İçeriğe geç
zefıly

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. 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. 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. 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. 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. 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. 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. 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. 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.

Ücretsiz başla

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →