Bugün çoğu gelişmiş web uygulaması, güçlü performans ve kesintisiz veri akışı sağlamak amacıyla Node.js teknolojisini kullanır. Gerçek zamanlı sohbet sistemleri, anlık bildirim altyapıları ve dinamik veri etkileşimleri gibi senaryolarda Node.js’in hızlı yapısı ön plana çıkar.
Plesk panelinde Node.js projesi çalıştırmak isteyen kullanıcılar için ilk adım, bu özelliği etkinleştirmek olmalıdır.
Ubuntu tabanlı sistemlerde çalışan Plesk ortamlarında kurulum ve yapılandırma adımları oldukça kolaydır. Web arayüzü üzerinden yapılan işlemler, kaynak yönetimini sadeleştirir ve sistemin istikrarını artırır.
Ayrıca güvenlik açısından yalnızca Plesk değil, DirectAdmin paneli üzerinden sağlanan SSL desteği de değerlendirilebilir. Bu bütünleşik yapı sayesinde geliştiriciler, hem yüksek performanslı hem de kolayca yönetilebilen bir ortam oluşturabilir.
Node.js Nedir?
Node.js, JavaScript kodlarının sadece tarayıcıda değil, aynı zamanda sunucu tarafında da çalıştırılmasını mümkün kılar. Böylece, web projelerinin hem ön yüzü hem de sunucu tarafı JavaScript ile kodlanabilir.
Örnek olarak, bir kullanıcı bir mesaj gönderdiğinde, bu mesajın diğer kullanıcılara anlık olarak ulaşması gerekiyorsa, Node.js bu süreci hızlı ve kesintisiz biçimde yönetebilir. Bu sebeple, sohbet uygulamaları, anlık bildirim sistemleri ve oyun altyapıları Node.js’i sıklıkla kullanır.
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.
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
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
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.