Как установить Wiki.js на Fedora 28

• Требования
• Прежде чем вы начнете
• Установите Node.js
• Установить MongoDB
• Установите и настройте Nginx
• Установите клиент Acme.sh и получите сертификат Let's Encrypt (необязательно)
• Установить Wiki.js
• Настройка PM2

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 и Firewall.

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 your_email@example.com
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 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

ПРИМЕЧАНИЕ : не забудьте заменить 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 в качестве диспетчера процессов.