Как установить Wiki.js в Debian 9

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

Wiki.js - это бесплатное современное вики-приложение с открытым исходным кодом, созданное на Node.js, MongoDB, Git и Markdown. Исходный код Wiki.js публично размещен на GitHub . Это руководство покажет вам, как установить Wiki.js на свежий экземпляр Debian 9 Vultr с помощью Node.js, MongoDB, PM2, Nginx, Git и Acme.sh.

Требования

• Node.js 6.9.0 или новее
• MongoDB 3.2 или более поздняя версия
• Nginx
• Git 2.7.4 или позже
• Git-совместимое хранилище (публичное или частное) ( необязательно )
• Минимум 768MB RAM
• Доменное имя с A/ AAAAзаписи настроены

Проверьте версию Debian.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

Убедитесь, что ваша система обновлена.

apt update && apt upgrade -y

Установите необходимые пакеты.

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

Создайте новую non-rootучетную запись пользователя с sudoдоступом и переключитесь на нее.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

ПРИМЕЧАНИЕ . Замените johndoeна свое имя пользователя.

Установите часовой пояс.

sudo dpkg-reconfigure tzdata

Установить Git

Установите Git на Debian.

sudo apt install -y git

Проверьте версию Git.

git --version
# git version 2.11.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

Wiki.js использует MongoDB в качестве движка базы данных. В соответствии с этим нам нужно будет установить MongoDB на наш сервер. Мы будем использовать официальные репозитории MongoDB для установки.

Установите MongoDB Community Edition.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

Проверьте версию.

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

Включите и запустите MongoDB.

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

Установите и настройте Nginx

Настоятельно рекомендуется поместить стандартный веб-сервер перед Wiki.js. Это гарантирует, что вы можете использовать такие функции, как SSL, несколько веб-сайтов, кэширование и многое другое. Мы будем использовать 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/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(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 как обратный прокси-сервер 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 ~

Проверьте версию.

/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 

ПРИМЕЧАНИЕ : не забудьте заменить wiki.example.comна ваше доменное имя.

После выполнения вышеуказанных команд ваши сертификаты и ключи будут находиться в следующих каталогах.

• Для 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/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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 в качестве диспетчера процессов. Вы можете перезагрузить свою ОС sudo rebootи проверить, запускается ли Wiki.js после перезагрузки.