Plesk’te Node.js Nasıl Çalıştırılır? Node.js Uygulama Yayınlama Rehberi

Plesk’te Node.js çalıştırmak, JavaScript tabanlı web uygulamalarını doğrudan Plesk sunucusu üzerinde yayınlamamızı sağlar. Özellikle Express.js, NestJS, Next.js ve benzeri Node.js tabanlı projelerde Plesk üzerinden uygulama yönetimi oldukça pratiktir.

Bu rehberde Plesk üzerinde Node.js desteğinin nasıl kullanılacağını, uygulamanın nasıl yükleneceğini, Node.js sürümünün nasıl seçileceğini, bağımlılıkların nasıl kurulacağını ve uygulamanın nasıl çalıştırılacağını adım adım anlatıyoruz.

Plesk’te Node.js Desteği Nedir?

Plesk, Node.js uygulamalarını yönetmek için Node.js desteğini ve Node.js Toolkit bileşenlerini kullanır. Bu yapı sayesinde uygulamanın Node.js sürümünü, uygulama kök dizinini, document root alanını, başlangıç dosyasını ve package manager ayarlarını Plesk paneli üzerinden yönetebiliriz.

Bu özellik sayesinde Node.js uygulaması için her işlemde terminal kullanmamız gerekmez. Uygulama ayarlarının önemli bir bölümünü Plesk arayüzünden gerçekleştirebiliriz.

Plesk Node.js resmi dokümantasyonunu inceleyerek desteklenen özellikler hakkında daha ayrıntılı bilgi edinebilirsiniz.

Plesk’te Node.js Çalıştırmak İçin Gerekenler

Plesk üzerinde bir Node.js uygulaması yayınlamadan önce sunucuda gerekli bileşenlerin bulunduğundan emin olmamız gerekir.

• Plesk Obsidian kurulu bir sunucu
• Node.js desteği
• Node.js Toolkit
• Çalıştırılacak Node.js uygulaması
• package.json dosyası
• Uygulamaya uygun Node.js sürümü
• Uygulamanın başlangıç dosyası

1. Plesk’te Node.js Toolkit Kurulumu

Öncelikle Plesk panelimize yönetici hesabıyla giriş yapıyoruz.

1. Extensions bölümünü açıyoruz.
2. Node.js veya Node.js Toolkit bileşenini arıyoruz.
3. İlgili bileşeni seçiyoruz.
4. Kurulum işlemini başlatıyoruz.

Kurulum tamamlandıktan sonra alan adı bazında Node.js uygulamalarını yönetebileceğimiz seçenekler Plesk üzerinde görünür hale gelir.

2. Node.js Uygulamasını Sunucuya Yükleme

Node.js uygulamamızı Plesk sunucusuna yüklemek için birkaç farklı yöntem kullanabiliriz.

• Plesk File Manager
• FTP
• Git Repository
• SSH

Örneğin uygulamamızı aşağıdaki gibi bir dizine yükleyebiliriz:

/var/www/vhosts/example.com/httpdocs/myapp

Basit bir Node.js uygulamasının yapısı aşağıdaki gibi olabilir:

myapp/ ├── package.json ├── package-lock.json ├── app.js ├── public/ ├── routes/ └── views/

3. Plesk’te Node.js Uygulaması Açma

Uygulamamızı sunucuya yükledikten sonra Plesk panelinde ilgili alan adının yönetim ekranına geçiyoruz.

1. Websites & Domains bölümünü açıyoruz.
2. Node.js uygulamasını çalıştıracağımız alan adını seçiyoruz.
3. Node.js bölümünü açıyoruz.

Bu ekranda Node.js uygulamasının çalışma ortamıyla ilgili temel ayarları görebiliriz.

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

Uygulamamızın kullandığı Node.js sürümünün doğru seçilmesi oldukça önemlidir.

Plesk üzerinde Node.js Version alanından uygulamanın ihtiyaç duyduğu sürümü seçiyoruz.

