Как да инсталирате Wiki.js на Ubuntu 18.04

Wiki.js е безплатно и модерно уики приложение с отворен код, изградено на 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 или по-нова
• Минимум 768MB RAM
• Име на домейн с 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, така че не е необходимо да го инсталираме. Ако искате да инсталирате по-нова версия, можете да използвате 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 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не е необходимо, но ще осигури трафика на вашия сайт. Acme.sh е чист софтуер за 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 [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'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 като мениджър на процеси.