Plesk Panel’de Node.js Uygulaması Yayınlama Adımları

h1>Plesk Panel’de Node.js Uygulaması Yayınlama Adımları

Plesk, Node.js uygulamalarını hızlıca dağıtmak ve yönetmek için kolay bir grafik arayüz sunar. Özellikle Express.js, Nest.js veya Next.js gibi framework’lerle geliştirilen uygulamaların barındırılması, birkaç basit adımla yapılabilir. Bu rehberde, Plesk panel üzerinde Node.js projesini yükleme, yapılandırma ve yayınlama süreçlerini detaylı olarak anlatıyoruz.

1. Plesk Node.js Uzantısının Aktif Olduğundan Emin Olun

Öncelikle Plesk panelinizde Node.js desteğinin aktif olduğundan emin olun:

1. Plesk’e giriş yapın.
2. Extensions (Eklentiler) sekmesine gidin.
3. Arama kutusuna Node.js yazın ve eklentiyi yükleyin.
4. Kurulumdan sonra, menüde “Node.js” sekmesi görünecektir.

Eğer eklenti bulunamıyorsa, sistem yöneticinizden plesk installer --select-release-current --install-component nodejs komutunu çalıştırmasını isteyin.

2. Node.js Uygulama Dosyalarını Yükleyin

Plesk’te uygulama dosyalarınızı yüklemenin birkaç yolu vardır:

• File Manager üzerinden dosya yükleme
• Git Integration eklentisiyle GitHub veya GitLab’dan otomatik çekme
• FTP/SFTP kullanarak manuel yükleme

Uygulama dosyalarınızı genellikle httpdocs/ veya özel bir alt klasör (örneğin app/) altına yükleyin.

3. Node.js Uygulamasını Etkinleştirin

1. Plesk sol menüsünden ilgili domaini seçin.
2. “Node.js” sekmesine tıklayın.
3. “Enable Node.js” butonuna basın.
4. Application Root kısmında projenizin dizinini seçin (örnek: httpdocs/app).
5. Application Startup File alanına uygulamanın giriş dosyasını yazın (örnek: app.js veya server.js).

Son olarak, “Restart App” butonuna tıklayarak uygulamayı başlatın.

4. Node.js Sürümünü Seçin

Plesk, birden fazla Node.js sürümünü destekler. Uygulamanızın gerektirdiği sürümü seçmek için:

Plesk → Node.js → Node.js Version → Örneğin v18.16.0

Doğru sürümü seçmek, özellikle framework bağımlılıkları açısından önemlidir.

5. Ortam Değişkenleri (Environment Variables) Tanımlayın

API anahtarları, veritabanı bağlantıları veya uygulama modları için ortam değişkenlerini tanımlayın:

NODE_ENV=production
PORT=3000
DATABASE_URL=mysql://user:pass@localhost:3306/db

Bunu Plesk’te Node.js → Environment Variables sekmesinden kolayca ekleyebilirsiniz.

6. NPM Paketlerini Kurun

Uygulamanızın bağımlılıklarını yüklemek için Plesk arayüzünden “NPM install” butonuna tıklayın veya SSH üzerinden:

cd httpdocs/app
npm install --production

7. Reverse Proxy (Ters Vekil) Ayarlarını Yapılandırın

Plesk’te Node.js uygulamaları genellikle 127.0.0.1:3000 gibi dahili bir portta çalışır. Dışarıdan erişim için Nginx üzerinden yönlendirme yapılır.

Plesk bu yönlendirmeyi otomatik olarak uygular, ancak özel kural eklemek isterseniz:

location / {
  proxy_pass http://127.0.0.1:3000;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
}

8. HTTPS (SSL) Sertifikasını Aktifleştirin

Güvenli bağlantı sağlamak için Let’s Encrypt veya özel SSL sertifikanızı etkinleştirin:

Plesk → Websites & Domains → SSL/TLS Certificates → Let's Encrypt

9. Günlükleri (Logs) İzleme

Uygulamanın çalışma durumunu ve hataları izlemek için:

Plesk → Node.js → Logs

Ayrıca SSH üzerinden:

tail -f ~/logs/nodejs-app.log

10. PM2 Kullanarak Sürekliliği Artırma

Plesk varsayılan olarak kendi process yönetimini sağlar, ancak gelişmiş süreç yönetimi için PM2 kullanabilirsiniz:

npm install -g pm2
pm2 start app.js --name "plesk-app"
pm2 startup

11. Gelişmiş Dağıtım (Git Deploy / CI-CD)

Plesk Git uzantısıyla GitHub veya GitLab’dan otomatik güncellemeleri çekebilirsiniz. Her push işleminde otomatik deploy tetiklenir.

Plesk → Git → Repository URL → Deployment Path → Enable Auto Deploy

12. Sorun Giderme

• 502 Bad Gateway: Node.js uygulaması durdu veya yanlış portta çalışıyor olabilir.
• Cannot GET /: Uygulamanın kök rotası tanımlanmamış olabilir.
• Permission Denied: Dosya izinlerini kontrol edin (chmod 755).

Sonuç

Plesk, Node.js uygulamalarını barındırmak için güçlü, kolay ve otomatik bir yönetim ortamı sunar. Doğru yapılandırmayla, hem performans hem de güvenlik açısından sorunsuz bir yayın süreci elde edebilirsiniz. Kurumsal düzeyde Node.js altyapıları için HostLigo Premium VDS ve Sunucu Barındırma çözümleri önerilir.