Örneğin geliştirme ortamında uygulamamız belirli bir Node.js sürümüyle hazırlanmışsa sunucuda da uyumlu bir sürüm kullanmamız gerekir.

Özellikle framework ve npm paketlerinin Node.js sürüm gereksinimlerini kontrol etmemiz önemlidir.

5. Application Root Ayarlama

Application Root, Node.js uygulamamızın ana dizinidir.

Örneğin:

/var/www/vhosts/example.com/httpdocs/myapp

Bu dizinin içerisinde uygulamanın package.json dosyası ve diğer proje dosyaları bulunabilir.

Application Root değerinin yanlış belirlenmesi durumunda Plesk uygulamanın dosyalarını doğru şekilde algılayamayabilir.

6. Document Root Ayarlama

Document Root, web üzerinden sunulacak dosyaların bulunduğu dizindir.

Uygulamamızın yapısına bağlı olarak örneğin şu şekilde olabilir:

/var/www/vhosts/example.com/httpdocs/myapp/public

Document Root ile Application Root aynı olmak zorunda değildir.

Özellikle framework kullanan uygulamalarda yalnızca gerekli statik dosyaların web üzerinden erişilebilir olması güvenlik açısından daha doğru bir yapı oluşturabilir.

7. Startup File Belirleme

Node.js uygulamasının hangi dosyadan başlatılacağını Plesk üzerinde Application Startup File alanından belirleyebiliriz.

Örneğin uygulamamızın başlangıç dosyası app.js ise:

app.js

veya uygulamamız:

server.js

dosyasını kullanıyorsa bu dosyayı başlangıç dosyası olarak belirtmemiz gerekir.

Örneğin basit bir Express.js uygulaması şöyle olabilir:

const express = require('express'); const app = express(); const port = process.env.PORT || 3000; app.get('/', (req, res) => { res.send('Node.js uygulaması çalışıyor!'); }); app.listen(port, () => { console.log(`Server started on port ${port}`); });

8. package.json Dosyasını Kontrol Etme

Node.js projelerinin en önemli dosyalarından biri package.json dosyasıdır.

Örneğin:

{ "name": "my-node-app", "version": "1.0.0", "main": "app.js", "scripts": { "start": "node app.js" }, "dependencies": { "express": "^5.0.0" } }

Burada uygulamanın kullandığı paketler ve çalıştırma komutları tanımlanır.

9. Node.js Paketlerini Kurma

Uygulama dosyalarını yükledikten sonra gerekli Node.js paketlerini kurmamız gerekir.

npm kullanıyorsak:

npm install

Yarn kullanıyorsak:

yarn install

Bu işlem package.json içerisindeki bağımlılıkları yükler.

Kurulum tamamlandıktan sonra uygulamanın ihtiyaç duyduğu Node.js paketleri sunucuda hazır hale gelir.

10. Uygulamayı Plesk Üzerinden Başlatma

Node.js uygulamasının temel ayarlarını yaptıktan sonra Plesk panelindeki Node.js yönetim ekranından uygulamayı başlatabiliriz.

Uygulama başarıyla başlatıldığında Plesk Node.js sürecini yönetmeye başlar.

Uygulamada yaptığımız değişikliklerden sonra gerektiğinde:

• Restart App
• Stop App
• Start App

gibi işlemleri kullanabiliriz.

11. Plesk’te Node.js Ortam Değişkenleri

Modern Node.js uygulamalarında veritabanı bilgileri, API anahtarları ve uygulama ayarları genellikle environment variable olarak tutulur.

Örneğin:

APP_ENV=production APP_URL=https://example.com DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=my_database DB_USERNAME=my_user DB_PASSWORD=strong_password

Bu yöntemin avantajı, hassas bilgileri doğrudan uygulama kodunun içerisine yazmak zorunda kalmamamızdır.

Production ortamında parola ve API anahtarı gibi bilgilerin kaynak kod içerisinde bırakılmamasını öneriyoruz.

