Hur man installerar NodeBB-forum på Fedora 28

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 NodeBB-installationsprocessen på en ny Fedora 28 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 Fedora-versionen.

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

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

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

OBS : Ersätt johndoemed ditt användarnamn.

Ställ in tidszonen.

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

Se till att ditt system är uppdaterat.

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

Installera nödvändiga paket.

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

För enkelhets skull, inaktivera SELinux och brandvägg.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

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.

sudo dnf install -y nodejs

Verifiera installationen av Node.js och npm.

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

Installera och konfigurera MongoDB

MongoDB är standarddatabasen för NodeBB.

Installera MongoDB.

sudo dnf install -y mongodb mongodb-server

Kontrollera versionen.

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

Aktivera och starta MongoDB-tjänsten.

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

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

Anslut först till MongoDB-servern.

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 mongod.service
mongo -u admin -p your_password --authenticationDatabase=admin

Installera och konfigurera Nginx

Installera Nginx.

sudo dnf install -y nginx

Kontrollera versionen.

sudo nginx -v
# nginx version: nginx/1.12.1

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

}

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

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

Skaffa RSA- och ECDSA-certifikat för forum.example.comdomänen/värdnamnet.

# 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 kommandona ovan 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 i 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 den är igång, stoppa NodeBB.

./nodebb stop

Skapa en ny nodebbanvändare.

sudo useradd 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.