نحوه نصب Wiki.js در FreeBSD 11

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

Wiki.js یک برنامه ویکی مدرن رایگان و منبع باز است که در Node.js ، MongoDB ، Git و Markdown ساخته شده است. کد منبع Wiki.js در Github به صورت عمومی میزبانی می شود . این راهنما نحوه نصب Wiki.js را بر روی نمونه های تازه FreeBSD 11 Vultr با استفاده از Node.js ، MongoDB ، PM2 ، Nginx ، Git و Acme.sh نشان می دهد.

الزامات

شرایط لازم برای اجرای Wiki.js به شرح زیر است:

• Node.js نسخه 6.11.1 یا بالاتر
• نسخه MongoDB 3.2 یا بالاتر
• نسخه Git 2.7.4 یا بالاتر
• سرور وب مانند Nginx ، Apache ، IIS ، Caddy یا H2O. این راهنما از Nginx استفاده می کند.
• مخزن سازگار با Git (عمومی یا خصوصی) این اختیاری است
• حداقل رم 512MB. استفاده از دستگاهی با حداقل 1 گیگابایت رم بسیار توصیه می شود.
• نام دامنه با A/ AAAAسوابق تنظیم شده است. در این راهنما از ما به wiki.example.comعنوان یک دامنه مثال استفاده خواهیم کرد.

قبل از اینکه شروع کنی

نسخه FreeBSD را بررسی کنید.

uname -ro
# FreeBSD 11.2-RELEASE

اطمینان حاصل کنید که سیستم FreeBSD شما به روز شده است.

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

نصب sudo، vim، unzip، wget، git، bashو socatبسته اگر آنها بر روی سیستم شما نیست.

pkg install -y sudo vim unzip wget git bash socat

