Cara Memasang forum NodeBB di FreeBSD 12

• Persyaratan
• Sebelum kamu memulai
• Instal Node.js
• Instal dan konfigurasikan MongoDB
• Instal dan konfigurasikan Nginx
• Instal klien Acme.sh dan dapatkan sertifikat Let's Encrypt (opsional)
• Instal NodeBB
• Jalankan NodeBB dengan PM2

NodeBB adalah perangkat lunak forum berbasis Node.js. Ini menggunakan soket web untuk interaksi instan dan pemberitahuan waktu nyata. Kode sumber NodeBB di-host secara publik di Github . Panduan ini akan memandu Anda melalui proses instalasi NodeBB pada instance FreeBSD 12 Vultr yang baru, dengan menggunakan Node.js, MongoDB sebagai basis data, Nginx sebagai proxy terbalik, dan Acme.sh untuk sertifikat SSL.

Persyaratan

NodeBB membutuhkan perangkat lunak berikut untuk diinstal:

• Node.js versi 6.9.0 atau lebih tinggi
• MongoDB versi 2.6 atau lebih tinggi
• Nginx
• Git
• Minimal RAM 1024MB
• Nama domain dengan A/ AAAAcatatan diatur

Sebelum kamu memulai

Periksa versi FreeBSD.

uname -ro
# FreeBSD 12.0-RELEASE

Pastikan sistem FreeBSD Anda mutakhir.

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

Instal paket yang diperlukan jika tidak ada di sistem Anda.

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

Buat akun 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 visudoperintah dan batalkan komentar pada %wheel ALL=(ALL) ALLbaris, untuk memungkinkan anggota wheelgrup untuk mengeksekusi perintah apa pun.

visudo

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

Sekarang, beralihlah ke pengguna yang baru dibuat dengan su.

su - johndoe

CATATAN: Ganti johndoedengan nama pengguna Anda.

Siapkan zona waktu.

sudo tzsetup

Instal Node.js

NodeBB digerakkan oleh Node.js, dan karena itu perlu diinstal. Instalasi versi LTS saat ini dari Node.js disarankan.

Instal Node.js dan npm.

sudo pkg install -y node10 npm-node10

Periksa versinya.

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

Instal dan konfigurasikan MongoDB

MongoDB adalah database default untuk NodeBB.

Instal MongoDB.

sudo pkg install -y mongodb40

Periksa versinya.

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

Aktifkan dan mulai MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Buat database dan pengguna untuk NodeBB.

Sambungkan ke MongoDB terlebih dahulu.

mongo

Beralih ke adminbasis data bawaan.

> use admin

Buat pengguna administratif.

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

CATATAN: Ganti placeholder <Enter a secure password>dengan kata sandi pilihan Anda sendiri.

Tambahkan database baru yang disebut nodebb.

> use nodebb

Basis data akan dibuat dan konteksnya dialihkan ke nodebb. Selanjutnya buat nodebbpengguna dengan hak istimewa yang sesuai.

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

CATATAN: Sekali lagi, ganti placeholder <Enter a secure password>dengan kata sandi pilihan Anda sendiri.

Keluar dari cangkang Mongo.

> quit()

Mulai ulang MongoDB dan pastikan bahwa pengguna administratif yang dibuat sebelumnya dapat terhubung.

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

Instal dan konfigurasikan Nginx

Instal Nginx.

sudo pkg install -y nginx

Periksa versinya.

nginx -v
# nginx version: nginx/1.14.2

Aktifkan dan mulai Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

NodeBB secara default berjalan pada port 4567. Untuk menghindari mengetik http://example.com:4567, kami akan mengonfigurasi Nginx sebagai proksi terbalik untuk aplikasi NodeBB. Setiap permintaan pada port 80atau 443, jika SSL digunakan, akan diteruskan ke port 4567.

Jalankan sudo vim /usr/local/etc/nginx/nodebb.confdan isi dengan konfigurasi proxy terbalik dasar di bawah ini.

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, perbarui server_namearahan dengan domain / nama host Anda.

Simpan file dan keluar dengan :+ W+ Q.

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

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

include nodebb.conf;

Periksa konfigurasi.

sudo nginx -t

Muat ulang Nginx.

sudo service nginx reload

Instal klien Acme.sh dan dapatkan sertifikat Let's Encrypt (opsional)

Mengamankan forum Anda dengan HTTPS tidak perlu, tetapi itu akan mengamankan lalu lintas situs Anda. Acme.sh adalah perangkat lunak unix shell murni untuk mendapatkan sertifikat SSL dari Let's Encrypt dengan nol dependensi.

Unduh dan instal 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 ~

Periksa versinya.

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

Dapatkan sertifikat 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, sertifikat dan kunci Anda akan berada di:

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

Setelah mendapatkan sertifikat dari Let's Encrypt, kita perlu mengkonfigurasi Nginx untuk menggunakannya.

Jalankan sudo vim /usr/local/etc/nginx/nodebb.conflagi dan konfigurasikan Nginx sebagai proxy balik 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 ulang Nginx.

sudo service nginx reload

Instal NodeBB

Buat direktori root dokumen.

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

Ubah kepemilikan /usr/local/www/nodebbdirektori menjadi johndoe.

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

Arahkan ke folder root dokumen.

cd /usr/local/www/nodebb

Klon NodeBB terbaru ke dalam folder root dokumen.

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

Jalankan perintah pengaturan NodeBB dan jawab setiap pertanyaan saat diminta.

./nodebb setup

Setelah pengaturan NodeBB selesai, jalankan ./nodebb startuntuk memulai server NodeBB Anda secara manual.

./nodebb start

Setelah perintah ini, Anda akan dapat mengakses instance forum NodeBB Anda di browser web.

Jalankan NodeBB dengan PM2

Ketika mulai via ./nodebb start, NodeBB tidak akan secara otomatis memulai lagi ketika sistem reboot. Untuk menghindarinya, kita perlu mengatur NodeBB sebagai layanan sistem.

Jika berjalan, hentikan NodeBB.

./nodebb stop

Instal PM2 secara global.

sudo npm install pm2 -g

Periksa versinya.

pm2 -v
# 3.5.0

Arahkan ke root dokumen NodeBB.

cd /usr/local/www/nodebb

Mulai NodeBB melalui PM2.

pm2 start app.js

Daftar proses NodeBB.

pm2 ls

Mendeteksi sistem init yang tersedia.

pm2 startup

Salin dan tempel ouput dari perintah ini di CLI untuk mengatur kait startup Anda.

Simpan daftar proses Anda.

pm2 save

Itu dia. Contoh NodeBB Anda sekarang aktif dan berjalan.