نحوه نصب Wiki.js در اوبونتو 18.04

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

Wiki.js یک برنامه ویکی مدرن رایگان و منبع باز است که در Node.js ، Git و Markdown ساخته شده است . کد منبع Wiki.js در Github به صورت عمومی میزبانی می شود . این راهنما نحوه نصب Wiki.js را روی نمونه های جدید اوبونتو 18.04 LTS Vultr با استفاده از Node.js ، MongoDB ، PM2 ، Nginx ، Git و Acme.sh. به شما نشان می دهد.

الزامات

شرایط لازم برای اجرای Wiki.js و پایان دادن به این راهنما به شرح زیر است:

• Node.js نسخه 6.9.0 یا بالاتر
• نسخه MongoDB 3.2 یا بالاتر
• نگینکس
• نسخه Git 2.7.4 یا بالاتر
• حداقل رم 768 مگابایت
• نام دامنه با A/ AAAAسوابق تنظیم شده است

نسخه اوبونتو را بررسی کنید.

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 در نسخه سرور اوبونتو از پیش نصب شده است ، بنابراین نیازی به نصب آن نداریم. اگر می خواهید نسخه جدیدتری را نصب کنید ، می توانید از PPA های شخص ثالث استفاده کرده یا آخرین نسخه 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 را نصب کنید.

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

ایمن سازی ویکی HTTPSشما ضروری نیست ، اما باعث ترافیک سایت شما می شود. Acme.sh یک نرم افزار پوسته یونیکس خالص برای بدست آوردن گواهینامه های SSL از Let 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 [email protected]
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 [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فهرست.

پس از اخذ گواهینامه های 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 با 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 به عنوان مدیر فرایند خود استفاده می کند.