So installieren Sie das NodeBB-Forum unter Debian 9

• Bedarf
• Bevor Sie beginnen
• Installieren Sie Node.js.
• Installieren und konfigurieren Sie MongoDB
• Installieren und konfigurieren Sie Nginx
• Installieren Sie den Acme.sh-Client und erhalten Sie ein Let's Encrypt-Zertifikat (optional).
• Installieren Sie NodeBB
• Führen Sie NodeBB als Systemdienst aus

NodeBB ist ein Node.js-basiertes Forum. Es verwendet Web-Sockets für sofortige Interaktionen und Echtzeitbenachrichtigungen. Der NodeBB-Quellcode wird öffentlich auf Github gehostet . Dieses Handbuch führt Sie durch den NodeBB-Installationsprozess auf einer neuen Debian 9 Vultr-Instanz unter Verwendung von Node.js, MongoDB als Datenbank, Nginx als Reverse-Proxy und Acme.sh für SSL-Zertifikate.

Bedarf

Für NodeBB muss die folgende Software installiert sein:

• Git
• Node.js Version 6.9.0 oder höher
• MongoDB Version 2.6 oder höher
• Nginx
• Mindestens 1024 MB RAM
• Domainname mit A/ AAAADatensätzen eingerichtet

Bevor Sie beginnen

Überprüfen Sie die Debian-Version.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

Stellen Sie sicher, dass Ihr System auf dem neuesten Stand ist.

apt update && apt upgrade -y

Installieren Sie die erforderlichen Pakete.

apt install -y sudo dirmngr git build-essential apt-transport-https

Erstellen Sie ein neues non-rootBenutzerkonto mit sudoZugriff und wechseln Sie zu diesem.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

HINWEIS : Ersetzen Sie johndoedurch Ihren Benutzernamen.

Richten Sie die Zeitzone ein.

sudo dpkg-reconfigure tzdata

Installieren Sie Node.js.

NodeBB wird von Node.js gesteuert und muss daher installiert werden. Die Installation der aktuellen LTS-Version von Node.js wird empfohlen.

Installieren Sie Node.js aus dem NodeSource-Repository.

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

Überprüfen Sie die Installation von Node.js und npm.

node -v && npm -v
# v10.15.0
# 5.6.0

Installieren und konfigurieren Sie MongoDB

MongoDB ist die Standarddatenbank für NodeBB.

Installieren Sie MongoDB aus dem offiziellen MongoDB-Repository.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
echo "deb https://repo.mongodb.org/apt/debian stretch/mongodb-org/4.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list
sudo apt update
sudo apt install -y mongodb-org

Überprüfe die Version.

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v4.00
# db version v4.0.0

Starten und aktivieren Sie MongoDB.

sudo systemctl start mongod.service
sudo systemctl enable mongod.service

Erstellen Sie eine MongoDB-Datenbank und einen Benutzer für NodeBB.

Stellen Sie eine Verbindung zu MongoDB her.

mongo

Wechseln Sie zur integrierten adminDatenbank.

> use admin

Erstellen Sie einen Administrator.

> db.createUser( { user: "admin", pwd: "<Enter a secure password>", roles: [ { role: "readWriteAnyDatabase", db: "admin" }, { role: "userAdminAnyDatabase", db: "admin" } ] } )

HINWEIS: Ersetzen Sie den Platzhalter <Enter a secure password>durch Ihr ausgewähltes Passwort.

Fügen Sie eine neue Datenbank mit dem Namen hinzu nodebb.

> use nodebb

Die Datenbank wird erstellt und der Kontext auf umgeschaltet nodebb. Erstellen Sie als Nächstes den nodebbBenutzer mit den entsprechenden Berechtigungen.

> db.createUser( { user: "nodebb", pwd: "<Enter a secure password>", roles: [ { role: "readWrite", db: "nodebb" }, { role: "clusterMonitor", db: "admin" } ] } )

HINWEIS: Ersetzen Sie den Platzhalter erneut <Enter a secure password>durch Ihr eigenes ausgewähltes Passwort.

Verlasse die Mongo-Shell.

> quit()

Starten Sie MongoDB neu und stellen Sie sicher, dass der zuvor erstellte Administrator eine Verbindung herstellen kann.

sudo systemctl restart mongod.service
mongo -u admin -p your_password --authenticationDatabase=admin

Installieren und konfigurieren Sie Nginx

Installieren Sie die neueste Hauptversion von Nginx aus dem offiziellen Nginx-Repository.

wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

Überprüfe die Version.

sudo nginx -v
# nginx version: nginx/1.15.0

Aktivieren und starten Sie Nginx.

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

NodeBB wird standardmäßig am Port ausgeführt 4567. Um eine Eingabe zu vermeiden http://example.com:4567, konfigurieren wir Nginx als Reverse-Proxy für die NodeBB-Anwendung. Jede Anfrage an Port 80oder 443(wenn SSL verwendet wird) wird an Port weitergeleitet 4567.

Führen Sie es aus sudo vim /etc/nginx/conf.d/nodebb.confund füllen Sie es mit der unten gezeigten grundlegenden Reverse-Proxy-Konfiguration.

server {

  listen [::]:80;
  listen 80;

  server_name forum.example.com;

  root /usr/share/nginx/html;

  client_max_body_size 50M;

  location /.well-known/acme-challenge/ {
    allow all;
  }

  location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $http_host;
    proxy_hide_header X-Powered-By;
    proxy_set_header X-Nginx-Proxy true;

    proxy_pass http://127.0.0.1:4567;
    proxy_redirect off;

    # Socket.IO Support
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

}

