So installieren Sie das NodeBB-Forum auf Fedora 28

• 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 Fedora 28 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 Fedora-Version.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Erstellen Sie ein neues Nicht-Root- Benutzerkonto mit sudoZugriff und wechseln Sie zu diesem.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

HINWEIS : Ersetzen Sie johndoedurch Ihren Benutzernamen.

Richten Sie die Zeitzone ein.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

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

sudo dnf check-upgrade || sudo dnf upgrade -y

Installieren Sie die erforderlichen Pakete.

sudo dnf install -y git wget vim gcc-c++ make

Deaktivieren Sie der Einfachheit halber SELinux und Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

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.

sudo dnf install -y nodejs

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

node -v && npm -v
# v8.11.3
# 5.6.0

Installieren und konfigurieren Sie MongoDB

MongoDB ist die Standarddatenbank für NodeBB.

Installieren Sie MongoDB.

sudo dnf install -y mongodb mongodb-server

Überprüfe die Version.

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3

Aktivieren und starten Sie den MongoDB-Dienst.

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

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

Stellen Sie zuerst eine Verbindung zum MongoDB-Server 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 Nginx.

sudo dnf install -y nginx

Überprüfe die Version.

sudo nginx -v
# nginx version: nginx/1.12.1

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 folgenden 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.

/etc/letsencrypt/acme.sh --version
# v2.7.9

Beziehen Sie RSA- und ECDSA-Zertifikate für die forum.example.comDomäne / den Hostnamen.

# 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 es ausgeführt wird, stoppen Sie NodeBB.

./nodebb stop

Erstellen Sie einen neuen nodebbBenutzer.

sudo useradd nodebb

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

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

Erstellen Sie die nodebb.serviceKonfigurationsdatei der Systemeinheit. Diese Unit-Datei übernimmt den Start des NodeBB-Deamons. Führen Sie sudo vim /etc/systemd/system/nodebb.servicedie Datei aus und füllen Sie sie mit dem folgenden 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.