12. Node.js Uygulamasında Port Yönetimi

Node.js uygulamalarında port konusu yeni başlayan kullanıcıların en çok karıştırdığı konulardan biridir.

Örneğin uygulamamız:

const port = process.env.PORT || 3000; app.listen(port);

şeklinde çalışabilir.

Plesk’in Node.js ortamında uygulamanın dış dünyaya doğrudan kendi portundan açılması yerine Plesk’in web sunucusu üzerinden alan adına yönlendirilmesi tercih edilir.

Bu nedenle uygulamayı örneğin http://example.com:3000 şeklinde yayınlamak yerine alan adını standart HTTP/HTTPS üzerinden kullanabiliriz.

13. Node.js Uygulamasına Alan Adı Bağlama

Node.js uygulamamızın bir alan adı üzerinden yayınlanması için öncelikle alan adının DNS kayıtlarının sunucumuzu göstermesi gerekir.

Örneğin:

example.com

alan adı sunucunun IP adresine yönlendirilmiş olmalıdır.

Daha sonra Plesk üzerinde Node.js uygulamasını bu domain veya subdomain ile ilişkilendirerek kullanabiliriz.

14. Node.js Uygulamasına SSL Kurulumu

Node.js uygulamamızı production ortamında yayınlarken HTTPS kullanmamız gerekir.

Plesk üzerinden Let’s Encrypt kullanarak SSL sertifikası oluşturabiliriz.

Bunun için alan adımızın Plesk üzerinde aktif olması ve DNS kayıtlarının doğru sunucuya yönlenmesi gerekir.

SSL kurulumu tamamlandıktan sonra uygulamamız:

https://example.com

üzerinden güvenli şekilde erişilebilir hale gelir.

15. Node.js Uygulamasında Logları Kontrol Etme

Uygulama çalışmıyorsa veya hata veriyorsa ilk kontrol etmemiz gereken alanlardan biri loglardır.

Node.js uygulamasının loglarında aşağıdaki gibi problemler görülebilir:

• Eksik npm paketi
• Yanlış Node.js sürümü
• Yanlış startup file
• Port problemi
• Environment variable eksikliği
• Veritabanı bağlantı hatası

Bu nedenle uygulama çalışmadığında doğrudan dosyaları değiştirmek yerine öncelikle Plesk loglarını kontrol etmek daha doğru bir yaklaşım olacaktır.

16. Plesk’te Node.js Uygulamasını Güncelleme

Uygulamanın yeni bir sürümünü yayınlamak için Git, FTP veya başka bir deployment yöntemi kullanılabilir.

Yeni dosyalar sunucuya aktarıldıktan sonra bağımlılıkların güncellenmesi gerekiyorsa:

npm install

veya:

npm ci

kullanılabilir.

Daha sonra uygulamayı yeniden başlatmak gerekir.

17. Plesk’te Node.js ile Hangi Uygulamalar Çalıştırılabilir?

Plesk üzerinde farklı Node.js tabanlı uygulamalar yayınlayabiliriz.

• Express.js uygulamaları
• NestJS projeleri
• Next.js projeleri
• REST API uygulamaları
• Backend servisleri
• SSR tabanlı Node.js uygulamaları
• Özel JavaScript servisleri

Ancak framework’ün deployment gereksinimlerini ayrıca kontrol etmek gerekir. Özellikle SSR kullanan projelerde build işlemi, startup komutu ve production ayarları standart Express uygulamalarından farklı olabilir.

Plesk’te Node.js Kullanmanın Avantajları

Plesk üzerinde Node.js kullanmanın önemli avantajlarından biri uygulama yönetiminin panel üzerinden yapılabilmesidir.

• Node.js sürüm yönetimi
• Uygulama başlatma ve durdurma
• Environment variable yönetimi
• Alan adı entegrasyonu
• SSL yönetimi
• Log kontrolü
• FTP ve Git ile deployment seçenekleri

