Cum se instalează forumul NodeBB pe FreeBSD 12

• cerinţe
• Înainte de a începe
• Instalați Node.js
• Instalați și configurați MongoDB
• Instalați și configurați Nginx
• Instalați clientul Acme.sh și obțineți un certificat Let's Encrypt (opțional)
• Instalați NodeBB
• Rulați NodeBB cu PM2

NodeBB este un software de forum bazat pe Node.js. Utilizează prize web pentru interacțiuni instantanee și notificări în timp real. Codul sursă NodeBB este găzduit public pe Github . Acest ghid vă va parcurge procesul de instalare NodeBB pe o nouă instanță FreeBSD 12 Vultr, folosind Node.js, MongoDB ca bază de date, Nginx ca proxy invers și Acme.sh pentru certificatele SSL.

cerinţe

NodeBB necesită instalarea următorului software:

• Node.js versiunea 6.9.0 sau mai mare
• MongoDB versiunea 2.6 sau mai mare
• Nginx
• git
• Minim de 1024 MB RAM
• Nume de domeniu cu A/ AAAAînregistrări configurate

Înainte de a începe

Verificați versiunea FreeBSD.

uname -ro
# FreeBSD 12.0-RELEASE

Asigurați-vă că sistemul dvs. FreeBSD este actualizat.

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

Instalați pachetele necesare dacă nu sunt prezente pe sistemul dvs.

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

Creați un cont de utilizator nou cu numele de utilizator preferat (vom folosi 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!

Rulați visudocomanda și dezarhivați %wheel ALL=(ALL) ALLlinia, pentru a permite membrilor wheelgrupului să execute orice comandă.

visudo

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

Acum, treceți la un utilizator nou creat cu su.

su - johndoe

NOTĂ: Înlocuiți johndoecu numele de utilizator.

Setați fusul orar.

sudo tzsetup

Instalați Node.js

NodeBB este condus de Node.js, deci trebuie instalat. Instalarea actuală versiune LTS a Node.js este recomandată.

Instalați Node.js și npm.

sudo pkg install -y node10 npm-node10

Verificați versiunile.

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

Instalați și configurați MongoDB

MongoDB este baza de date implicită pentru NodeBB.

Instalați MongoDB.

sudo pkg install -y mongodb40

Verificați versiunea.

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

Activați și porniți MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Creați o bază de date și un utilizator pentru NodeBB.

Conectați-vă mai întâi la MongoDB.

mongo

Comutați la adminbaza de date încorporată .

> use admin

Creați un utilizator administrativ.

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

NOTĂ: Înlocuiți locomotorul <Enter a secure password>cu parola dvs. selectată.

Adăugați o nouă bază de date numită nodebb.

> use nodebb

Baza de date va fi creată și contextul va fi schimbat nodebb. Apoi creați nodebbutilizatorul cu privilegiile corespunzătoare.

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

NOTĂ: Încă o dată, înlocuiți locomotorul <Enter a secure password>cu parola dvs. selectată.

Ieșiți din coaja Mongo.

> quit()

Reporniți MongoDB și asigurați-vă că utilizatorul administrativ creat anterior se poate conecta.

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

Instalați și configurați Nginx

Instalați Nginx.

sudo pkg install -y nginx

Verificați versiunea.

nginx -v
# nginx version: nginx/1.14.2

Activați și porniți Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

NodeBB rulează în mod implicit pe port 4567. Pentru a evita tastarea http://example.com:4567, vom configura Nginx ca un proxy invers pentru aplicația NodeBB. Fiecare solicitare pe port 80sau 443, dacă se folosește SSL, va fi transmisă portului 4567.

Rulați sudo vim /usr/local/etc/nginx/nodebb.confși populați-l cu configurația de bază a proxy-ului invers de mai jos.

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

}

În configurația de mai sus, actualizați server_namedirectiva cu numele / numele dvs. de gazdă.

Salvați fișierul și ieșiți cu :+ W+ Q.

Acum trebuie să includem nodebb.confîn nginx.conffișierul principal .

Rulați sudo vim /usr/local/etc/nginx/nginx.confși adăugați următoarea linie la http {}bloc.

include nodebb.conf;

Verificați configurația.

sudo nginx -t

Reîncărcați Nginx.

sudo service nginx reload

Instalați clientul Acme.sh și obțineți un certificat Let's Encrypt (opțional)

Securizarea forumului dvs. cu HTTPS nu este necesară, dar va asigura traficul site-ului dvs. Acme.sh este un software pur shell unix pentru obținerea certificatelor SSL de la Let's Encrypt cu zero dependențe.

Descărcați și instalați 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 ~

Verificați versiunea.

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

Obțineți certificate RSA și ECDSA pentru 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

După executarea comenzilor de mai sus, certificatele și cheile dvs. vor fi în:

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

După obținerea certificatelor de la Let's Encrypt, trebuie să configurăm Nginx pentru a le folosi.

Rulați sudo vim /usr/local/etc/nginx/nodebb.confdin nou și configurați Nginx ca proxy invers 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";
  }

}

Verificați configurația.

sudo nginx -t

Reîncărcați Nginx.

sudo service nginx reload

Instalați NodeBB

Creați un director rădăcină document.

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

Schimbați proprietatea /usr/local/www/nodebbdirectorului în johndoe.

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

Navigați la folderul rădăcină al documentului.

cd /usr/local/www/nodebb

Clonați cel mai recent NodeBB în folderul rădăcină document.

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

Rulați comanda de configurare NodeBB și răspundeți la fiecare întrebare atunci când vi se solicită.

./nodebb setup

După finalizarea instalării NodeBB, executați ./nodebb startpentru a porni manual serverul dvs. NodeBB.

./nodebb start

După această comandă, veți putea accesa instanța de forum NodeBB într-un browser web.

Rulați NodeBB cu PM2

Când a fost pornit prin ./nodebb start, NodeBB nu se va reporni automat când sistemul se repornește. Pentru a evita acest lucru, va trebui să configurați NodeBB ca serviciu de sistem.

Dacă rulează, opriți NodeBB.

./nodebb stop

Instalați PM2 la nivel global.

sudo npm install pm2 -g

Verificați versiunea.

pm2 -v
# 3.5.0

Navigați la rădăcina documentului NodeBB.

cd /usr/local/www/nodebb

Porniți NodeBB prin PM2.

pm2 start app.js

Enumerați procesul NodeBB.

pm2 ls

Detectează sistemul inițial disponibil.

pm2 startup

Copiați și lipiți ieșirea acestei comenzi în CLI pentru a configura cârligul de pornire.

Salvați lista de procese.

pm2 save

Asta e. Instanța dvs. NodeBB este acum funcțională.