Kako namestiti forum NodeBB v Debian 9

NodeBB je forum, ki temelji na Node.js. Uporablja spletne vtičnice za takojšnje interakcije in obvestila v realnem času. Izvorna koda NodeBB je javno gostovana na Githubu . Ta vodnik vas bo vodil skozi postopek namestitve NodeBB na novem primerku Debian 9 Vultr z uporabo Node.js, MongoDB kot baze podatkov, Nginx kot povratnega proxyja in Acme.sh za potrdila SSL.

Zahteve

NodeBB zahteva, da je nameščena naslednja programska oprema:

• Git
• Node.js različice 6.9.0 ali novejše
• MongoDB različica 2.6 ali novejša
• Nginx
• Najmanj 1024 MB RAM-a
• Ime domene z A/ AAAAnastavljenimi zapisi

Preden začneš

Preverite različico Debiana.

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

Prepričajte se, da je vaš sistem posodobljen.

apt update && apt upgrade -y

Namestite potrebne pakete.

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

Ustvarite nov non-rootuporabniški račun z sudodostopom in preklopite nanj.

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

OPOMBA : Zamenjajte johndoes svojim uporabniškim imenom.

Nastavite časovni pas.

sudo dpkg-reconfigure tzdata

Namestite Node.js

NodeBB poganja Node.js, zato ga je treba namestiti. Priporočljiva je namestitev trenutne LTS različice Node.js.

Namestite Node.js iz repozitorija NodeSource.

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

Preverite namestitev Node.js in npm.

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

Namestite in konfigurirajte MongoDB

MongoDB je privzeta baza podatkov za NodeBB.

Namestite MongoDB iz uradnega repozitorija MongoDB.

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

Preverite različico.

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

Zaženite in omogočite MongoDB.

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

Ustvarite bazo podatkov MongoDB in uporabnika za NodeBB.

Povežite se z MongoDB.

mongo

Preklopite na vgrajeno adminbazo podatkov.

> use admin

Ustvarite skrbniškega uporabnika.

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

OPOMBA: Zamenjaj nadomestnega mesta <Enter a secure password>s svojim izbranim geslom.

Dodajte novo bazo podatkov z imenom nodebb.

> use nodebb

Baza podatkov bo ustvarjena in kontekst preklopljen na nodebb. Nato ustvarite nodebbuporabnika z ustreznimi privilegiji.

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

OPOMBA: Ponovno zamenjajte označbo mesta <Enter a secure password>s svojim izbranim geslom.

Zapustite lupino Mongo.

> quit()

Znova zaženite MongoDB in preverite, ali se lahko prej ustvarjeni skrbniški uporabnik poveže.

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

Namestite in konfigurirajte Nginx

Namestite najnovejšo glavno različico Nginxa iz uradnega skladišča Nginxa.

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

Preverite različico.

sudo nginx -v
# nginx version: nginx/1.15.0

Omogočite in zaženite Nginx.

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

NodeBB privzeto deluje na vratih 4567. Da bi se izognili tipkanju http://example.com:4567, bomo Nginx konfigurirali kot povratni proxy za aplikacijo NodeBB. Vsaka zahteva za vrata 80ali 443(če je uporabljen SSL) bo posredovana na vrata 4567.

Zaženite ga sudo vim /etc/nginx/conf.d/nodebb.confin ga zapolnite z osnovno konfiguracijo povratnega proxyja, prikazano spodaj.

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

}

V zgornji konfiguraciji posodobite server_namedirektivo s svojo domeno/imenom gostitelja.

Preverite konfiguracijo.

sudo nginx -t

Ponovno naložite Nginx.

sudo systemctl reload nginx.service

Namestite odjemalca Acme.sh in pridobite certifikat Let's Encrypt (izbirno)

Zaščita vašega foruma s HTTPS ni potrebna, vendar bo zavarovala promet na vašem spletnem mestu. Acme.sh je čista programska oprema Unixove lupine za pridobivanje SSL certifikatov iz Let's Encrypt z nič odvisnostmi.

Prenesite in namestite 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

Preverite različico.

acme.sh --version
# v2.7.9

Pridobite certifikate RSA in ECDSA za 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

Po zagonu zgornjih ukazov bodo vaši certifikati in ključi v naslednjih imenikih:

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

Po pridobitvi potrdil od Let's Encrypt moramo Nginx konfigurirati za njihovo uporabo.

Zaženite sudo vim /etc/nginx/conf.d/nodebb.confznova in konfigurirajte Nginx kot povratni proxy HTTPS.

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

}

Preverite konfiguracijo.

sudo nginx -t

Ponovno naložite Nginx.

sudo systemctl reload nginx.service

Namesti NodeBB

Ustvarite korenski imenik dokumenta.

sudo mkdir -p /var/www/nodebb

Spremenite lastništvo /var/www/nodebbimenika v johndoe.

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

Pomaknite se do korenske mape dokumenta.

cd /var/www/nodebb

Klonirajte najnovejši NodeBB v korensko mapo dokumenta.

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

Zaženite ukaz za namestitev NodeBB in odgovorite na vsako vprašanje, ko ste pozvani.

./nodebb setup

Ko je namestitev NodeBB končana, zaženite ./nodebb startročni zagon strežnika NodeBB.

./nodebb start

Po tem ukazu boste lahko v spletnem brskalniku dostopali do foruma.

Zaženite NodeBB kot sistemsko storitev

Ko se zažene prek ./nodebb start, se NodeBB ne bo samodejno znova zagnal, ko se sistem znova zažene. Da bi se temu izognili, bomo morali NodeBB nastaviti kot sistemsko storitev.

Če se izvaja, ustavite NodeBB.

./nodebb stop

Ustvarite novega nodebbuporabnika:

sudo adduser nodebb

Spremenite lastništvo /var/www/nodebbimenika v nodebb.

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

Ustvarite nodebb.servicekonfiguracijsko datoteko enote systemd. Ta datoteka enote bo obravnavala zagon NodeBB deamon. Zaženite sudo vim /etc/systemd/system/nodebb.servicein napolnite datoteko z naslednjo vsebino:

[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

OPOMBA: Nastavite uporabniško ime in poti imenika glede na izbrana imena.

Omogoči nodebb.serviceob ponovnem zagonu in takoj zaženi nodebb.service.

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

Preverite nodebb.servicestanje.

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

To je to. Vaš primerek NodeBB je zdaj pripravljen in deluje.