Hur man installerar NodeBB Forum på Ubuntu 18.04 LTS

NodeBB är ett Node.js-baserat forum. Den använder webbsockets för omedelbar interaktion och realtidsmeddelanden. NodeBB-källkoden är offentligt värd på Github . Den här guiden leder dig genom NodeBB-installationsprocessen på en ny Ubuntu 18.04 LTS Vultr-instans som använder Node.js, MongoDB som en databas, Nginx som en omvänd proxy och Acme.sh för SSL-certifikat.

Krav

NodeBB kräver att följande programvara är installerad:

• Git
• Node.js version 6.9.0 eller senare
• MongoDB version 2.6 eller senare
• Nginx
• Minst 1024MB RAM
• Domännamn med A/ AAAAposter inställda

Innan du börjar

Kontrollera Ubuntu-versionen.

lsb_release -ds
# Ubuntu 18.04 LTS

Skapa ett nytt non-rootanvändarkonto med sudoåtkomst och byt till det.

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

OBS : Ersätt johndoemed ditt användarnamn.

Ställ in tidszonen.

sudo dpkg-reconfigure tzdata

Se till att ditt system är uppdaterat.

sudo apt update && sudo apt upgrade -y

Installera nödvändiga paket.

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

Installera Node.js

NodeBB drivs av Node.js, och därför måste den installeras. Installation av den aktuella LTS-versionen av Node.js rekommenderas.

Installera Node.js från NodeSource-förvaret.

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

Verifiera installationen av Node.js och npm.

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

Installera och konfigurera MongoDB

MongoDB är standarddatabasen för NodeBB.

Installera MongoDB.

sudo apt install -y mongodb

Kontrollera versionen.

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

Skapa en MongoDB-databas och användare för NodeBB.

Anslut till MongoDB-servern först.

mongo

Byt till den inbyggda admindatabasen.

> use admin

Skapa en administrativ användare.

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

OBS: Byt ut platshållaren <Enter a secure password>med ditt eget valda lösenord.

Lägg till en ny databas som heter nodebb.

> use nodebb

Databasen kommer att skapas och sammanhanget växlas till nodebb. Skapa sedan nodebbanvändaren med lämpliga privilegier.

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

OBS: Återigen, ersätt platshållaren <Enter a secure password>med ditt eget valda lösenord.

Gå ur Mongo-skalet.

> quit()

Starta om MongoDB och verifiera att den administrativa användaren som skapats tidigare kan ansluta.

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

Installera och konfigurera Nginx

Installera den senaste huvudversionen av Nginx från det officiella Nginx-förvaret.

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/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

Kontrollera versionen.

sudo nginx -v
# nginx version: nginx/1.15.0

Aktivera och starta Nginx.

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

NodeBB körs som standard på port 4567. För att undvika att behöva skriva http://example.com:4567kommer vi att konfigurera Nginx som en omvänd proxy för NodeBB-applikationen. Varje begäran på port 80eller 443(om SSL används) kommer att vidarebefordras till port 4567.

Kör sudo vim /etc/nginx/conf.d/nodebb.confoch fyll i den med den grundläggande omvända proxykonfigurationen nedan.

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

}

Obs: Uppdatera server_namedirektivet med din domän/värdnamn.

Kontrollera konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo systemctl reload nginx.service

Installera Acme.sh-klienten och skaffa ett Let's Encrypt-certifikat (valfritt)

Att säkra ditt forum med HTTPS är inte nödvändigt, men det kommer att säkra din webbplats trafik. Acme.sh är ett rent unix-skalprogramvara för att erhålla SSL-certifikat från Let's Encrypt med noll beroenden.

Ladda ner och installera 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

Kontrollera versionen.

acme.sh --version
# v2.7.9

Skaffa RSA- och ECDSA-certifikat 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

Efter att ha kört ovanstående kommandon kommer dina certifikat och nycklar att finnas i följande kataloger:

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

Efter att ha erhållit certifikat från Let's Encrypt måste vi konfigurera Nginx för att använda dem.

Kör sudo vim /etc/nginx/conf.d/nodebb.configen och konfigurera Nginx som en HTTPS omvänd 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";
  }

}

Kontrollera konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo systemctl reload nginx.service

Installera NodeBB

Skapa en rotkatalog för dokument.

sudo mkdir -p /var/www/nodebb

Ändra ägande av /var/www/nodebbkatalogen till johndoe.

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

Navigera till dokumentets rotmapp.

cd /var/www/nodebb

Klona den senaste versionen av NodeBB till dokumentets rotmapp.

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

Kör kommandot NodeBB setup och svara på varje fråga när du uppmanas.

./nodebb setup

Efter att NodeBB-installationen är klar, kör för ./nodebb startatt manuellt starta din NodeBB-server.

./nodebb start

Efter detta kommando kommer du att kunna komma åt ditt forum i din webbläsare.

Kör NodeBB som en systemtjänst

När den startas via ./nodebb start, kommer NodeBB inte att starta automatiskt igen när systemet startar om. För att undvika det måste vi ställa in NodeBB som en systemtjänst.

Om du kör, stoppa NodeBB.

./nodebb stop

Skapa en ny oprivilegierad nodebbanvändare.

sudo adduser nodebb

Ändra äganderätten till /var/www/nodebbkatalogen till nodebbanvändare.

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

Skapa nodebb.servicesystemd-enhetens konfigurationsfil. Denna enhetsfil kommer att hantera start av NodeBB-deamonen. Kör sudo vim /etc/systemd/system/nodebb.serviceoch fyll filen med följande innehåll:

[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

OBS: Ställ in användarnamn och katalogsökvägar enligt dina valda namn.

Aktivera nodebb.servicevid omstart och starta omedelbart nodebb.service.

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

Kontrollera nodebb.servicestatus.

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

Det är allt. Din NodeBB-instans är nu igång.