Requisits
Abans que comencis
Instal·leu Node.js
Instal·leu i configureu MongoDB
Instal·leu i configureu Nginx
Instal·leu el client Acme.sh i obteniu un certificat Let's Encrypt (opcional)
Instal·leu NodeBB
Executeu NodeBB com a servei del sistema
NodeBB és un fòrum basat en Node.js. Utilitza endolls web per a interaccions instantànies i notificacions en temps real. El codi font de NodeBB està allotjat públicament a Github . Aquesta guia us guiarà pel procés d'instal·lació de NodeBB en una nova instància Vultr d'Ubuntu 18.04 LTS utilitzant Node.js, MongoDB com a base de dades, Nginx com a servidor intermediari invers i Acme.sh per a certificats SSL.
Requisits
NodeBB requereix instal·lar el programari següent:
- Git
- Node.js versió 6.9.0 o posterior
- MongoDB versió 2.6 o posterior
- Nginx
- Mínim de 1024 MB de RAM
- Nom de domini amb
A/ AAAAregistres configurats
Abans que comencis
Comproveu la versió d'Ubuntu.
lsb_release -ds
# Ubuntu 18.04 LTS
Creeu un non-rootcompte d'usuari nou amb sudoaccés i canvieu-hi.
adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe
NOTA : Substituïu-lo johndoepel vostre nom d'usuari.
Configura la zona horària.
sudo dpkg-reconfigure tzdata
Assegureu-vos que el vostre sistema estigui actualitzat.
sudo apt update && sudo apt upgrade -y
Instal·leu els paquets necessaris.
sudo apt install -y git build-essential apt-transport-https
Instal·leu Node.js
NodeBB està impulsat per Node.js i, per tant, cal instal·lar-lo. Es recomana la instal·lació de la versió LTS actual de Node.js.
Instal·leu Node.js des del repositori NodeSource.
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs
Verifiqueu la instal·lació de Node.js i npm.
node -v && npm -v
# v10.15.0
# 5.6.0
MongoDB és la base de dades predeterminada per a NodeBB.
Instal·leu MongoDB.
sudo apt install -y mongodb
Comproveu la versió.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
Creeu una base de dades MongoDB i un usuari per a NodeBB.
Connecteu-vos primer al servidor MongoDB.
mongo
Canvia a la adminbase de dades integrada .
> use admin
Crear un usuari administratiu.
> db.createUser( { user: "admin", pwd: "<Enter a secure password>", roles: [ { role: "readWriteAnyDatabase", db: "admin" }, { role: "userAdminAnyDatabase", db: "admin" } ] } )
NOTA: Substituïu el marcador de posició <Enter a secure password>per la vostra pròpia contrasenya seleccionada.
Afegiu una nova base de dades anomenada nodebb.
> use nodebb
Es crearà la base de dades i el context es canviarà a nodebb. A continuació, creeu l' nodebbusuari amb els privilegis adequats.
> db.createUser( { user: "nodebb", pwd: "<Enter a secure password>", roles: [ { role: "readWrite", db: "nodebb" }, { role: "clusterMonitor", db: "admin" } ] } )
NOTA: de nou, substituïu el marcador de posició <Enter a secure password>per la vostra pròpia contrasenya seleccionada.
Sortiu de la closca de Mongo.
> quit()
Reinicieu MongoDB i comproveu que l'usuari administratiu creat anteriorment es pugui connectar.
sudo systemctl restart mongodb.service
mongo -u admin -p your_password --authenticationDatabase=admin
Instal·leu la darrera versió principal de Nginx des del dipòsit oficial de Nginx.
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/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx
Comproveu la versió.
sudo nginx -v
# nginx version: nginx/1.15.0
Activeu i inicieu Nginx.
sudo systemctl enable nginx.service
sudo systemctl start nginx.service
NodeBB s'executa per defecte al port 4567. Per evitar haver d'escriure http://example.com:4567, configurarem Nginx com a servidor intermediari invers per a l'aplicació NodeBB. Cada sol·licitud al port 80o 443(si s'utilitza SSL) es reenviarà al port 4567.
Executeu-lo sudo vim /etc/nginx/conf.d/nodebb.confi empleneu-lo amb la configuració bàsica del servidor intermediari invers a continuació.
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";
}
}
Note: Update the server_name directive with your domain/hostname.
Check the configuration.
sudo nginx -t
Reload Nginx.
sudo systemctl reload nginx.service
Install the Acme.sh client and obtain a Let's Encrypt certificate (optional)
Securing your forum with HTTPS is not necessary, but it will secure your site's traffic. Acme.sh is a pure unix shell software for obtaining SSL certificates from Let's Encrypt with zero dependencies.
Download and install 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
Check the version.
acme.sh --version
# v2.7.9
Obtain RSA and ECDSA certificates for 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
After running the above commands, your certificates and keys will be in the following directories:
- RSA:
/etc/letsencrypt/forum.example.com
- ECC/ECDSA:
/etc/letsencrypt/forum.example.com_ecc
After obtaining certificates from Let's Encrypt, we need to configure Nginx to use them.
Run sudo vim /etc/nginx/conf.d/nodebb.conf again and configure Nginx as an HTTPS reverse 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";
}
}
Check the configuration.
sudo nginx -t
Reload Nginx.
sudo systemctl reload nginx.service
Install NodeBB
Create a document root directory.
sudo mkdir -p /var/www/nodebb
Canvia la propietat del /var/www/nodebbdirectori a johndoe.
sudo chown -R johndoe:johndoe /var/www/nodebb
Navegueu a la carpeta arrel del document.
cd /var/www/nodebb
Cloneu la darrera versió de NodeBB a la carpeta arrel del document.
git clone -b v1.10.x https://github.com/NodeBB/NodeBB.git .
Executeu l'ordre de configuració de NodeBB i responeu a cada pregunta quan se us demani.
./nodebb setup
Un cop finalitzada la configuració de NodeBB, executeu-lo ./nodebb startper iniciar manualment el vostre servidor NodeBB.
./nodebb start
Després d'aquesta ordre, podreu accedir al vostre fòrum al vostre navegador web.
Executeu NodeBB com a servei del sistema
Quan s'inicia mitjançant ./nodebb start, NodeBB no es tornarà a iniciar automàticament quan es reiniciï el sistema. Per evitar-ho, haurem de configurar NodeBB com a servei del sistema.
Si s'executa, atureu NodeBB.
./nodebb stop
Creeu un nou nodebbusuari sense privilegis .
sudo adduser nodebb
Canvia la propietat del /var/www/nodebbdirectori a nodebbusuari.
sudo chown -R nodebb:nodebb /var/www/nodebb
Creeu el nodebb.servicefitxer de configuració de la unitat systemd. Aquest fitxer unitat gestionarà l'inici del dimoni NodeBB. Executeu sudo vim /etc/systemd/system/nodebb.servicei ompliu el fitxer amb el contingut següent:
[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
NOTA: Establiu el nom d'usuari i els camins del directori segons els noms escollits.
Habilita nodebb.serviceen reiniciar i començar immediatament nodebb.service.
sudo systemctl enable nodebb.service
sudo systemctl start nodebb.service
Comproveu l' nodebb.serviceestat.
sudo systemctl status nodebb.service
sudo systemctl is-enabled nodebb.service
Això és. La vostra instància de NodeBB ja està en funcionament.