كيفية تثبيت Wiki.js على FreeBSD 11

• المتطلبات
• قبل ان تبدأ
• قم بتثبيت Node.js
• قم بتثبيت MongoDB
• قم بتثبيت Acme.sh واحصل على شهادة Let's Encrypt (اختياري)
• قم بتثبيت وتكوين Nginx
• قم بتثبيت Wiki.js
• تثبيت وإعداد مدير عملية PM2

Wiki.js هو تطبيق wiki مجاني ومفتوح المصدر ومبني على 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 (عام أو خاص) هذا اختياري
• 512 ميجابايت على الأقل. يوصى بشدة باستخدام جهاز يحتوي على 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 واحصل على شهادة Let's Encrypt ( اختياري )

ليس من الضروري تأمين موقع wiki الخاص بك باستخدام HTTPS ، ولكنه يعد ممارسة جيدة لتأمين حركة المرور على موقعك. للحصول على شهادة SSL من Let's Encrypt ، سنستخدم عميل Acme.sh. Acme.sh هو برنامج shell unix خالص للحصول على شهادات SSL من Let's 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's 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. إذا كان لديك Nginx أمام Wiki.js ، فهذا يعني أنه يمكنك فتح اسم المجال الخاص بك (على سبيل المثال http://wiki.example.com) بدلاً من الذهاب إلى المضيف المحلي.

باستخدام متصفح الويب الخاص بك ، انتقل إلى http://wiki.example.comواتبع التعليمات التي تظهر على الشاشة. يتم حفظ جميع الإعدادات التي تم إدخالها أثناء معالج التكوين في config.ymlالملف. سيبدأ معالج التكوين تلقائيًا بتشغيل Wiki.js.

تثبيت وإعداد مدير عملية PM2

افتراضيًا ، لن يبدأ تشغيل Wiki.js تلقائيًا بعد إعادة تشغيل النظام. لجعله يبدأ في التمهيد ، نحتاج إلى تثبيت وإعداد مدير عمليات PM2.

قم بتثبيت PM2 عالميًا عبر npm.

sudo npm install -g pm2

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

pm2 -v
# 3.2.2

انتقل إلى مجلد جذر المستند إذا لم تكن موجودًا بالفعل وأوقف 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 كمدير العمليات الخاص به.