Cara Memasang forum NodeBB di FreeBSD 12

• Keperluan
• Sebelum awak bermula
• Pasang Node.js
• Pasang dan konfigurasikan MongoDB
• Pasang dan konfigurasikan Nginx
• Pasang klien Acme.sh dan dapatkan Sijil Encik Sijil (pilihan)
• Pasang NodeBB
• Jalankan NodeBB dengan PM2

NodeBB adalah perisian forum berasaskan Node.js. Ia menggunakan soket web untuk interaksi segera dan pemberitahuan masa nyata. Kod sumber NodeBB dihoskan secara umum di Github . Panduan ini akan membimbing anda melalui proses pemasangan NodeBB pada contoh FreeBSD 12 Vultr segar, dengan menggunakan Node.js, MongoDB sebagai pangkalan data, Nginx sebagai proksi terbalik, dan Acme.sh untuk sijil SSL.

Keperluan

NodeBB memerlukan perisian berikut dipasang:

• Versi Node.js 6.9.0 atau lebih tinggi
• MongoDB versi 2.6 atau lebih besar
• Nginx
• Git
• Minimum 1024MB RAM
• Nama domain dengan A/ AAAArekod disediakan

Sebelum awak bermula

Semak versi FreeBSD.

uname -ro
# FreeBSD 12.0-RELEASE

Pastikan sistem FreeBSD anda terkini.

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

Pasang pakej yang diperlukan sekiranya tidak terdapat di sistem anda.

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

Buat akaun pengguna baru dengan nama pengguna pilihan anda (kami akan gunakan 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!

Jalankan visudoarahan dan unmentasikan %wheel ALL=(ALL) ALLbaris, untuk membolehkan ahli wheelkumpulan melaksanakan sebarang arahan.

visudo

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

Kini, beralih kepada pengguna yang baru anda buat dengan su.

su - johndoe

CATATAN: Ganti johndoedengan nama pengguna anda.

Sediakan zon waktu.

sudo tzsetup

Pasang Node.js

NodeBB didorong oleh Node.js, dan oleh itu ia perlu dipasang. Disarankan pemasangan Node.js versi LTS semasa.

Pasang Node.js dan npm.

sudo pkg install -y node10 npm-node10

Semak versi.

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

Pasang dan konfigurasi MongoDB

MongoDB adalah pangkalan data lalai untuk NodeBB.

Pasang MongoDB.

sudo pkg install -y mongodb40

Semak versi.

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

Dayakan dan mulakan MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Buat pangkalan data dan pengguna untuk NodeBB.

Sambungkan ke MongoDB terlebih dahulu.

mongo

Beralih ke adminpangkalan data terbina dalam .

> use admin

Buat pengguna pentadbiran.

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

CATATAN: Ganti tempat letak <Enter a secure password>dengan kata laluan pilihan anda sendiri.

Tambah pangkalan data baru yang dipanggil nodebb.

> use nodebb

Pangkalan data akan dicipta dan konteks dihidupkan nodebb. Seterusnya buat nodebbpengguna dengan keistimewaan yang sesuai.

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

CATATAN: Sekali lagi, ganti ruang letak <Enter a secure password>dengan kata laluan yang anda pilih sendiri.

Keluar dari shell Mongo.

> quit()

Restart MongoDB dan pastikan pengguna pentadbiran yang dibuat lebih awal dapat menyambung.

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

Pasang dan konfigurasikan Nginx

Pasang Nginx.

sudo pkg install -y nginx

Semak versi.

nginx -v
# nginx version: nginx/1.14.2

Dayakan dan mulailah Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

NodeBB secara lalai berjalan di port 4567. Untuk mengelakkan menaip http://example.com:4567, kami akan mengkonfigurasi Nginx sebagai proksi terbalik untuk aplikasi NodeBB. Setiap permintaan pada port 80atau 443, jika SSL digunakan, akan dikemukakan kepada pelabuhan 4567.

Jalankan sudo vim /usr/local/etc/nginx/nodebb.confdan isi dengan konfigurasi proksi terbalik asas di bawah.

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

}

Dalam konfigurasi di atas, kemas kini server_namearahan dengan nama domain / host anda.

Simpan fail dan keluar dengan :+ W+ Q.

Sekarang kita perlu memasukkan nodebb.confdalam nginx.conffail utama .

Jalankan sudo vim /usr/local/etc/nginx/nginx.confdan tambah baris berikut ke http {}blok.

include nodebb.conf;

Periksa konfigurasi.

sudo nginx -t

Muat semula Nginx.

sudo service nginx reload

Pasang klien Acme.sh dan dapatkan Sijil Encik Sijil (pilihan)

Tidak menjamin keselamatan forum anda dengan HTTPS, tetapi ia akan menjamin lalu lintas laman web anda. Acme.sh adalah perisian shell unix murni untuk mendapatkan sijil SSL dari Let's Encrypt dengan kebergantungan sifar.

Muat turun dan pasang 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 ~

Semak versi.

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

Dapatkan sijil RSA dan ECDSA untuk 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

Setelah menjalankan perintah di atas, sijil dan kunci anda akan berada di:

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

Selepas mendapatkan sijil dari Let's Encrypt, kita perlu mengkonfigurasi Nginx untuk menggunakannya.

Jalankan sudo vim /usr/local/etc/nginx/nodebb.conflagi dan konfigurasikan Nginx sebagai proksi terbalik 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";
  }

}

Periksa konfigurasi.

sudo nginx -t

Muat semula Nginx.

sudo service nginx reload

Pasang NodeBB

Buat direktori root dokumen.

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

Tukar pemilikan /usr/local/www/nodebbdirektori ke johndoe.

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

Navigasi ke folder root dokumen.

cd /usr/local/www/nodebb

Klon NodeBB terkini ke folder root dokumen.

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

Jalankan arahan persediaan NodeBB dan jawab setiap soalan apabila diminta.

./nodebb setup

Setelah persediaan NodeBB selesai, jalankan ./nodebb startuntuk memulakan pelayan NodeBB anda secara manual.

./nodebb start

Selepas arahan ini, anda dapat mengakses contoh forum NodeBB anda dalam penyemak imbas web.

Jalankan NodeBB dengan PM2

Apabila dimulakan melalui ./nodebb start, NodeBB tidak akan dimulakan semula secara automatik semasa sistem dihidupkan semula. Untuk mengelakkannya, kita perlu menyediakan NodeBB sebagai perkhidmatan sistem.

Sekiranya berjalan, hentikan NodeBB.

./nodebb stop

Pasang PM2 secara global.

sudo npm install pm2 -g

Semak versi.

pm2 -v
# 3.5.0

Navigasi ke akar dokumen NodeBB.

cd /usr/local/www/nodebb

Mulakan NodeBB melalui PM2.

pm2 start app.js

Senaraikan proses NodeBB.

pm2 ls

Kesan sistem init yang ada.

pm2 startup

Salin dan tampal isi perintah ini di CLI untuk menyiapkan cangkuk permulaan anda.

Simpan senarai proses anda.

pm2 save

Itu sahaja. Instance NodeBB anda kini dan berjalan.