Node.js Uygulaması Plesk Panelde Nasıl Yönlendirilir?

SpesifikTem 16, 2025

Günümüzde birçok modern web uygulaması, yüksek hız ve kesintisiz performans sağlamak amacıyla Node.js altyapısından faydalanır. Özellikle sohbet sistemleri, anlık bildirimler ve gerçek zamanlı veri iletimi gibi senaryolarda Node.js oldukça uygun bir çözüm sunar. Eğer siz de Plesk panel üzerinde bir Node.js uygulaması çalıştırmak istiyorsanız, ilk adım olarak bu desteği etkinleştirmeniz gerekir.

Ayrıca, uygulamanızın güvenliğini sağlamak adına Plesk Panelde SSL sertifikasının aktif edilmesi büyük önem taşır. SSL desteği sayesinde veriler şifrelenmiş bir şekilde iletilir ve hem kullanıcı güvenliği hem de SEO uyumluluğu artırılır. Bunun yanında, sistem bildirimlerinin ve yapılandırma bilgileriyle ilgili uyarıların sorunsuz alınabilmesi için Plesk Panel E-Posta Adresi ayarlarının da eksiksiz yapılandırılmış olması gerekir. Bu iki unsur, Node.js tabanlı projelerin daha güvenli ve stabil şekilde çalışmasına katkı sağlar.

Table of Contents

Node.js Nedir?

Node.js, JavaScript’i sadece istemci tarafında değil, sunucu tarafında da çalıştırabilmemizi sağlayan güçlü bir altyapıdır. Bu sayede web projelerinde hem ön yüz hem de arka plan fonksiyonları JavaScript ile kodlanabilir.
Örnek olarak, bir ziyaretçi siteniz üzerinden mesaj gönderdiğinde, bu mesajın anında diğer kullanıcıya ulaşması gerekiyorsa, Node.js bu veri iletimini hızlı ve güvenilir biçimde sağlar. Bu nedenle, sohbet sistemleri ve oyun platformları gibi gerçek zamanlı çözümler Node.js’i tercih eder.

Node.js Kurulumu İçin Gerekenler

Node.js kurulumuna başlamadan önce sistemimizin aşağıdaki özellikleri karşılaması gerekir.

Plesk yüklü bir sunucu (VPS veya dedicated)
Plesk’in Web Pro veya Web Host lisans türü
Admin (yönetici) yetkileriyle giriş yapabilmeniz
Aktif bir internet bağlantısı

Node.js Kurulumu

Node.js Desteğini Etkinleştirme

İlk olarak, sunucunuzun işletim sistemine uygun olan Node.js kurulum dosyasını indirmeniz gerekir. Node.js’nin en güncel sürümünü resmi web sitesi üzerinden kolayca edinebilirsiniz.

🔗 Node.js İndir

Kurulum işlemi tamamlandıktan sonra, sunucunuz artık JavaScript ile geliştirilen uygulamaları çalıştırmaya hazır hale gelir.

Plesk’e giriş yapın

“Araçlar ve Ayarlar” → “Güncellemeler” Kısmına Girin

Ardından sol menüden “Araçlar ve Ayarlar” bölümüne gidin ve açılan ekranda “Güncellemeler” seçeneğine tıklayalım. Karşınıza çıkan yüklenebilir bileşenler listesinden “Node.js desteği” paketini bulalım, işaretleyip ve kuruluma başlayalım.

“Bileşenleri Ekle/Kaldır” Seçeneğini Açın

Karşınıza gelen ekranda “Bileşenleri Ekle/Kaldır” bağlantısına tıklayarak yüklenebilir Plesk bileşenlerini görüntüleyelim.

Node.js Barındırma Özelliklerini Seçin ve Sürüm Belirleyin

Liste içerisinde “Node.js Barındırma Özellikleri” bölümünü bulup bu alandan yüklemek istediğiniz Node.js sürümünü seçelim.(Genellikle en güncel LTS sürümü öneriyoruz.)

“Devam Et” Butonuna Tıklayın ve Kurulumu Başlatın

Tüm seçimleri yaptıktan sonra “Devam Et” butonuna tıklayarak Node.js kurulumu için işlemleri başalatalım. Kurulum sırasında birkaç dakika beklemeniz gerekebilir.

Kurulum tamamlandıktan sonra Plesk Panel’inize Node.js desteği başarıyla entegre edilmiş olur. Artık Node.js uygulamalarınızı kolaylıkla barındırabilirsiniz.

Kurulum Sonrası Node.js Optimizasyon

Kurulum başarıyla tamamlandıktan sonra, Plesk Panel’in sol menüsünde yer alan “Web Siteleri ve Alan Adları” bölümüne gidelim. Bu alanda artık Node.js seçeneği görünür hale gelir. Node.js yapılandırmasına başlamak için üzerine tıklayalım.

Başlangıç Dosyasını Tanımlayın

Node.js yapılandırma ekranında ilk olarak “Uygulama Kökü” alanını, projenizin sunucuda bulunduğu dizine göre ayarlamanız gerekir. Eğer tüm dosyalar varsayılan dizinde yer alıyorsa, bu alana genellikle httpdocs yazılır. Ardından, uygulamanızın çalıştırılacağı ana dosyayı tanımlamalısınız. Bu dosya genellikle app.js veya index.js olarak adlandırılır. Başlangıç Dosyası alanına bu dosya adını girerek yapılandırmayı tamamlayabilirsiniz.

Node.js Uygulamanıza Göz Atın

