Hvernig á að setja upp NodeBB Forum á Ubuntu 18.04 LTS

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 Ubuntu 18.04 LTS 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 Ubuntu útgáfuna.

lsb_release -ds
# Ubuntu 18.04 LTS

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

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

sudo apt update && sudo apt upgrade -y

Settu upp nauðsynlega pakka.

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

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.

sudo apt install -y mongodb

Athugaðu útgáfuna.

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

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

Tengstu fyrst við MongoDB miðlara.

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 nodebbnotanda 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 mongodb.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/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

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 keyrir sjálfgefið á port 4567. Til að forðast að þurfa 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 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";
  }

}

Athugið: 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ðskiptavininn 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ýjustu útgáfuna af NodeBB í skjalrótarmöppuna.

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 án forréttinda .

sudo adduser nodebb

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

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

Búðu til nodebb.servicestillingarskrá fyrir systemd unit. Þessi einingaskrá mun sjá um ræsingu NodeBB djöfulsins. Keyrðu sudo vim /etc/systemd/system/nodebb.serviceog fylltu 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.