Jak nainstalovat fórum NodeBB na Debian 9

Požadavky

Než začnete

Nainstalujte Node.js

Nainstalujte a nakonfigurujte MongoDB

Nainstalujte a nakonfigurujte Nginx

Nainstalujte klienta Acme.sh a získejte certifikát Let's Encrypt (volitelné)

Nainstalujte NodeBB

Spusťte NodeBB jako systémovou službu

NodeBB je fórum založené na Node.js. Využívá webové zásuvky pro okamžité interakce a upozornění v reálném čase. Zdrojový kód NodeBB je veřejně hostován na Github . Tato příručka vás provede instalačním procesem NodeBB na čerstvé instanci Debian 9 Vultr pomocí Node.js, MongoDB jako databáze, Nginx jako reverzní proxy a Acme.sh pro SSL certifikáty.

Požadavky

NodeBB vyžaduje instalaci následujícího softwaru:

• Git
• Node.js verze 6.9.0 nebo novější
• MongoDB verze 2.6 nebo novější
• Nginx
• Minimálně 1024 MB RAM
• Název domény s nastavenými záznamy A/AAAA

Než začnete

Zkontrolujte verzi Debianu.

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

Ujistěte se, že váš systém je aktuální.

apt update && apt upgrade -y

Nainstalujte potřebné balíčky.

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

Vytvořte nový non-rootuživatelský účet s sudopřístupem a přepněte na něj.

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

POZNÁMKA : Nahraďte johndoesvým uživatelským jménem.

Nastavte časové pásmo.

sudo dpkg-reconfigure tzdata

Nainstalujte Node.js

NodeBB je řízen Node.js, a proto je třeba jej nainstalovat. Doporučuje se instalace aktuální LTS verze Node.js.

Nainstalujte Node.js z úložiště NodeSource.

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

Ověřte instalaci Node.js a npm.

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

Nainstalujte a nakonfigurujte MongoDB

MongoDB je výchozí databáze pro NodeBB.

Nainstalujte MongoDB z oficiálního úložiště 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

Zkontrolujte verzi.

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

Spusťte a povolte MongoDB.

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

Vytvořte databázi MongoDB a uživatele pro NodeBB.

Připojte se k MongoDB.

mongo

Přepněte do vestavěné admindatabáze.

> use admin

Vytvořte 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>svým vlastním vybraným heslem.

Přidejte novou databázi s názvem nodebb.

> use nodebb

Databáze se vytvoří a kontext se přepne na nodebb. Dále vytvořte nodebbuživatele s příslušnými oprávněními.

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

POZNÁMKA: Znovu nahraďte zástupný symbol <Enter a secure password>svým vlastním vybraným heslem.

Opusťte Mongo shell.

> quit()

Restartujte MongoDB a ověřte, že se může připojit dříve vytvořený administrativní uživatel.

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

Nainstalujte a nakonfigurujte Nginx

Nainstalujte nejnovější verzi hlavní řady Nginx z oficiálního úložiště 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/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

Zkontrolujte verzi.

sudo nginx -v
# nginx version: nginx/1.15.0

Povolte a spusťte Nginx.

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

NodeBB ve výchozím nastavení běží na portu 4567. Abychom se vyhnuli psaní http://example.com:4567, nakonfigurujeme Nginx jako reverzní proxy pro aplikaci NodeBB. Každý požadavek na port 80nebo 443(pokud je použito SSL) bude přesměrován na port 4567.

Spusťte sudo vim /etc/nginx/conf.d/nodebb.confa naplňte jej základní konfigurací reverzního proxy, která je zobrazena níže.

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

}

Ve výše uvedené konfiguraci aktualizujte server_namedirektivu svou doménou/ názvem hostitele.

Zkontrolujte konfiguraci.

sudo nginx -t

Znovu načtěte Nginx.

sudo systemctl reload nginx.service

Nainstalujte klienta Acme.sh a získejte certifikát Let's Encrypt (volitelné)

Zabezpečení fóra pomocí HTTPS není nutné, ale zajistí provoz vašeho webu. Acme.sh je čistě unixový shell software pro získávání SSL certifikátů od Let's Encrypt s nulovými závislostmi.

Stáhněte a nainstalujte 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

Zkontrolujte verzi.

acme.sh --version
# v2.7.9

Získejte certifikáty RSA a ECDSA pro 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 spuštění výše uvedených příkazů budou vaše certifikáty a klíče v následujících adresářích:

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

Po získání certifikátů z Let's Encrypt musíme nakonfigurovat Nginx, aby je používal.

Spusťte sudo vim /etc/nginx/conf.d/nodebb.confznovu a nakonfigurujte Nginx jako HTTPS reverzní 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";
  }

}

Zkontrolujte konfiguraci.

sudo nginx -t

Znovu načtěte Nginx.

sudo systemctl reload nginx.service

Nainstalujte NodeBB

Vytvořte kořenový adresář dokumentu.

sudo mkdir -p /var/www/nodebb

Změnit vlastnictví /var/www/nodebbadresáře na johndoe.

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

Přejděte do kořenové složky dokumentu.

cd /var/www/nodebb

Naklonujte nejnovější NodeBB do kořenové složky dokumentu.

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

Spusťte instalační příkaz NodeBB a po zobrazení výzvy odpovězte na každou otázku.

./nodebb setup

Po dokončení nastavení NodeBB spusťte ./nodebb startručně svůj server NodeBB.

./nodebb start

Po tomto příkazu budete mít přístup k vašemu fóru ve vašem webovém prohlížeči.

Spusťte NodeBB jako systémovou službu

Při ./nodebb startspuštění přes , NodeBB se automaticky znovu nespustí, když se systém restartuje. Abychom tomu zabránili, budeme muset nastavit NodeBB jako systémovou službu.

Pokud běží, zastavte NodeBB.

./nodebb stop

Vytvořit nového nodebbuživatele:

sudo adduser nodebb

Změňte vlastnictví /var/www/nodebbadresáře na nodebb.

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

Vytvořte nodebb.servicekonfigurační soubor systémové jednotky. Tento soubor jednotky se postará o spuštění démona NodeBB. Spusťte sudo vim /etc/systemd/system/nodebb.servicea naplňte soubor následujícím obsahem:

[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 uživatelské jméno a cestu k adresáři podle vámi zvolených jmen.

Povolit nodebb.servicepři restartu a okamžitě spustit nodebb.service.

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

Zkontrolujte nodebb.servicestav.

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

A je to. Vaše instance NodeBB je nyní v provozu.