كيفية تثبيت Wiki.js على Ubuntu 18.04

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

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

المتطلبات

متطلبات تشغيل Wiki.js وإنهاء هذا الدليل هي كما يلي:

• Node.js الإصدار 6.9.0 أو أحدث
• إصدار MongoDB 3.2 أو أحدث
• Nginx
• إصدار Git 2.7.4 أو أحدث
• ذاكرة وصول عشوائي بسعة 768 ميجابايت على الأقل
• اسم المجال مع A/ AAAAإعداد السجلات

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

lsb_release -ds
# Ubuntu 18.04.4 LTS

قم بإنشاء non-rootحساب مستخدم جديد له sudoحق الوصول والتبديل إليه.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

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

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

sudo dpkg-reconfigure tzdata

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

sudo apt update && sudo apt upgrade -y

قم بتثبيت الحزم الضرورية.

sudo apt install -y build-essential apt-transport-https

تثبيت Git

يأتي Git 2.7.4 مثبتًا مسبقًا على إصدار خادم Ubuntu ، لذلك لا نحتاج إلى تثبيته. إذا كنت ترغب في تثبيت إصدار أحدث ، يمكنك استخدام PPAs من طرف ثالث أو تجميع أحدث إصدار من Git من المصدر.

يمكنك التحقق من إصدار Git المثبت حاليًا عن طريق تشغيل:

git --version
# git version 2.7.4

إذا كنت ترغب في تثبيت إصدار أحدث من برنامج Git ، فيمكنك استخدام ما يلي.

# Remove existing git package
sudo apt remove -y git
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:git-core/ppa
sudo apt update && sudo apt upgrade -y
sudo apt install -y git

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

git --version
# git version 2.17.0

قم بتثبيت Node.js

قم بتثبيت Node.js عن طريق استخدام مستودع NodeSource APT لـ Node.js.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs

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

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

قم بتثبيت MongoDB

سنستخدم مستودعات MongoDB الرسمية ، والتي يتم تحديثها بأحدث إصدارات MongoDB الرئيسية والثانوية.

قم بتثبيت MongoDB Community Edition.

sudo apt install -y mongodb

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

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

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

قم بتثبيت Nginx.

wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

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

sudo nginx -v
# nginx version: nginx/1.15.0

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

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

تكوين Nginx كوكيل عكسي لتطبيق 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 الخاص بك ، ولكنه سيؤمن حركة المرور على موقعك. 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 your_email@example.com
cd ~

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

/etc/letsencrypt/acme.sh --version

احصل على شهادات 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 your_email@example.com --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 your_email@example.com --ocsp-must-staple --keylength ec-256 

بعد تشغيل الأوامر أعلاه ، ستكون الشهادات والمفاتيح الخاصة بك في:

• لـ RSA: /etc/letsencrypt/wiki.example.comالدليل.
• بالنسبة لـ ECC / ECDSA: /etc/letsencrypt/wiki.example.com_eccالدليل.

بعد الحصول على الشهادات من 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 كمدير العمليات الخاص به.