Hur man installerar NodeBB-forumet på Debian 9

Krav

Innan du börjar

Installera Node.js

Installera och konfigurera MongoDB

Installera och konfigurera Nginx

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

Installera NodeBB

Kör NodeBB som en systemtjänst

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 installationsprocessen för NodeBB på en ny Debian 9 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 Debian-versionen.

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

Se till att ditt system är uppdaterat.

apt update && apt upgrade -y

Installera nödvändiga paket.

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

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

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 från det officiella MongoDB-förrådet.

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

Kontrollera versionen.

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

Starta och aktivera MongoDB.

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

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

Anslut till MongoDB.

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 rättigheter.

> 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 mongod.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/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

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, som standard, körs 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 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 den med den grundläggande omvända proxykonfigurationen som visas 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 konfigurationen ovan uppdaterar du 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 en ren Unix-mjukvara 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 your_email@example.com
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 your_email@example.com --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 your_email@example.com --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 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 nodebbanvändare:

sudo adduser nodebb

Ändra ägarskapet för /var/www/nodebbkatalogen till nodebb.

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

Skapa en nodebb.servicesystemd-enhetskonfigurationsfil. Denna enhetsfil kommer att hantera start av NodeBB deamon. 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.