Ako nainštalovať fórum NodeBB na Fedore 28

Požiadavky

Predtým ako začneš

Nainštalujte Node.js

Nainštalujte a nakonfigurujte MongoDB

Nainštalujte a nakonfigurujte Nginx

Nainštalujte klienta Acme.sh a získajte certifikát Let's Encrypt (voliteľné)

Nainštalujte NodeBB

Spustite NodeBB ako systémovú službu

NodeBB je fórum založené na Node.js. Využíva webové zásuvky na okamžité interakcie a upozornenia v reálnom čase. Zdrojový kód NodeBB je verejne hosťovaný na serveri Github . Táto príručka vás prevedie procesom inštalácie NodeBB na novej inštancii Fedora 28 Vultr pomocou Node.js, MongoDB ako databázy, Nginx ako reverzného proxy a Acme.sh pre SSL certifikáty.

Požiadavky

NodeBB vyžaduje, aby bol nainštalovaný nasledujúci softvér:

• Git
• Node.js verzie 6.9.0 alebo novšej
• MongoDB verzia 2.6 alebo novšia
• Nginx
• Minimálne 1024 MB RAM
• Názov domény s nastavenými záznamami A/AAAA

Predtým ako začneš

Skontrolujte verziu Fedory.

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

Vytvorte nový používateľský účet typu non-root s sudoprístupom a prepnite sa naň.

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

POZNÁMKA : Nahraďte johndoesvojím užívateľským menom.

Nastavte časové pásmo.

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

Uistite sa, že váš systém je aktuálny.

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

Nainštalujte potrebné balíčky.

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

Pre jednoduchosť vypnite SELinux a Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Nainštalujte Node.js

NodeBB je riadený Node.js, a preto je potrebné ho nainštalovať. Odporúča sa inštalácia aktuálnej verzie LTS Node.js.

Nainštalujte Node.js.

sudo dnf install -y nodejs

Overte inštaláciu súborov Node.js a npm.

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

Nainštalujte a nakonfigurujte MongoDB

MongoDB je predvolená databáza pre NodeBB.

Nainštalujte MongoDB.

sudo dnf install -y mongodb mongodb-server

Skontrolujte verziu.

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

Povoľte a spustite službu MongoDB.

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

Vytvorte databázu MongoDB a používateľa pre NodeBB.

Najprv sa pripojte k serveru MongoDB.

mongo

Prepnite na vstavanú admindatabázu.

> use admin

Vytvorte administrátora.

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

POZNÁMKA: Nahraďte zástupný symbol <Enter a secure password>vlastným vybratým heslom.

Pridajte novú databázu s názvom nodebb.

> use nodebb

Vytvorí sa databáza a kontext sa prepne na nodebb. Potom vytvorte nodebbpoužívateľa s príslušnými oprávneniami.

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

POZNÁMKA: Zástupný symbol opäť nahraďte <Enter a secure password>vlastným zvoleným heslom.

Opustite Mongo shell.

> quit()

Reštartujte MongoDB a skontrolujte, či sa môže pripojiť skôr vytvorený administrátor.

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

Nainštalujte a nakonfigurujte Nginx

Nainštalujte Nginx.

sudo dnf install -y nginx

Skontrolujte verziu.

sudo nginx -v
# nginx version: nginx/1.12.1

Povoľte a spustite Nginx.

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

NodeBB štandardne beží na porte 4567. Aby http://example.com:4567sme sa vyhli zadávaniu , nakonfigurujeme Nginx ako reverzný proxy pre aplikáciu NodeBB. Každá požiadavka na port 80alebo 443( ak sa používa SSL ) bude presmerovaná na port 4567.

Spustite sudo vim /etc/nginx/conf.d/nodebb.confa naplňte ho základnou konfiguráciou reverzného servera proxy nižšie.

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

}

In the config above, update the server_name directive with your domain/hostname.

Check the configuration.

sudo nginx -t

Reload Nginx.

sudo systemctl reload nginx.service

Install 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 [email protected]
cd ~
source ~/.bashrc

Check the version.

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

Obtain RSA and ECDSA certificates for the forum.example.com domain/hostname.

# 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

After running the commands above, 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

Vytvorte koreňový adresár dokumentu.

sudo mkdir -p /var/www/nodebb

Zmeňte vlastníctvo /var/www/nodebbadresára na johndoe.

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

Prejdite do koreňového priečinka dokumentu.

cd /var/www/nodebb

Naklonujte najnovší NodeBB do koreňového priečinka dokumentu.

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

Spustite príkaz nastavenia NodeBB a po zobrazení výzvy odpovedzte na každú otázku.

./nodebb setup

Po dokončení nastavenia NodeBB spustite ./nodebb startmanuálne spustenie servera NodeBB.

./nodebb start

Po tomto príkaze budete mať prístup k vášmu fóru vo webovom prehliadači.

Spustite NodeBB ako systémovú službu

Pri ./nodebb startspustení cez , NodeBB sa po reštarte systému automaticky znova nespustí. Aby sme tomu zabránili, budeme musieť nastaviť NodeBB ako systémovú službu.

Ak je spustený, zastavte NodeBB.

./nodebb stop

Vytvorte nového nodebbpoužívateľa.

sudo useradd nodebb

Zmeňte vlastníctvo /var/www/nodebbadresára na nodebbpoužívateľa.

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

Vytvorte nodebb.servicekonfiguračný súbor systémovej jednotky. Tento súbor jednotky sa postará o spustenie démona NodeBB. Spustite sudo vim /etc/systemd/system/nodebb.servicea naplňte súbor nasledujúcim obsahom.

[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

POZNÁMKA: Nastavte používateľské meno a cestu k adresáru podľa vybratých mien.

Povoliť nodebb.servicepri reštarte a okamžite spustiť nodebb.service.

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

Skontrolujte nodebb.servicestav.

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

To je všetko. Vaša inštancia NodeBB je teraz v prevádzke.