Як встановити Wiki.js на Fedora 28

Wiki.js — це безкоштовний сучасний вікі-додаток з відкритим вихідним кодом, побудований на Node.js, MongoDB, Git і Markdown. Вихідний код Wiki.js відкрито розміщено на Github . Цей посібник покаже вам, як встановити Wiki.js на новий екземпляр Fedora 28 Vultr за допомогою Node.js, MongoDB, PM2, Nginx, Git і Acme.sh.

Вимоги

Вимоги для запуску Wiki.js є такими:

• Node.js версії 6.9.0 або новішої
• MongoDB версії 3.2 або новішої
• Веб-сервер, наприклад Nginx, Apache, IIS, Caddy або H2O. У цьому посібнику буде використовуватися Nginx
• Git версії 2.7.4 або новішої
• Git-сумісне сховище (публічне чи приватне) Це необов'язково
• Мінімум 768 МБ ОЗУ
• Доменне ім'я з A/ AAAAзапису налаштування

Перед тим як ти почнеш

Перевірте версію ОС.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Створіть новий обліковий запис користувача без права root з доступом sudo та перейдіть до нього.

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

ПРИМІТКА. Замініть johndoeна своє ім’я користувача.

Переконайтеся, що ваша система оновлена.

sudo dnf check-upgrade || sudo dnf upgrade -y

Налаштуйте часовий пояс.

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

Встановіть необхідні та корисні пакети.

sudo dnf install -y wget vim unzip bash-completion git

Для простоти вимкніть SELinux і брандмауер.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

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

Wiki.js вимагає Node.js 6.9.0 або новішої версії, тому нам спочатку потрібно буде встановити Node.js.

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

sudo dnf install -y nodejs

Перевірте версії Node.js і npm.

node -v && npm -v
# v8.11.3
# 5.6.0

Встановіть MongoDB

Wiki.js використовує MongoDB як механізм баз даних. Відповідно до цього нам потрібно буде встановити MongoDB на нашому сервері.

Встановіть MongoDB.

sudo dnf install -y mongodb mongodb-server

Перевірте версію MongoDB.

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3

Увімкніть і запустіть MongoDB.

sudo systemctl enable mongod.service
sudo systemctl start mongod.service

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

Wiki.js може працювати без будь-якого фактичного веб-сервера (наприклад, Nginx або Apache). Однак настійно рекомендується розмістити стандартний веб-сервер перед Wiki.js. Це гарантує, що ви можете використовувати такі функції, як SSL, кілька веб-сайтів, кешування тощо. У цьому підручнику ми будемо використовувати Nginx, але підійде будь-який інший сервер, вам просто потрібно його правильно налаштувати.

Встановіть Nginx.

sudo dnf install -y nginx

Перевірте версію.

nginx -v
# nginx version: nginx/1.12.1

Увімкніть і запустіть Nginx.

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

Налаштуйте Nginx як зворотний проксі-сервер HTTPабо HTTPS(якщо ви використовуєте SSL) для програми 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не є обов’язковим, але це гарна практика для захисту трафіку вашого сайту. Щоб отримати сертифікат 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 ~

Перевірте acme.shверсію.

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

Отримайте сертифікати 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

ПРИМІТКА . Не забудьте замінити 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 постачається разом із 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 як менеджер процесів.