Modern web projelerinde, hızlı yanıt süreleri ve kesintisiz kullanıcı deneyimi için sıklıkla Node.js tercih edilmektedir. Canlı sohbet servisleri, anlık uyarılar ve gerçek zamanlı veri iletimi gibi uygulamalar için bu teknoloji oldukça idealdir. Plesk Windows ortamında bir Node.js uygulaması çalıştırmak isteyen kullanıcıların öncelikle ilgili modülü aktif hâle getirmesi gerekir. Özellikle Windows tabanlı sunucularda Node.js entegrasyonu yapılırken, sistemin yapılandırması ve Plesk Dosya Uzantısı ayarlarının doğru tanımlanması önem arz eder. Bu rehberde, tüm yapılandırma sürecini adım adım nasıl yöneteceğinizi detaylı şekilde anlatıyoruz.
Node.js Nedir?
Node.js, JavaScript’i sadece tarayıcı ortamında değil, aynı zamanda sunucu tarafında da çalıştırabilen bir sistemdir. Böylece hem web sitesinin arayüzü hem de arka plan işlemleri JavaScript ile yazılabilir.
Örneğin, bir kullanıcı web sitenizden mesaj gönderdiğinde, bu mesajın eş zamanlı olarak diğer kullanıcıya ulaşması gerekiyorsa, Node.js bu işlemi oldukça etkili bir biçimde gerçekleştirir. Bu yüzden genellikle sohbet sistemleri, uyarı bildirimleri ve oyun platformları Node.js 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 :3000kill -9Node.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 installNode.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.jsEn İ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.
