Hvernig á að setja upp NodeBB spjallborð á Debian 9

NodeBB er vettvangur sem byggir á Node.js. Það notar vefinnstungur fyrir tafarlaus samskipti og rauntíma tilkynningar. NodeBB frumkóði er hýst opinberlega á Github . Þessi handbók mun leiða þig í gegnum NodeBB uppsetningarferlið á nýju Debian 9 Vultr tilviki með því að nota Node.js, MongoDB sem gagnagrunn, Nginx sem öfugt umboð og Acme.sh fyrir SSL vottorð.

Kröfur

NodeBB krefst þess að eftirfarandi hugbúnaður sé uppsettur:

• Git
• Node.js útgáfa 6.9.0 eða nýrri
• MongoDB útgáfa 2.6 eða nýrri
• Nginx
• Lágmark 1024MB vinnsluminni
• Lén með A/ AAAAskrár sett upp

Áður en þú byrjar

Athugaðu Debian útgáfuna.

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

Gakktu úr skugga um að kerfið þitt sé uppfært.

apt update && apt upgrade -y

Settu upp nauðsynlega pakka.

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

Búðu til nýjan non-rootnotandareikning með sudoaðgangi og skiptu yfir í hann.

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

ATH : Skiptu út johndoefyrir notendanafnið þitt.

Settu upp tímabeltið.

sudo dpkg-reconfigure tzdata

Settu upp Node.js

NodeBB er knúið áfram af Node.js og því þarf að setja það upp. Mælt er með uppsetningu á núverandi LTS útgáfu af Node.js.

Settu upp Node.js frá NodeSource geymslunni.

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

Staðfestu uppsetningu á Node.js og npm.

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

Settu upp og stilltu MongoDB

MongoDB er sjálfgefinn gagnagrunnur fyrir NodeBB.

Settu upp MongoDB frá opinberu MongoDB geymslunni.

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

Athugaðu útgáfuna.

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

Ræstu og virkjaðu MongoDB.

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

Búðu til MongoDB gagnagrunn og notanda fyrir NodeBB.

Tengstu við MongoDB.

mongo

Skiptu yfir í innbyggða admingagnagrunninn.

> use admin

Búðu til stjórnunarnotanda.

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

ATHUGIÐ: Skiptu um staðgengil <Enter a secure password>fyrir þitt eigið lykilorð.

Bættu við nýjum gagnagrunni sem heitir nodebb.

> use nodebb

Gagnagrunnurinn verður búinn til og samhengi skipt yfir í nodebb. Næst skaltu búa til nodebbnotandann með viðeigandi réttindi.

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

ATHUGIÐ: Aftur skaltu skipta um staðgengil <Enter a secure password>fyrir þitt eigið lykilorð.

Farðu úr Mongo skelinni.

> quit()

Endurræstu MongoDB og staðfestu að stjórnunarnotandinn sem var búinn til áður geti tengst.

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

Settu upp og stilltu Nginx

Settu upp nýjustu aðalútgáfuna af Nginx frá opinberu Nginx geymslunni.

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

Athugaðu útgáfuna.

sudo nginx -v
# nginx version: nginx/1.15.0

Virkjaðu og ræstu Nginx.

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

NodeBB, sjálfgefið, keyrir á port 4567. Til að forðast að slá inn http://example.com:4567munum við stilla Nginx sem öfugt umboð fyrir NodeBB forritið. Sérhver beiðni um höfn 80eða 443(ef SSL er notað) verður send á höfn 4567.

Keyrðu sudo vim /etc/nginx/conf.d/nodebb.confog fylltu það út með grunnstillingu um öfugri proxy sem sýnd er hér að neðan.

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

}

Í stillingunni hér að ofan, uppfærðu server_nametilskipunina með léninu/hýsingarnafninu þínu.

Athugaðu stillinguna.

sudo nginx -t

Endurhlaða Nginx.

sudo systemctl reload nginx.service

Settu upp Acme.sh viðskiptavin og fáðu Let's Encrypt vottorð (valfrjálst)

Það er ekki nauðsynlegt að tryggja spjallborðið þitt með HTTPS, en það mun tryggja umferð vefsvæðisins þíns. Acme.sh er hreinn Unix skel hugbúnaður til að fá SSL vottorð frá Let's Encrypt með núll ósjálfstæði.

Sæktu og settu upp 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

Athugaðu útgáfuna.

acme.sh --version
# v2.7.9

Fáðu RSA og ECDSA vottorð fyrir 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

Eftir að hafa keyrt ofangreindar skipanir verða vottorð þín og lyklar í eftirfarandi möppum:

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

Eftir að hafa fengið vottorð frá Let's Encrypt þurfum við að stilla Nginx til að nota þau.

Keyrðu sudo vim /etc/nginx/conf.d/nodebb.confaftur og stilltu Nginx sem HTTPS öfugt umboð.

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

}

Athugaðu stillinguna.

sudo nginx -t

Endurhlaða Nginx.

sudo systemctl reload nginx.service

Settu upp NodeBB

Búðu til rótarskrá skjalsins.

sudo mkdir -p /var/www/nodebb

Breyttu eignarhaldi /var/www/nodebbmöppunnar í johndoe.

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

Farðu í rótarmöppuna skjalsins.

cd /var/www/nodebb

Klónaðu nýjasta NodeBB í rótarmöppu skjalsins.

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

Keyrðu NodeBB uppsetningarskipunina og svaraðu hverri spurningu þegar beðið er um það.

./nodebb setup

Eftir að uppsetningu NodeBB er lokið skaltu keyra ./nodebb starttil að ræsa NodeBB netþjóninn þinn handvirkt.

./nodebb start

Eftir þessa skipun muntu geta opnað spjallborðið þitt í vafranum þínum.

Keyra NodeBB sem kerfisþjónustu

Þegar ræst er í gegnum ./nodebb startmun NodeBB ekki sjálfkrafa ræsa aftur þegar kerfið endurræsir. Til að forðast það verðum við að setja upp NodeBB sem kerfisþjónustu.

Ef þú keyrir skaltu stöðva NodeBB.

./nodebb stop

Búðu til nýjan nodebbnotanda:

sudo adduser nodebb

Breyttu eignarhaldi /var/www/nodebbmöppunnar í nodebb.

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

Búðu til nodebb.servicesystemd unit config file. Þessi einingaskrá mun sjá um ræsingu NodeBB deamon. Keyrðu sudo vim /etc/systemd/system/nodebb.serviceog fylltu út skrána með eftirfarandi efni:

[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

ATHUGIÐ: Stilltu notendanafn og skráarslóðir í samræmi við valin nöfn.

Virkjaðu nodebb.servicevið endurræsingu og byrjaðu strax nodebb.service.

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

Athugaðu nodebb.servicestöðuna.

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

Það er það. NodeBB tilvikið þitt er nú í gangi.