Sıfırdan NodeBB Kurulumu (Ubuntu/Debian Adım Adım Rehber)

NodeBB, Node.js tabanlı, gerçek zamanlı bildirimler ve modern bir kullanıcı arayüzüyle öne çıkan açık kaynak bir forum yazılımıdır.

WebSocket altyapısı sayesinde hızlı, dinamik ve etkileşimli bir topluluk deneyimi sunar.

Bu rehberde, NodeBB forumunu sıfırdan kurmak için gereken tüm adımları; sistem hazırlığından veritabanı yapılandırmasına, SSL kurulumundan başlatma sürecine kadar detaylı şekilde bulacaksınız.

İçindekiler

1. Gereksinimler

NodeBB kurulumu için aşağıdaki bileşenlere ihtiyacınız olacak:

Sunucu (VPS veya Dedicated): Minimum 2 GB RAM (4 GB önerilir)
İşletim Sistemi: Ubuntu 22.04 LTS veya Debian 12
Node.js: v18 veya üzeri
NPM (Node Package Manager)
MongoDB veya Redis Veritabanı
Reverse Proxy (Nginx önerilir)
Alan adı (Domain) ve isteğe bağlı olarak SSL sertifikası (Let’s Encrypt)

2. Sunucuyu Hazırlama

Sistemi güncelleyin ve temel paketleri yükleyin:

sudo apt update &amp;&amp; sudo apt upgrade -y
sudo apt install curl git build-essential -y

1 2	sudo apt update && sudo apt upgrade -y sudo apt install curl git build-essential -y

3. Node.js ve NPM Kurulumu

NodeBB, Node.js tabanlı çalıştığı için doğru sürümün yüklü olması gerekir.

3.1. NodeSource üzerinden kurulum:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

1 2	curl -fsSL https://deb.nodesource.com/setup_20.x \| sudo -E bash - sudo apt install -y nodejs

Kurulumu doğrulayın:

node -v
npm -v

1 2	node -v npm -v

4. MongoDB veya Redis Kurulumu

NodeBB, veritabanı olarak MongoDB veya Redis kullanabilir.

Genellikle MongoDB tercih edilir.

4.1. MongoDB kurmak için:

sudo apt install -y mongodb
sudo systemctl enable mongodb
sudo systemctl start mongodb

sudo apt install -y mongodb

sudo systemctl enable mongodb

sudo systemctl start mongodb

MongoDB’nin aktif olduğunu kontrol edin:

sudo systemctl status mongodb

1	sudo systemctl status mongodb

5. NodeBB’yi İndirme

NodeBB’yi /opt/nodebb dizinine klonlayın:

cd /opt
sudo git clone -b v4.x https://github.com/NodeBB/NodeBB.git nodebb
cd nodebb

cd /opt

sudo git clone -b v4.x https://github.com/NodeBB/NodeBB.git nodebb

cd nodebb

Güncel kararlı sürümü indirip dizine geçtikten sonra bağımlılıkları yükleyin:

npm install --production

1	npm install --production

6. NodeBB Kurulum Sihirbazını Başlatma

Kurulum sihirbazını çalıştırın:

./nodebb setup

1	./nodebb setup

Komut sizden şu bilgileri isteyecektir:

Database Type: mongo
Database Address: 127.0.0.1
Database Port: 27017
Database Name: nodebb
Administrator Email: [email protected]
Site Title: Forum Adı
Site URL: https://forum.alanadiniz.com

Kurulum tamamlandığında NodeBB yapılandırma dosyalarını otomatik olarak oluşturur.

7. NodeBB’yi Başlatma

Kurulum tamamlandıktan sonra forumu başlatın:

./nodebb start

1	./nodebb start

Arka planda çalıştırmak isterseniz:

./nodebb start --daemon

1	./nodebb start --daemon

Daha sonra forumunuza şu adres üzerinden ulaşabilirsiniz:

http://sunucu-ip-adresi:4567

