Как да инсталирате NodeBB форум на FreeBSD 12

Изисквания

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

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

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

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

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

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

Стартирайте NodeBB с PM2

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

Изисквания

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

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

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

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

uname -ro
# FreeBSD 12.0-RELEASE

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

freebsd-update fetch install
pkg update && pkg upgrade -y

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

pkg install -y sudo vim unzip wget git bash socat gcc8 pkgconf vips

Създайте нов потребителски акаунт с предпочитаното от вас потребителско име (ние ще използваме johndoe).

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Изпълнете visudoкомандата и разкоментирайте %wheel ALL=(ALL) ALLреда, за да позволите на членовете на wheelгрупата да изпълнят всяка команда.

visudo

# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL

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

su - johndoe

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

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

sudo tzsetup

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

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

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

sudo pkg install -y node10 npm-node10

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

node -v && npm -v
# v10.15.3
# 6.9.0

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

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

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

sudo pkg install -y mongodb40

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

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

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

sudo sysrc mongod_enable=yes
sudo service mongod start

Създайте база данни и потребител за 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 service mongod restart
mongo -u admin -p your_password --authenticationDatabase=admin

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

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

sudo pkg install -y nginx

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

nginx -v
# nginx version: nginx/1.14.2

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

sudo sysrc nginx_enable=yes
sudo service nginx start

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

Run sudo vim /usr/local/etc/nginx/nodebb.conf and populate it with the basic reverse proxy configuration below.

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 above config, update the server_name directive with your domain/hostname.

Save the file and exit with :+W+Q.

Now we need to include nodebb.conf in the main nginx.conf file.

Run sudo vim /usr/local/etc/nginx/nginx.conf and add the following line to the http {} block.

include nodebb.conf;

Check the configuration.

sudo nginx -t

Reload Nginx.

sudo service nginx reload

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 your_email@example.com
cd ~

Check the version.

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

Obtain RSA and ECDSA certificates for 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 service nginx reload" --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 service nginx reload"  --keylength ec-256

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

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

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

Стартирайте sudo vim /usr/local/etc/nginx/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 service nginx reload

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

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

sudo mkdir -p /usr/local/www/nodebb

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

sudo chown -R johndoe:johndoe /usr/local/www/nodebb

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

cd /usr/local/www/nodebb

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

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

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

./nodebb setup

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

./nodebb start

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

Стартирайте NodeBB с PM2

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

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

./nodebb stop

Инсталирайте PM2 глобално.

sudo npm install pm2 -g

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

pm2 -v
# 3.5.0

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

cd /usr/local/www/nodebb

Стартирайте NodeBB чрез PM2.

pm2 start app.js

Избройте процеса на NodeBB.

pm2 ls

Открийте наличната система за инициализиране.

pm2 startup

Копирайте и поставете изхода на тази команда в CLI, за да настроите вашата кука за стартиране.

Запазете списъка си с процеси.

pm2 save

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