Hur man installerar NodeBB-forumet på FreeBSD 12

NodeBB är en Node.js-baserad forummjukvara. 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 installationsprocessen för NodeBB på en ny FreeBSD 12 Vultr-instans, genom att använda 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:

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

Innan du börjar

Kontrollera FreeBSD-versionen.

uname -ro
# FreeBSD 12.0-RELEASE

Se till att ditt FreeBSD-system är uppdaterat.

freebsd-update fetch install
pkg update && pkg upgrade -y

Installera nödvändiga paket om de inte finns på ditt system.

pkg install -y sudo vim unzip wget git bash socat gcc8 pkgconf vips

Skapa ett nytt användarkonto med ditt föredragna användarnamn (vi kommer att använda johndoe).

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Kör visudokommandot och avkommentera %wheel ALL=(ALL) ALLraden för att tillåta medlemmar i wheelgruppen att utföra vilket kommando som helst.

visudo

# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL

Byt nu till din nyskapade användare med su.

su - johndoe

OBS: Ersätt johndoemed ditt användarnamn.

Ställ in tidszonen.

sudo tzsetup

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 och npm.

sudo pkg install -y node10 npm-node10

Kontrollera versionerna.

node -v && npm -v
# v10.15.3
# 6.9.0

Installera och konfigurera MongoDB

MongoDB är standarddatabasen för NodeBB.

Installera MongoDB.

sudo pkg install -y mongodb40

Kontrollera versionen.

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

Aktivera och starta MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

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

Anslut till MongoDB 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 se till att den administrativa användaren som skapats tidigare kan ansluta.

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

Installera och konfigurera Nginx

Installera Nginx.

sudo pkg install -y nginx

Kontrollera versionen.

nginx -v
# nginx version: nginx/1.14.2

Aktivera och starta Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

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

Kör sudo vim /usr/local/etc/nginx/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";
  }

}

I ovanstående konfiguration uppdaterar du server_namedirektivet med din domän/värdnamn.

Spara filen och avsluta med :+ W+ Q.

Nu måste vi inkludera nodebb.confi huvudfilen nginx.conf.

Kör sudo vim /usr/local/etc/nginx/nginx.confoch lägg till följande rad i http {}blocket.

include nodebb.conf;

Kontrollera konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo service nginx reload

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 ~

Kontrollera versionen.

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

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 service nginx reload" --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 service nginx reload"  --keylength ec-256

När du har kört ovanstående kommandon kommer dina certifikat och nycklar att finnas i:

• 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 /usr/local/etc/nginx/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 service nginx reload

Installera NodeBB

Skapa en rotkatalog för dokument.

sudo mkdir -p /usr/local/www/nodebb

Ändra ägande av /usr/local/www/nodebbkatalogen till johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/nodebb

Navigera till dokumentets rotmapp.

cd /usr/local/www/nodebb

Klona den senaste NodeBB i dokumentets rotmapp.

git clone -b v1.11.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 din NodeBB-foruminstans i en webbläsare.

Kör NodeBB med PM2

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

Installera PM2 globalt.

sudo npm install pm2 -g

Kontrollera versionen.

pm2 -v
# 3.5.0

Navigera till NodeBB-dokumentroten.

cd /usr/local/www/nodebb

Starta NodeBB via PM2.

pm2 start app.js

Lista NodeBB-processen.

pm2 ls

Upptäck det tillgängliga init-systemet.

pm2 startup

Kopiera och klistra in utgången av detta kommando i CLI för att ställa in din startkrok.

Spara din processlista.

pm2 save

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