كيفية تثبيت Wiki.js على CentOS 7

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

المتطلبات

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

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

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

cat /etc/centos-release
# CentOS Linux release 7.5.1804 (Core)

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

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

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

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

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

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

sudo yum update -y

قم بتثبيت الحزم الضرورية لإنهاء هذا البرنامج التعليمي.

sudo yum install -y wget curl vim zip unzip bash-completion

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

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

قم بتمكين مستودع EPEL.

sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

تثبيت Git

توفر مستودعات CentOS إصدارًا قديمًا جدًا من Git ، لذلك سنحتاج إلى إنشاء Git من المصدر.

قم بتثبيت Git من خلال بنائه من كود المصدر.

# Remove existing git package if installed: 
sudo yum remove -y git
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gettext-devel openssl-devel perl-CPAN perl-devel zlib-devel curl-devel
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.17.1.tar.gz && tar zxvf git-2.17.1.tar.gz
rm git-2.17.1.tar.gz
cd git-2.17.1
make configure
./configure
make prefix=/usr/local all
sudo make prefix=/usr/local install
cd ~

# Confirm this command returns /usr/local/bin/git:
which git

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

git --version
# git version 2.17.1

قم بتثبيت Node.js

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

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

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum 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 vim /etc/yum.repos.d/mongodb-org-3.6.repo

# Copy/paste this
[mongodb-org-3.6]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc

sudo yum 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.

sudo vim /etc/yum.repos.d/nginx_mainline.repo

# Copy/paste this
[nginx]
name=nginx repo
baseurl=https://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=1
enabled=1

wget https://nginx.org/keys/nginx_signing.key
sudo rpm --import nginx_signing.key
rm nginx_signing.key

sudo yum install -y nginx

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

nginx -v
# nginx version: nginx/1.15.0

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

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

تكوين Nginx كوكيل HTTPأو HTTPSعكس لـ 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 هو نص برمجي خالص لـ 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 ~

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

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

احصل على شهادات RSA و ECDSA لنطاقك / اسم المضيف.

# 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 تكوين نفسه كخدمة بدء تشغيل.

/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 يبدأ بعد إعادة التشغيل.