Node.js başarıyla etkinleştirildikten sonra, tekrar “Web Siteleri ve Alan Adları” bölümüne dönün. Buradan “Node.js Uygulaması” seçeneğine tıklayarak uygulamanızın durumu, log kayıtları ve kontrol butonlarına erişebilirsiniz.

Popüler Node.js Paketleri ve Kullanım Alanları

Node.js ekosistemi, geliştirme süreçlerini kolaylaştıran binlerce açık kaynaklı paketle doludur. Bu paketler, hem başlangıç seviyesindeki projelerde hem de kurumsal uygulamalarda yaygın olarak kullanılır. Aşağıda, geliştiriciler tarafından en çok tercih edilen ve projelerde sıklıkla yer verilen popüler Node.js paketlerini ve kurulum kodlarını inceleyelim.

📦Express

Express.js, Node.js üzerinde hızlı ve minimal bir web uygulaması geliştirmek için kullanılan bir framework’tür. REST API servislerinden tam kapsamlı web uygulamalarına kadar birçok projede standart haline gelmiştir. Orta katman (middleware) desteğiyle yapılandırma kolaylığı sağlar.

npm install express

🗃️ MongoDB (mongodb paketi)

Bu paket, MongoDB veritabanı ile bağlantı kurmanızı ve veri işlemlerini (CRUD) yapmanızı sağlayan resmi Node.js sürücüsüdür. NoSQL tabanlı projelerde sıklıkla kullanılır.

npm install mongodb

🔄 Socket.io

Socket.io, özellikle canlı sohbet uygulamaları, bildirim sistemleri veya online oyunlar gibi gerçek zamanlı veri akışı gerektiren projelerde tercih edilir.

npm install socket.io

🔧 Lodash

Lodash, diziler, nesneler ve fonksiyonlarla çalışmayı kolaylaştıran yardımcı fonksiyonlar içerir. Kapsamlı veri manipülasyonları için oldukça kullanışlıdır.

npm install lodash

⚙️Async

Callback yapılarının karmaşıklığını azaltır. Seri, paralel ve sıralı işlemleri kolayca tanımlayabilirsiniz. Özellikle çok aşamalı veri işleme akışlarında kullanılır.

npm install async

🔴 Redis

Bu istemci paketi sayesinde Redis ile veri okuma/yazma, kuyruk yapısı, cache yönetimi gibi işlemleri kolayca yapabilirsiniz.

npm install redis

🧪Mocha

Mocha, hem birim testleri hem de entegrasyon testleri için sade bir yapı sunar. Test senaryolarının okunabilirliği yüksektir.
🔧 Kurulum:

npm install mocha

Yaygın Node.js Hataları ve Çözümleri

Node.js ile çalışırken geliştiricilerin en sık karşılaştığı bazı hata mesajları vardır. Bu bölümde, Plesk gibi panellerde veya terminal üzerinden uygulama başlatılırken karşılaşılabilecek yaygın Node.js hatalarını ve çözüm yollarını ele alacağız.

Node.js “Port 3000 is already in use” Hatası

Node.js uygulamanız belirli bir portta çalışmaya çalışırken, o port zaten başka bir işlem tarafından kullanılıyorsa bu hatayı alırsınız. Genellikle PORT 3000 veya PORT 8080 gibi yaygın portlar çakışmaya neden olur. Terminal üzerinden çalışan uygulamaları listeleyelim daha sonra portu kullanan işlemi durduralım.

lsof -i :3000

kill -9

Node.js “Cannot find module ‘express’ “Hatası

Node.js uygulamanız, require veya import ettiği bir modülü bulamıyorsa bu hatayı verir. En sık yaşanan durum, npm install komutunun çalıştırılmaması ya da node_modules klasörünün eksik olmasıdır. Proje dizinine gidilip, eksik paketlerin yüklenmesi ile sorun giderilebilir.

cd /var/www/vhosts/siteniz/httpdocs/

npm install

Node.js “listen EACCES: permission denied” Hatası

Uygulama, root izni gerektiren bir port (örneğin 80 veya 443) üzerinde çalıştırılmaya çalışıldığında bu hata alınır. Çözüm olarak Root olmayan kullanıcılar için 1024 altı portlar kullanılamaz ve alternatif olarak uygulamayı sudo ile çalıştırabilirsiniz:

sudo node app.js

En İyi Node.js Öğrenme Kaynakları ve Kullanıcı Yorumları

Node.js öğrenme sürecinde, özellikle temel seviyede yol almak isteyen kullanıcılar için doğru kaynaklara ulaşmak kritik öneme sahiptir. Bu kapsamda, sizin için, çeşitli eğitim platformlarında sunulan öne çıkan kursları ve bu kurslara ilişkin kullanıcı deneyimlerini içeren bazı referans materyalleri derledik.

freeCodeCamp – Node.js & Express.js Full Course

Traversy Media – Node.js Crash Course

Traversy Media’nın anlatımı kısa ve öz. Hem modül yapısı hem de basit bir HTTP sunucu oluşturma örneğiyle Node.js’in temel yapı taşlarını ele alıyor.

Scrimba – Learn Node.js Interactively

scrimba.com+1scrimba.com+1

Yaklaşık 3 ay önce güncellenmiş, 3+ saatlik kapsamlı bir kurs sunuyor. APIs, backend yapıları ve full‑stack tema içerikleriyle destekli. Kursu interaktif olarak deneyimlemek için;

NodeSchool.io – “Learn You Node” vb. CLI Atölyeleri

nodeschool.io

npm install -g learnyounode komutuyla kullanılabilen CLI modülleriyle uygulamalı öğrenme sunar. HTTP, dosya sistemi, asenkron yapı gibi temel konuları adım adım pratikle öğrenilir.