Jak zainstalować forum NodeBB na FreeBSD 12

• Wymagania
• Zanim zaczniesz
• Zainstaluj Node.js
• Zainstaluj i skonfiguruj MongoDB
• Zainstaluj i skonfiguruj Nginx
• Zainstaluj klienta Acme.sh i uzyskaj certyfikat Let's Encrypt (opcjonalnie)
• Zainstaluj NodeBB
• Uruchom NodeBB z PM2

NodeBB to oprogramowanie forum oparte na Node.js. Wykorzystuje gniazda sieciowe do natychmiastowych interakcji i powiadomień w czasie rzeczywistym. Kod źródłowy NodeBB jest publicznie hostowany na Github . Ten przewodnik przeprowadzi Cię przez proces instalacji NodeBB w nowej instancji FreeBSD 12 Vultr, przy użyciu Node.js, MongoDB jako bazy danych, Nginx jako odwrotnego proxy i Acme.sh dla certyfikatów SSL.

Wymagania

NodeBB wymaga zainstalowania następującego oprogramowania:

• Node.js w wersji 6.9.0 lub nowszej
• MongoDB wersja 2.6 lub nowsza
• Nginx
• Git
• Co najmniej 1024 MB pamięci RAM
• Nazwa domeny z ustawieniem A/ AAAArecords

Zanim zaczniesz

Sprawdź wersję FreeBSD.

uname -ro
# FreeBSD 12.0-RELEASE

Upewnij się, że twój system FreeBSD jest aktualny.

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

Zainstaluj niezbędne pakiety, jeśli nie są obecne w twoim systemie.

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

Utwórz nowe konto użytkownika z preferowaną nazwą użytkownika (użyjemy 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!

Uruchom visudopolecenie i usuń komentarz z %wheel ALL=(ALL) ALLwiersza, aby umożliwić członkom wheelgrupy wykonanie dowolnego polecenia.

visudo

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

Teraz przejdź do nowo utworzonego użytkownika za pomocą su.

su - johndoe

UWAGA: Zamień na johndoeswoją nazwę użytkownika.

Ustaw strefę czasową.

sudo tzsetup

Zainstaluj Node.js

NodeBB jest sterowany przez Node.js, więc musi zostać zainstalowany. Zalecana jest instalacja bieżącej wersji LTS środowiska Node.js.

Zainstaluj Node.js i npm.

sudo pkg install -y node10 npm-node10

Sprawdź wersje.

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

Zainstaluj i skonfiguruj MongoDB

MongoDB jest domyślną bazą danych dla NodeBB.

Zainstaluj MongoDB.

sudo pkg install -y mongodb40

Sprawdź wersję.

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

Włącz i uruchom MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Utwórz bazę danych i użytkownika dla NodeBB.

Najpierw połącz się z MongoDB.

mongo

Przejdź do wbudowanej adminbazy danych.

> use admin

Utwórz użytkownika administracyjnego.

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

UWAGA: Zastąp symbol zastępczy <Enter a secure password>własnym wybranym hasłem.

Dodaj nową bazę danych o nazwie nodebb.

> use nodebb

Baza danych zostanie utworzona i kontekst zostanie przełączony na nodebb. Następnie utwórz nodebbużytkownika z odpowiednimi uprawnieniami.

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

UWAGA: Ponownie zastąp symbol zastępczy <Enter a secure password>własnym wybranym hasłem.

Wyjdź ze skorupy Mongo.

> quit()

Uruchom ponownie MongoDB i upewnij się, że utworzony wcześniej użytkownik administracyjny może się połączyć.

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

Zainstaluj i skonfiguruj Nginx

Zainstaluj Nginx.

sudo pkg install -y nginx

Sprawdź wersję.

nginx -v
# nginx version: nginx/1.14.2

Włącz i uruchom Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

NodeBB domyślnie działa na porcie 4567. Aby uniknąć pisania http://example.com:4567, skonfigurujemy Nginx jako zwrotny serwer proxy dla aplikacji NodeBB. Każde żądanie na porcie 80lub 443, jeśli używany jest protokół SSL, będzie przekazywane do portu 4567.

Uruchom sudo vim /usr/local/etc/nginx/nodebb.confi zapełnij podstawową konfiguracją odwrotnego proxy poniżej.

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

}

W powyższej konfiguracji zaktualizuj server_namedyrektywę swoją domeną / nazwą hosta.

Zapisz plik i wyjdź za pomocą :+ W+ Q.

Teraz musimy dołączyć nodebb.confdo głównego nginx.confpliku.

Uruchom sudo vim /usr/local/etc/nginx/nginx.confi dodaj następujący wiersz do http {}bloku.

include nodebb.conf;

Sprawdź konfigurację.

sudo nginx -t

Załaduj ponownie Nginx.

sudo service nginx reload

Zainstaluj klienta Acme.sh i uzyskaj certyfikat Let's Encrypt (opcjonalnie)

Zabezpieczenie forum za pomocą HTTPS nie jest konieczne, ale zabezpieczy ruch w Twojej witrynie. Acme.sh to czysto uniksowe oprogramowanie powłoki do uzyskiwania certyfikatów SSL z Let's Encrypt z zerowymi zależnościami.

Pobierz i zainstaluj 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 ~

Sprawdź wersję.

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

Uzyskaj certyfikaty RSA i ECDSA dla 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

Po uruchomieniu powyższych poleceń twoje certyfikaty i klucze będą w:

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

Po uzyskaniu certyfikatów od Let's Encrypt musimy skonfigurować Nginx, aby z nich korzystać.

Uruchom sudo vim /usr/local/etc/nginx/nodebb.confponownie i skonfiguruj Nginx jako odwrotne proxy 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";
  }

}

Sprawdź konfigurację.

sudo nginx -t

Załaduj ponownie Nginx.

sudo service nginx reload

Zainstaluj NodeBB

Utwórz katalog główny dokumentu.

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

Zmień własność /usr/local/www/nodebbkatalogu na johndoe.

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

Przejdź do folderu głównego dokumentu.

cd /usr/local/www/nodebb

Sklonuj najnowszy NodeBB do folderu głównego dokumentu.

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

Uruchom komendę konfiguracji NodeBB i odpowiedz na każde pytanie, gdy pojawi się monit.

./nodebb setup

Po zakończeniu instalacji NodeBB uruchom, ./nodebb startaby ręcznie uruchomić serwer NodeBB.

./nodebb start

Po tym poleceniu będziesz mieć dostęp do instancji forum NodeBB w przeglądarce internetowej.

Uruchom NodeBB z PM2

Po uruchomieniu przez ./nodebb startNodeBB nie uruchomi się ponownie automatycznie po ponownym uruchomieniu systemu. Aby tego uniknąć, będziemy musieli skonfigurować NodeBB jako usługę systemową.

Jeśli działa, zatrzymaj NodeBB.

./nodebb stop

Zainstaluj PM2 globalnie.

sudo npm install pm2 -g

Sprawdź wersję.

pm2 -v
# 3.5.0

Przejdź do katalogu głównego dokumentu NodeBB.

cd /usr/local/www/nodebb

Uruchom NodeBB przez PM2.

pm2 start app.js

Wymień proces NodeBB.

pm2 ls

Wykryj dostępny system inicjujący.

pm2 startup

Skopiuj i wklej wyjście tego polecenia w interfejsie CLI, aby skonfigurować hak startowy.

Zapisz listę procesów.

pm2 save

Otóż ​​to. Twoja instancja NodeBB jest teraz uruchomiona.