Как да инсталирате NodeBB Forum на Ubuntu 18.04 LTS

Изисквания

Преди да започнеш

Инсталирайте Node.js

Инсталирайте и конфигурирайте MongoDB

Инсталирайте и конфигурирайте Nginx

Инсталирайте клиента Acme.sh и получете сертификат Let's Encrypt (по избор)

Инсталирайте NodeBB

Стартирайте NodeBB като системна услуга

NodeBB е форум, базиран на Node.js. Той използва уеб сокети за незабавни взаимодействия и известия в реално време. Изходният код на NodeBB се хоства публично на Github . Това ръководство ще ви преведе през процеса на инсталиране на NodeBB на нов екземпляр на Ubuntu 18.04 LTS Vultr, използващ Node.js, MongoDB като база данни, Nginx като обратен прокси и Acme.sh за SSL сертификати.

Изисквания

NodeBB изисква инсталирането на следния софтуер:

• Git
• Node.js версия 6.9.0 или по-нова
• MongoDB версия 2.6 или по-нова
• Nginx
• Минимум 1024MB RAM
• Име на домейн с A/ AAAAнастроени записи

Преди да започнеш

Проверете версията на Ubuntu.

lsb_release -ds
# Ubuntu 18.04 LTS

Създайте нов non-rootпотребителски акаунт с sudoдостъп и превключете към него.

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

ЗАБЕЛЕЖКА : Заменете johndoeс вашето потребителско име.

Настройте часовата зона.

sudo dpkg-reconfigure tzdata

Уверете се, че вашата система е актуална.

sudo apt update && sudo apt upgrade -y

Инсталирайте необходимите пакети.

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

Инсталирайте Node.js

NodeBB се управлява от Node.js и затова трябва да бъде инсталиран. Препоръчва се инсталирането на текущата LTS версия на Node.js.

Инсталирайте Node.js от хранилището на NodeSource.

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

Проверете инсталирането на Node.js и npm.

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

Инсталирайте и конфигурирайте MongoDB

MongoDB е базата данни по подразбиране за NodeBB.

Инсталирайте MongoDB.

sudo apt install -y mongodb

Проверете версията.

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

Създайте база данни MongoDB и потребител за NodeBB.

Първо се свържете със сървъра на MongoDB.

mongo

Превключете към вградената adminбаза данни.

> use admin

Създайте административен потребител.

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

ЗАБЕЛЕЖКА: Заменете заместителя <Enter a secure password>с избраната от вас парола.

Добавете нова база данни, наречена nodebb.

> use nodebb

Базата данни ще бъде създадена и контекстът ще бъде превключен към nodebb. След това създайте nodebbпотребителя със съответните привилегии.

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

ЗАБЕЛЕЖКА: Отново заменете заместителя <Enter a secure password>с избраната от вас парола.

Излезте от обвивката на Mongo.

> quit()

Рестартирайте MongoDB и проверете дали създаденият по-рано администратор може да се свърже.

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

Инсталирайте и конфигурирайте Nginx

Инсталирайте най-новата основна версия на Nginx от официалното хранилище на 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

Проверете версията.

sudo nginx -v
# nginx version: nginx/1.15.0

Активирайте и стартирайте Nginx.

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

NodeBB по подразбиране работи на порт 4567. За да избегнем необходимостта от въвеждане http://example.com:4567, ще конфигурираме Nginx като обратен прокси за приложението NodeBB. Всяка заявка за порт 80или 443(ако се използва SSL) ще бъде препратена към порт 4567.

Стартирайте sudo vim /etc/nginx/conf.d/nodebb.confи го попълнете с основната конфигурация за обратен прокси по-долу.

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

}

Забележка: Актуализирайте server_nameдирективата с вашия домейн/име на хост.

Проверете конфигурацията.

sudo nginx -t

Презаредете Nginx.

sudo systemctl reload nginx.service

Инсталирайте клиента Acme.sh и получете сертификат Let's Encrypt (по избор)

Подсигуряването на вашия форум с HTTPS не е необходимо, но ще защити трафика на вашия сайт. Acme.sh е чист софтуер за unix обвивка за получаване на SSL сертификати от Let's Encrypt с нулеви зависимости.

Изтеглете и инсталирайте 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

Проверете версията.

acme.sh --version
# v2.7.9

Получете RSA и ECDSA сертификати за 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

След като изпълните горните команди, вашите сертификати и ключове ще бъдат в следните директории:

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

След като получим сертификати от Let's Encrypt, трябва да конфигурираме Nginx да ги използва.

Стартирайте sudo vim /etc/nginx/conf.d/nodebb.confотново и конфигурирайте Nginx като HTTPS обратен прокси.

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

}

Проверете конфигурацията.

sudo nginx -t

Презаредете Nginx.

sudo systemctl reload nginx.service

Инсталирайте NodeBB

Създайте основна директория на документа.

sudo mkdir -p /var/www/nodebb

Променете собствеността върху /var/www/nodebbдиректорията на johndoe.

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

Придвижете се до главната папка на документа.

cd /var/www/nodebb

Клонирайте най-новата версия на NodeBB в главната папка на документа.

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

Изпълнете командата за настройка на NodeBB и отговорете на всеки въпрос, когато бъдете подканени.

./nodebb setup

След като настройката на NodeBB приключи, стартирайте, ./nodebb startза да стартирате ръчно вашия NodeBB сървър.

./nodebb start

След тази команда ще имате достъп до вашия форум във вашия уеб браузър.

Стартирайте NodeBB като системна услуга

Когато се стартира чрез ./nodebb start, NodeBB няма да се стартира автоматично отново, когато системата се рестартира. За да избегнем това, ще трябва да настроим NodeBB като системна услуга.

Ако работите, спрете NodeBB.

./nodebb stop

Създайте нов непривилегирован nodebbпотребител.

sudo adduser nodebb

Променете собствеността на /var/www/nodebbдиректорията на nodebbпотребител.

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

Създайте nodebb.serviceконфигурационния файл на systemd unit. Този файл ще обработва стартирането на NodeBB deamon. Стартирайте sudo vim /etc/systemd/system/nodebb.serviceи попълнете файла със следното съдържание:

[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

ЗАБЕЛЕЖКА: Задайте потребителско име и пътеки към директорията според избраните от вас имена.

Активирайте nodebb.serviceпри рестартиране и незабавно стартирайте nodebb.service.

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

Проверете nodebb.serviceсъстоянието.

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

Това е. Вашият екземпляр на NodeBB вече е готов и работи.