كيفية تثبيت منتدى 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
• شخص سخيف
• ذاكرة وصول عشوائي بسعة 1024 ميجابايت على الأقل
• اسم المجال مع 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>بكلمة المرور المحددة.

اخرج من قشرة المونغو.

> 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.

قم بتشغيله sudo vim /usr/local/etc/nginx/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التوجيه باسم المجال / اسم المضيف الخاص بك.

احفظ الملف واخرج مع :+ W+ Q.

الآن نحن بحاجة إلى تضمينها nodebb.confفي nginx.confالملف الرئيسي .

قم بتشغيل sudo vim /usr/local/etc/nginx/nginx.confوإضافة السطر التالي إلى http {}الكتلة.

include nodebb.conf;

تحقق من التكوين.

sudo nginx -t

إعادة تحميل Nginx.

sudo service nginx reload

قم بتثبيت عميل Acme.sh واحصل على شهادة Let's Encrypt (اختياري)

ليس من الضروري تأمين منتداك باستخدام HTTPS ، ولكنه سيؤمن حركة المرور على موقعك. Acme.sh هو برنامج shell 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 [email protected]
cd ~

التحقق من إصدار.

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

الحصول على شهادات 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 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 قيد التشغيل الآن.