Bu özellikler sayesinde özellikle VPS ve dedicated sunucu kullanıcıları için Node.js uygulamalarını yönetmek daha kolay hale gelir.

Plesk’te Node.js Kullanırken Dikkat Edilmesi Gerekenler

Node.js uygulamasını production ortamında çalıştırırken yalnızca uygulamanın açılması yeterli değildir. Sunucu güvenliği ve kaynak yönetimi de dikkate alınmalıdır.

• Desteklenen Node.js sürümünü kullanın.
• Gereksiz npm paketlerini yüklemeyin.
• Production ortamında debug modunu açık bırakmayın.
• Environment variable bilgilerini koruyun.
• Uygulama loglarını düzenli kontrol edin.
• HTTPS kullanın.
• Sunucunun CPU ve RAM kullanımını takip edin.

Plesk’te Node.js İçin Hangi Sunucu Tercih Edilmeli?

Node.js uygulamalarında sunucu seçimi projenin kaynak tüketimine göre yapılmalıdır.

Küçük bir API veya basit bir web uygulaması için düşük kaynaklı bir VPS yeterli olabilir. Büyük Node.js uygulamalarında ise CPU, RAM, disk performansı ve ağ kapasitesinin birlikte değerlendirilmesi gerekir.

Özellikle birden fazla Node.js uygulaması çalıştırılacaksa kaynak kullanımını önceden hesaplamak önemlidir.

Plesk Lisansı ile Node.js Sunucusu Kullanmak

Node.js uygulamalarımızı Plesk yönetim paneli üzerinden çalıştırmak için sunucumuzda uygun bir Plesk kurulumu ve geçerli bir lisans bulunması gerekir.

Biz sunucu yönetimini kolaylaştırmak isteyen kullanıcılar için farklı lisans seçenekleri sunuyoruz. İhtiyacınıza uygun seçeneği değerlendirmek için hesaplı Plesk Lisansı seçeneklerimize göz atabilirsiniz.

Özellikle VPS veya dedicated sunucu üzerinde web uygulamaları, Node.js projeleri, PHP sistemleri ve veritabanlarını birlikte yönetmek isteyen kullanıcılar için Plesk oldukça kullanışlı bir kontrol paneli olabilir.

Sonuç

Plesk’te Node.js çalıştırmak, doğru Node.js sürümü ve uygulama yapılandırması seçildiğinde oldukça kolaydır. Uygulamanın Application Root, Document Root, Startup File ve package manager ayarlarının doğru yapılması başarılı bir deployment için temel noktaları oluşturur.

Node.js uygulamamızı Plesk üzerinde yayınladıktan sonra SSL, log yönetimi, environment variable ayarları ve düzenli güncellemeler gibi production işlemlerini de ihmal etmemeliyiz.

Sık Sorulan Sorular

Plesk’te Node.js çalıştırılabilir mi?

Evet. Plesk, Node.js uygulamalarını çalıştırmak ve yönetmek için Node.js desteği sunmaktadır.

Plesk’te Node.js nasıl kurulur?

Plesk Extensions bölümünden Node.js desteği ve gerekli Toolkit bileşenleri kurulabilir. Daha sonra ilgili alan adı üzerinden Node.js uygulama ayarları yapılabilir.

Plesk’te Node.js uygulamasının başlangıç dosyası nedir?

Başlangıç dosyası uygulamaya göre değişir. Genellikle app.js, server.js veya framework tarafından belirtilen başka bir dosya kullanılabilir.

Plesk’te Node.js uygulaması için npm install gerekli mi?

Uygulamanın bağımlılıklarına göre genellikle npm install veya npm ci komutuyla package.json içerisindeki paketlerin kurulması gerekir.

Plesk’te Node.js uygulamasına SSL kurulabilir mi?

Evet. Plesk üzerinden Let’s Encrypt gibi SSL seçenekleri kullanılarak Node.js uygulamasının yayınlandığı alan adına HTTPS kurulabilir.