Як встановити Wiki.js на Ubuntu 18.04

Вимоги

Встановіть Git

Встановіть Node.js

Встановіть MongoDB

Встановіть і налаштуйте Nginx

Встановіть клієнт Acme.sh та отримайте сертифікат Let's Encrypt (необов’язково)

Встановіть Wiki.js

Встановіть PM2

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 або новішої
• Мінімум 768 МБ ОЗУ
• Доменне ім'я з 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 your_email@example.com
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 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 

Після виконання наведених вище команд ваші сертифікати та ключі будуть у:

• Для 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 як менеджер процесів.