Как да инсталирате Wiki.js на Debian 9

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 (по избор)

Securing your wiki with HTTPS is not necessary, but it is a good practice to secure your site traffic. In order to obtain an SSL certificate from Let's Encrypt we will use the Acme.sh client. Acme.sh is a pure unix shell software for obtaining SSL certificates from Let's Encrypt with zero dependencies. That makes it very lightweight in comparison to some other ACME protocol clients that require a lot of dependencies to run successfully.

Download and install 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 ~

Check the version.

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

Obtain RSA and ECDSA certificates for 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 

NOTE: Don't forget to replace wiki.example.com with your domain name.

After running the above commands, your certificates and keys will be in the following directories.

• For RSA: /etc/letsencrypt/wiki.example.com directory.
• За 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 стартира след рестартиране.