نحوه نصب Wiki.js در CentOS 7

• الزامات
• Git را نصب کنید
• Node.js را نصب کنید
• MongoDB را نصب کنید
• Nginx را نصب و پیکربندی کنید
• مشتری Acme.sh را نصب کنید و یک گواهی Letry Encrypt (اختیاری) دریافت کنید
• Wiki.js را نصب کنید
• PM2 را تنظیم کنید

Wiki.js یک برنامه ویکی مدرن رایگان و منبع باز است که در 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 یا بالاتر
• نگینکس
• نسخه 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 و Firewall را غیرفعال کنید.

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 را نصب کنید.

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 را نصب کنید و یک گواهی Letry Encrypt (اختیاری) دریافت کنید

ایمن سازی ویکی با استفاده HTTPSاز آن ضروری نیست ، اما این یک عمل خوب برای تأمین ترافیک سایت شماست. به منظور به دست آوردن گواهینامه SSL از Let's Encrypt ، از مشتری Acme.sh استفاده خواهیم کرد. Acme.sh یک اسکریپت خالص UNIX برای دریافت گواهینامه های SSL از Let 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 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 را نصب کنید

یک پوشه root root را در جایی که 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. حرکت کنید. اگر در مقابل Wiki.js Nginx دارید ، می توانید 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 بعد از راه اندازی مجدد شروع می شود.