8. Nginx Reverse Proxy Kurulumu (Önerilir)

NodeBB, 4567 portunda çalıştığı için, alan adınızı bu porta yönlendirmek için Nginx reverse proxy kullanmanız gerekir.

8.1. Nginx yükleyin:

sudo apt install nginx -y

1	sudo apt install nginx -y

8.2. Nginx yapılandırma dosyası oluşturun:

sudo nano /etc/nginx/sites-available/nodebb.conf

1	sudo nano /etc/nginx/sites-available/nodebb.conf

Aşağıdaki içeriği ekleyin:

server {
    listen 80;
    server_name forum.alanadiniz.com;

    location / {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://127.0.0.1:4567;
    }
}

server {

listen 80;

server_name forum.alanadiniz.com;

location / {

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header Host $http_host;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_pass http://127.0.0.1:4567;

}

Dosyayı etkinleştirin:

sudo ln -s /etc/nginx/sites-available/nodebb.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

sudo ln -s /etc/nginx/sites-available/nodebb.conf /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl restart nginx

Artık forumunuza http://forum.alanadiniz.com adresinden erişebilirsiniz.

9. SSL (HTTPS) Sertifikası Kurulumu

Forumunuzu HTTPS üzerinden güvenli hale getirmek için Let’s Encrypt kullanabilirsiniz.

9.1. Certbot kurun:

sudo apt install certbot python3-certbot-nginx -y

1	sudo apt install certbot python3-certbot-nginx -y

9.2. SSL sertifikasını alın:

sudo certbot --nginx -d forum.alanadiniz.com

1	sudo certbot --nginx -d forum.alanadiniz.com

Kurulum tamamlandığında Nginx otomatik olarak SSL yönlendirmesini yapar.

Tarayıcı üzerinden https://forum.alanadiniz.com adresine giderek kontrol edebilirsiniz.

10. NodeBB Hizmetini Otomatik Başlatma (systemd)

Sunucu yeniden başlatıldığında NodeBB’nin otomatik başlaması için bir systemd servisi oluşturun:

sudo nano /etc/systemd/system/nodebb.service

1	sudo nano /etc/systemd/system/nodebb.service

Aşağıdaki içeriği ekleyin:

[Unit]
Description=NodeBB Forum
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/nodebb
ExecStart=/usr/bin/node /opt/nodebb/app.js
Restart=always

[Install]
WantedBy=multi-user.target

[Unit]

Description=NodeBB Forum

After=network.target

[Service]

Type=simple

User=www-data

WorkingDirectory=/opt/nodebb

ExecStart=/usr/bin/node /opt/nodebb/app.js

Restart=always

[Install]

WantedBy=multi-user.target

Hizmeti etkinleştirin:

sudo systemctl enable nodebb
sudo systemctl start nodebb

1 2	sudo systemctl enable nodebb sudo systemctl start nodebb

11. Güncelleme ve Eklentiler

NodeBB’yi güncellemek için:

cd /opt/nodebb
git pull
./nodebb upgrade

cd /opt/nodebb

git pull

./nodebb upgrade

Eklentileri forumun yönetici panelinden “Extend > Plugins” menüsü altından yükleyebilirsiniz.

Bazı popüler eklentiler:

nodebb-plugin-markdown → Markdown desteği
nodebb-plugin-emoji → Emoji entegrasyonu
nodebb-plugin-sso → Tek oturum açma (SSO)
nodebb-plugin-ns-custom-header → Özel başlık alanları

12. Sonuç

Artık NodeBB forumunuz başarıyla kuruldu!

Gerçek zamanlı bildirimler, modern kullanıcı deneyimi ve güçlü yönetim paneliyle NodeBB, hem küçük topluluklar hem de büyük kurumsal forumlar için mükemmel bir çözüm sunar.

Tüm ayarları web arayüzü üzerinden kolayca yönetebilir, topluluğunuzu dakikalar içinde faaliyete geçirebilirsiniz.