Hoe het NodeBB-forum op Debian 9 te installeren

• Vereisten
• Voordat je begint
• Installeer Node.js
• Installeer en configureer MongoDB
• Installeer en configureer Nginx
• Installeer de Acme.sh-client en verkrijg een Let's Encrypt-certificaat (optioneel)
• Installeer NodeBB
• Voer NodeBB uit als een systeemservice

NodeBB is een op Node.js gebaseerd forum. Het maakt gebruik van webaansluitingen voor directe interacties en realtime meldingen. NodeBB-broncode wordt openbaar gehost op Github . Deze gids leidt u door het installatieproces van NodeBB op een nieuwe Debian 9 Vultr-instantie met Node.js, MongoDB als database, Nginx als reverse proxy en Acme.sh voor SSL-certificaten.

Vereisten

NodeBB vereist dat de volgende software wordt geïnstalleerd:

• Git
• Node.js versie 6.9.0 of hoger
• MongoDB versie 2.6 of hoger
• Nginx
• Minimaal 1024 MB RAM
• Domeinnaam met A/ AAAArecords ingesteld

Voordat je begint

Controleer de Debian-versie.

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

Zorg ervoor dat uw systeem up-to-date is.

apt update && apt upgrade -y

Installeer de benodigde pakketten.

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

Maak een nieuw non-rootgebruikersaccount aan met sudotoegang en schakel ernaar.

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

OPMERKING : vervang johndoedoor uw gebruikersnaam.

Stel de tijdzone in.

sudo dpkg-reconfigure tzdata

Installeer Node.js

NodeBB wordt aangestuurd door Node.js en moet dus worden geïnstalleerd. De installatie van de huidige LTS-versie van Node.js wordt aanbevolen.

Installeer Node.js vanuit de NodeSource-repository.

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

Controleer de installatie van Node.js en npm.

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

Installeer en configureer MongoDB

MongoDB is de standaarddatabase voor NodeBB.

Installeer MongoDB vanuit de officiële 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

Controleer de versie.

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

Start en schakel MongoDB in.

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

Maak een MongoDB-database en gebruiker voor NodeBB.

Maak verbinding met MongoDB.

mongo

Schakel over naar de ingebouwde admindatabase.

> use admin

Maak een administratieve gebruiker.

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

OPMERKING: vervang de tijdelijke aanduiding <Enter a secure password>door uw eigen geselecteerde wachtwoord.

Voeg een nieuwe database toe met de naam nodebb.

> use nodebb

De database wordt gemaakt en de context wordt gewijzigd nodebb. Maak vervolgens de nodebbgebruiker met de juiste rechten.

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

OPMERKING: Vervang nogmaals de tijdelijke aanduiding <Enter a secure password>door uw eigen geselecteerde wachtwoord.

Verlaat de Mongo-shell.

> quit()

Start MongoDB opnieuw op en controleer of de eerder gemaakte administratieve gebruiker verbinding kan maken.

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

Installeer en configureer Nginx

Installeer de nieuwste hoofdversie van Nginx vanuit de officiële 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

Controleer de versie.

sudo nginx -v
# nginx version: nginx/1.15.0

Schakel Nginx in en start het.

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

NodeBB draait standaard op poort 4567. Om typen te voorkomen http://example.com:4567, zullen we Nginx configureren als een reverse proxy voor de NodeBB-applicatie. Elk verzoek op poort 80of 443(als SSL wordt gebruikt) wordt doorgestuurd naar poort 4567.

Voer het uit sudo vim /etc/nginx/conf.d/nodebb.confen vul het in met de standaard omgekeerde proxyconfiguratie die hieronder wordt weergegeven.

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";
  }

}

Werk in de bovenstaande configuratie de server_namerichtlijn bij met uw domein / hostnaam.

Controleer de configuratie.

sudo nginx -t

Herlaad Nginx.

sudo systemctl reload nginx.service

Installeer de Acme.sh-client en verkrijg een Let's Encrypt-certificaat (optioneel)

Het beveiligen van uw forum met HTTPS is niet nodig, maar het beveiligt het verkeer van uw site. Acme.sh is pure Unix-shellsoftware voor het verkrijgen van SSL-certificaten van Let's Encrypt zonder afhankelijkheden.

Download en installeer Acme.sh.

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

Controleer de versie.

acme.sh --version
# v2.7.9

Verkrijgen van RSA- en ECDSA-certificaten voor 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

Na het uitvoeren van de bovenstaande opdrachten, bevinden uw certificaten en sleutels zich in de volgende mappen:

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

Na het verkrijgen van certificaten van Let's Encrypt, moeten we Nginx configureren om ze te gebruiken.

Voer sudo vim /etc/nginx/conf.d/nodebb.confopnieuw uit en configureer Nginx als een HTTPS-omgekeerde 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";
  }

}

Controleer de configuratie.

sudo nginx -t

Herlaad Nginx.

sudo systemctl reload nginx.service

Installeer NodeBB

Maak een documenthoofdmap.

sudo mkdir -p /var/www/nodebb

Verander het eigendom van de /var/www/nodebbdirectory in johndoe.

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

Navigeer naar de hoofdmap van het document.

cd /var/www/nodebb

Kloon de nieuwste NodeBB in de hoofdmap van het document.

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

Voer de NodeBB-installatieopdracht uit en beantwoord elke vraag wanneer daarom wordt gevraagd.

./nodebb setup

Nadat de installatie van NodeBB is voltooid, voert ./nodebb startu uit om uw NodeBB-server handmatig te starten.

./nodebb start

Na deze opdracht krijgt u toegang tot uw forum in uw webbrowser.

Voer NodeBB uit als een systeemservice

Wanneer gestart via ./nodebb start, zal NodeBB niet automatisch opnieuw opstarten wanneer het systeem opnieuw opstart. Om dat te voorkomen, moeten we NodeBB instellen als systeemservice.

Stop NodeBB als het draait.

./nodebb stop

Maak een nieuwe nodebbgebruiker aan:

sudo adduser nodebb

Wijzig het eigendom van de /var/www/nodebbdirectory in nodebb.

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

Maak een nodebb.servicesystemd unit configuratiebestand. Dit eenheidsbestand zorgt voor het opstarten van de NodeBB-deamon. Voer sudo vim /etc/systemd/system/nodebb.servicehet bestand uit en vul het met de volgende inhoud:

[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

OPMERKING: stel gebruikersnaam- en mappaden in volgens de door u gekozen namen.

Inschakelen nodebb.servicebij opnieuw opstarten en onmiddellijk starten nodebb.service.

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

Controleer de nodebb.servicestatus.

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

Dat is het. Uw NodeBB-instantie is nu actief.