Як встановити 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 your_email@example.com
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 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 

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