Aktualisieren Sie in der obigen Konfiguration die server_nameAnweisung mit Ihrer Domain / Ihrem Hostnamen.

Überprüfen Sie die Konfiguration.

sudo nginx -t

Laden Sie Nginx neu.

sudo systemctl reload nginx.service

Installieren Sie den Acme.sh-Client und erhalten Sie ein Let's Encrypt-Zertifikat (optional).

Das Sichern Ihres Forums mit HTTPS ist nicht erforderlich, sichert jedoch den Datenverkehr Ihrer Website. Acme.sh ist eine reine Unix-Shell-Software zum Abrufen von SSL-Zertifikaten von Let's Encrypt ohne Abhängigkeiten.

Laden Sie Acme.sh herunter und installieren Sie es.

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]
cd ~
source ~/.bashrc

Überprüfe die Version.

acme.sh --version
# v2.7.9

Erhalten Sie RSA- und ECDSA-Zertifikate für forum.example.com.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d forum.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d forum.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength ec-256

Nachdem Sie die obigen Befehle ausgeführt haben, befinden sich Ihre Zertifikate und Schlüssel in den folgenden Verzeichnissen:

• RSA: /etc/letsencrypt/forum.example.com
• ECC / ECDSA: /etc/letsencrypt/forum.example.com_ecc

Nachdem wir Zertifikate von Let's Encrypt erhalten haben, müssen wir Nginx für die Verwendung konfigurieren.

Führen Sie es sudo vim /etc/nginx/conf.d/nodebb.conferneut aus und konfigurieren Sie Nginx als HTTPS-Reverse-Proxy.

server {

  listen [::]:443 ssl http2;
  listen 443 ssl http2;
  listen [::]:80;
  listen 80;

  server_name forum.example.com;

  root /usr/share/nginx/html;

  client_max_body_size 50M;

  location /.well-known/acme-challenge/ {
    allow all;
  }

  # RSA
  ssl_certificate /etc/letsencrypt/forum.example.com/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/forum.example.com/forum.example.com.key;
  # ECDSA
  ssl_certificate /etc/letsencrypt/forum.example.com_ecc/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/forum.example.com_ecc/forum.example.com.key;

  location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $http_host;
    proxy_set_header X-NginX-Proxy true;

    proxy_pass http://127.0.0.1:4567;
    proxy_redirect off;

    # Socket.IO Support
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

}

Überprüfen Sie die Konfiguration.

sudo nginx -t

Laden Sie Nginx neu.

sudo systemctl reload nginx.service

Installieren Sie NodeBB

Erstellen Sie ein Dokumentstammverzeichnis.

sudo mkdir -p /var/www/nodebb

Ändern Sie den Besitz des /var/www/nodebbVerzeichnisses in johndoe.

sudo chown -R johndoe:johndoe /var/www/nodebb

Navigieren Sie zum Dokumentstammordner.

cd /var/www/nodebb

Klonen Sie den neuesten NodeBB in den Dokumentstammordner.

git clone -b v1.10.x https://github.com/NodeBB/NodeBB.git .

Führen Sie den NodeBB-Setup-Befehl aus und beantworten Sie jede Frage, wenn Sie dazu aufgefordert werden.

./nodebb setup

Führen Sie nach Abschluss des NodeBB-Setups ./nodebb startden NodeBB-Server manuell aus.

./nodebb start

Nach diesem Befehl können Sie in Ihrem Webbrowser auf Ihr Forum zugreifen.

Führen Sie NodeBB als Systemdienst aus

Beim Start über ./nodebb startwird NodeBB beim Neustart des Systems nicht automatisch neu gestartet. Um dies zu vermeiden, müssen wir NodeBB als Systemdienst einrichten.

Wenn ausgeführt, stoppen Sie NodeBB.

./nodebb stop

Erstellen Sie einen neuen nodebbBenutzer:

sudo adduser nodebb

Ändern Sie den Besitz des /var/www/nodebbVerzeichnisses in nodebb.

sudo chown -R nodebb:nodebb /var/www/nodebb

Erstellen Sie eine nodebb.serviceKonfigurationsdatei für die Systemeinheit. Diese Unit-Datei übernimmt den Start von NodeBB-Deamon. Führen Sie sudo vim /etc/systemd/system/nodebb.servicedie Datei aus und füllen Sie sie mit folgendem Inhalt:

[Unit]
Description=NodeBB
Documentation=https://docs.nodebb.org
After=system.slice multi-user.target mongod.service

[Service]
Type=forking
User=nodebb

StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=nodebb

Environment=NODE_ENV=production
WorkingDirectory=/var/www/nodebb
PIDFile=/var/www/nodebb/pidfile
ExecStart=/usr/bin/env node loader.js
Restart=always

[Install]
WantedBy=multi-user.target

HINWEIS: Legen Sie den Benutzernamen und die Verzeichnispfade entsprechend den von Ihnen gewählten Namen fest.

Beim nodebb.serviceNeustart aktivieren und sofort starten nodebb.service.

sudo systemctl enable nodebb.service
sudo systemctl start nodebb.service

Überprüfen Sie den nodebb.serviceStatus.

sudo systemctl status nodebb.service
sudo systemctl is-enabled nodebb.service

Das ist es. Ihre NodeBB-Instanz ist jetzt aktiv.