با نام کاربری دلخواه خود یک حساب کاربری جدید ایجاد کنید (ما از آن استفاده خواهیم کرد 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گروه بتوانند هر دستور را اجرا کنند.

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

اکنون ، به کاربر تازه ایجاد شده خود بروید.

su - johndoe

توجه: با نام کاربری خود جایگزین johndoeکنید.

منطقه زمانی را تنظیم کنید.

sudo tzsetup

Node.js را نصب کنید

Wiki.js به Node.js 6.11.1 یا بالاتر نیاز دارد ، بنابراین ابتدا نیاز به نصب نسخه مناسب Node.js.

Node.js و NPM را نصب کنید.

sudo pkg install -y node8 npm-node8

نسخه ها را بررسی کنید.

node -v && npm -v
# v8.12.0
# 6.4.1

MongoDB را نصب کنید

Wiki.js از MongoDB به عنوان موتور پایگاه داده استفاده می کند.

MongoDB را نصب کنید.

sudo pkg install -y mongodb36

نسخه را بررسی کنید.

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.6
# db version v3.6.6

MongoDB را فعال کرده و شروع کنید.

sudo sysrc mongod_enable=yes
sudo service mongod start

Acme.sh را نصب کنید و یک گواهی Letry Encrypt ( اختیاری ) دریافت کنید

امنیت ویکی شما با HTTPS ضروری نیست ، اما این یک عمل خوب برای تأمین ترافیک سایت شماست. به منظور به دست آوردن گواهینامه SSL از Letry Encrypt از مشتری Acme.sh استفاده خواهیم کرد. Acme.sh یک نرم افزار پوسته یونیکس خالص برای بدست آوردن گواهینامه های SSL از Let Encrypt با وابستگی های صفر است. این باعث می شود وزن آن در مقایسه با برخی دیگر از پروتکل های Acme بسیار سبک وزن باشد که برای اجرای موفقیت آمیز به وابستگی های زیادی نیاز دارند.

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 ~

acme.shنسخه را بررسی کنید .

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

دریافت گواهینامه های RSA و ECDSA برای wiki.example.com.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength ec-256

بعد از اجرای دستورات فوق ، گواهینامه ها و کلیدهای شما در فهرستهای زیر قرار خواهند گرفت:

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

توجه: فراموش نکنید wiki.example.comکه نام دامنه خود را جایگزین کنید.

بعد از اخذ گواهینامه های Let Encrypt ، باید Nginx را پیکربندی کنیم تا از آنها استفاده کنیم.

Nginx را نصب و پیکربندی کنید

Wiki.js می تواند بدون هیچ سرور وب واقعی اجرا شود ، با این وجود توصیه می شود یک سرور وب استاندارد را در مقابل آن قرار دهید. این تضمین می کند که شما می توانید از ویژگیهایی مانند SSL ، وب سایت های مختلف ، ذخیره سازی و موارد دیگر استفاده کنید. ما در این آموزش از Nginx استفاده خواهیم کرد ، اما هر سرور دیگری انجام خواهد داد ، شما فقط باید آن را به درستی پیکربندی کنید.

Nginx را نصب کنید.

sudo pkg install -y nginx

نسخه را بررسی کنید.

nginx -v
# nginx version: nginx/1.14.0

Nginx را فعال کرده و شروع کنید.

sudo sysrc nginx_enable=yes
sudo service nginx start

Nginx را بعنوان HTTPS پیکربندی کنید (در صورت استفاده از SSL) پروکسی معکوس برای برنامه Wiki.js.

sudo vim /usr/local/etc/nginx/wiki.js.confآن را با پیکربندی اولیه پروکسی معکوس زیر اجرا کرده و آن را جمع کنید.

server {

  listen [::]:443 ssl http2;
  listen 443 ssl http2;
  listen [::]:80;
  listen 80;

  server_name wiki.example.com;

  charset utf-8;
  client_max_body_size 50M;

  # RSA
  ssl_certificate /etc/letsencrypt/wiki.example.com/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/wiki.example.com/wiki.example.com.key;
  # ECDSA
  ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/wiki.example.com.key;

  location / {
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_next_upstream error timeout http_502 http_503 http_504;
  }

}

تنها چیزی که شما باید در پیکربندی بالا تغییر دهید server_name، بخشنامه است و به طور بالقوه این proxy_passدستورالعمل اگر تصمیم بگیرید که برخی درگاه را غیر از تنظیم کنید 3000. Wiki.js 3000بصورت پیش فرض از پورت استفاده می کند . فایل را ذخیره کنید و خارج شوید با :+ W+Q

حال باید wiki.js.confپرونده را در nginx.confپرونده اصلی وارد کنیم .

sudo vim /usr/local/etc/nginx/nginx.confخط زیر را اجرا کرده و به http {}بلوک اضافه کنید.

include wiki.js.conf;

پیکربندی را بررسی کنید.

sudo nginx -t

بارگیری مجدد Nginx

sudo service nginx reload

Wiki.js را نصب کنید

یک پوشه ریشه سند خالی که در آن Wiki.js نصب خواهد شد ایجاد کنید.

sudo mkdir -p /usr/local/www/wiki.example.com

به پوشه ریشه سند بروید.

cd /usr/local/www/wiki.example.com

مالکیت /usr/local/www/wiki.example.comپوشه را به کاربر تغییر دهید johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/wiki.example.com

از /usr/local/www/wiki.example.comپوشه ، دستورات زیر را بارگیری و نصب Wiki.js.

curl -sSo- https://wiki.js.org/install.sh | bash

VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml

برای مشاهده نسخه نصب شده Wiki.js. می توانید دستور زیر را اجرا کنید.

node wiki --version
# 1.0.102

پس از اتمام نصب ، از شما خواسته می شود که جادوگر پیکربندی را اجرا کنید.

جادوگر پیکربندی را با اجرا شروع کنید.

node wiki configure

با این کار به شما اطلاع می دهید تا http://localhost:3000در پیکربندی Wiki.js. حرکت کنید. اگر جلوی Wiki.js Nginx دارید ، این بدان معنی است که می توانید http://wiki.example.comبه جای مراجعه به localhost ، نام دامنه خود را باز کنید (به عنوان مثال ).

با استفاده از مرورگر وب ، به http://wiki.example.comدستورالعمل های روی صفحه بروید و پیروی کنید. تمام تنظیمات وارد شده در هنگام جادوگر پیکربندی در config.ymlپرونده ذخیره می شود. جادوگر پیکربندی به طور خودکار Wiki.js را برای شما شروع می کند.

مدیر پروسه PM2 را نصب و راه اندازی کنید

به طور پیش فرض ، Wiki.js پس از راه اندازی مجدد سیستم به طور خودکار شروع نمی شود. برای شروع کار در بوت ، باید مدیر پروسه PM2 را نصب و راه‌اندازی کنیم.

PM2 را از طریق جهان نصب کنید npm.

sudo npm install -g pm2

نسخه را بررسی کنید.

pm2 -v
# 3.2.2

اگر قبلاً در آنجا نبودید به پوشه root خود بروید و Wiki.js. را متوقف کنید.

cd /usr/local/www/wiki.example.com
node wiki stop

Wiki.js را از طریق PM2 شروع کنید.

pm2 start server/index.js --name "Wiki.js"

فرآیند لیست توسط PM2 مدیریت می شود.

pm2 list

به PM2 بگویید که با اجرای ، خود را به عنوان یک سرویس راه اندازی پیکربندی کند:

pm2 startup

در آخر ، پیکربندی PM2 فعلی را با اجرای دستور ذخیره کنید:

pm2 save

نمونه Wiki.js شما اکنون به عنوان یک فرایند پیش زمینه اجرا می شود و از PM2 به عنوان مدیر فرآیند استفاده می کند.