كيفية تثبيت Wiki.js على Fedora 28

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

Wiki.js هو تطبيق wiki مجاني ومفتوح المصدر ومبني على Node.js و MongoDB و Git و Markdown. تتم استضافة شفرة مصدر Wiki.js علنًا على Github . سيوضح لك هذا الدليل كيفية تثبيت Wiki.js على مثيل Fedora 28 Vultr جديد باستخدام Node.js و MongoDB و PM2 و Nginx و Git و Acme.sh.

المتطلبات

متطلبات تشغيل Wiki.js هي التالية:

• Node.js الإصدار 6.9.0 أو أحدث
• إصدار MongoDB 3.2 أو أحدث
• خادم ويب مثل Nginx أو Apache أو IIS أو Caddy أو H2O. سيستخدم هذا الدليل Nginx
• إصدار Git 2.7.4 أو أحدث
• مستودع متوافق مع Git (عام أو خاص) هذا اختياري
• 768 ميجا بايت على الأقل من ذاكرة الوصول العشوائي
• اسم المجال مع A/ AAAAإعداد السجلات

قبل ان تبدأ

تحقق من إصدار نظام التشغيل.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

قم بإنشاء حساب مستخدم جديد غير جذري مع وصول sudo وقم بالتبديل إليه.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

ملاحظة: استبدل johndoeباسم المستخدم الخاص بك.

تأكد من أن نظامك محدث.

sudo dnf check-upgrade || sudo dnf upgrade -y

قم بإعداد المنطقة الزمنية.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

قم بتثبيت الحزم المطلوبة والمفيدة.

sudo dnf install -y wget vim unzip bash-completion git

من أجل البساطة ، قم بتعطيل SELinux وجدار الحماية.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

قم بتثبيت Node.js

يتطلب Wiki.js Node.js 6.9.0 أو أحدث ، لذا سنحتاج أولاً إلى تثبيت Node.js.

تثبيت Node.js.

sudo dnf install -y nodejs

تحقق من إصدارات Node.js و npm.

node -v && npm -v
# v8.11.3
# 5.6.0

قم بتثبيت MongoDB

يستخدم Wiki.js MongoDB كمحرك قاعدة بيانات. وفقًا لذلك ، سنحتاج إلى تثبيت MongoDB على خادمنا.

قم بتثبيت MongoDB.

sudo dnf install -y mongodb mongodb-server

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

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

قم بتمكين وبدء MongoDB.

sudo systemctl enable mongod.service
sudo systemctl start mongod.service

قم بتثبيت وتكوين Nginx

يمكن تشغيل Wiki.js بدون أي خادم ويب فعلي (مثل Nginx أو Apache). ومع ذلك ، يوصى بشدة بوضع خادم ويب قياسي أمام Wiki.js. هذا يضمن لك استخدام ميزات مثل SSL ، والعديد من مواقع الويب ، والتخزين المؤقت ، وغيرها. سنستخدم Nginx في هذا البرنامج التعليمي ، ولكن أي خادم آخر سيفعل ذلك ، ما عليك سوى تكوينه بشكل صحيح.

قم بتثبيت Nginx.

sudo dnf install -y nginx

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

nginx -v
# nginx version: nginx/1.12.1

قم بتمكين Nginx وبدء تشغيله.

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

قم بتهيئة Nginx باعتباره وكيل عكسي ( HTTPأو HTTPSإذا كنت تستخدم SSL) لتطبيق Wiki.js.

قم بتشغيله sudo vim /etc/nginx/conf.d/wiki.js.confوملؤه باستخدام التكوين الأساسي للخادم الوكيل العكسي أدناه.

server {

    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    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بشكل افتراضي.

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

sudo nginx -t

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

sudo systemctl reload nginx.service

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

HTTPSليس من الضروري تأمين موقع wiki الخاص بك ، ولكن من الممارسات الجيدة تأمين حركة مرور موقعك. للحصول على شهادة 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.7.9

الحصول على شهادات RSA و ECDSA لـ wiki.example.com.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --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 للاستفادة منها.

تشغيل sudo vim /etc/nginx/conf.d/wiki.js.confمرة أخرى وتكوين Nginx HTTPSكوكيل عكسي.

server {

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

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    # 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;
    }

}

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

sudo nginx -t

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

sudo systemctl reload nginx.service

قم بتثبيت Wiki.js

قم بإنشاء مجلد جذر مستند فارغ ، حيث يجب تثبيت Wiki.js.

sudo mkdir -p /var/www/wiki.example.com

انتقل إلى مجلد جذر المستند.

cd /var/www/wiki.example.com

تغيير ملكية /var/www/wiki.example.comالمجلد إلى المستخدم johndoe.

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

من /var/www/wiki.example.comالمجلد ، قم بتشغيل الأمر التالي لتنزيل Wiki.js. وتثبيته

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

يمكنك تشغيل الأمر التالي لعرض الإصدار المثبت حاليًا من Wiki.js.

node wiki --version
# 1.0.78

بمجرد اكتمال التثبيت ، ستتم مطالبتك بتشغيل معالج التكوين.

ابدأ تشغيل معالج التكوين عن طريق التشغيل.

node wiki configure

هذا وسوف يخطر لك للانتقال إلى http://localhost:3000تكوين Wiki.js. إذا كان لديك Nginx أمام Wiki.js ، فهذا يعني أنه يمكنك فتح اسم المجال الخاص بك (على سبيل المثال http://wiki.example.com) بدلاً من الذهاب إلى localhost.

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

إعداد PM2

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

اطلب من PM2 تكوين نفسه كخدمة بدء تشغيل عن طريق تشغيل:

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup

أخيرًا ، احفظ تكوين PM2 الحالي عن طريق تشغيل الأمر: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

يعمل مثيل Wiki.js الخاص بك كعملية خلفية ، باستخدام PM2 كمدير العمليات الخاص به.