نحوه نصب انجمن NodeBB در FreeBSD 12

• الزامات
• قبل از اینکه شروع کنی
• Node.js را نصب کنید
• MongoDB را نصب و پیکربندی کنید
• Nginx را نصب و پیکربندی کنید
• مشتری Acme.sh را نصب کنید و یک گواهی Letry Encrypt (اختیاری) دریافت کنید
• NodeBB را نصب کنید
• NodeBB را با PM2 اجرا کنید

NodeBB یک نرم افزار انجمن مبتنی بر Node.js است. از سوکت های وب برای تعامل فوری و اعلامیه های زمان واقعی استفاده می کند. کد منبع NodeBB در Github به صورت عمومی میزبانی می شود . این راهنما شما را با استفاده از Node.js ، MongoDB به عنوان بانک اطلاعات ، Nginx به عنوان یک پروکسی معکوس و Acme.sh برای گواهینامه های SSL ، مراحل نصب NodeBB را به صورت مثال FreeBSD 12 Vultr طی می کند.

الزامات

NodeBB نیاز به نصب نرم افزار زیر دارد:

• Node.js نسخه 6.9.0 یا بیشتر
• نسخه 2.6 یا بالاتر MongoDB
• نگینکس
• گیت
• حداقل رم 1024MB
• نام دامنه با 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.

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 را نصب کنید و یک گواهی Letry Encrypt (اختیاری) دریافت کنید

تأمین امنیت انجمن با HTTPS ضروری نیست ، اما باعث ترافیک سایت شما خواهد شد. Acme.sh یک نرم افزار پوسته یونیکس خالص برای بدست آوردن گواهینامه های SSL از Let 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 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 را نصب کنید

دایرکتوری root را ایجاد کنید.

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

UPut این دستور را در CLI کپی و جایگذاری کنید تا قلاب راه اندازی خود را تنظیم کنید.

لیست فرآیند خود را ذخیره کنید.

pm2 save

خودشه. نمونه NodeBB شما اکنون اجرا شده است.