كيفية تثبيت Wiki.js على دبيان 9

• المتطلبات
• تثبيت Git
• قم بتثبيت 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 على نسخة جديدة من Debian 9 Vultr باستخدام Node.js و MongoDB و PM2 و Nginx و Git و Acme.sh.

المتطلبات

• Node.js 6.9.0 أو أحدث
• MongoDB 3.2 أو أحدث
• Nginx
• Git 2.7.4 أو أحدث
• مستودع متوافق مع Git (عام أو خاص) ( اختياري )
• الحد الأدنى من 768MB RAM
• اسم المجال مع A/ AAAAإعداد السجلات

تحقق من إصدار دبيان.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

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

apt update && apt upgrade -y

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

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

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

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

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

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

sudo dpkg-reconfigure tzdata

تثبيت Git

قم بتثبيت Git على دبيان.

sudo apt install -y git

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

git --version
# git version 2.11.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

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

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

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

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

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

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

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

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

يوصى بشدة بوضع خادم ويب قياسي أمام Wiki.js. هذا يضمن لك استخدام ميزات مثل SSL ، والعديد من مواقع الويب ، والتخزين المؤقت والمزيد. سنستخدم 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/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(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 باعتباره وكيل عكسي ( 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 your_email@example.com
cd ~

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

/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 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 

ملاحظة : لا تنس أن تستبدل wiki.example.comاسم المجال الخاص بك.

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

• بالنسبة لـ 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/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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 كمدير العمليات الخاص به. يمكنك إعادة تشغيل نظام التشغيل الخاص بك sudo rebootوالتحقق مما إذا كان Wiki.js يبدأ بعد إعادة التشغيل.