Jak nainstalovat Wiki.js na Debian 9

Wiki.js je bezplatná a open source, moderní wiki aplikace postavená na Node.js, MongoDB, Git a Markdown. Zdrojový kód Wiki.js je veřejně hostován na GitHubu . Tato příručka vám ukáže, jak nainstalovat Wiki.js na novou instanci Debian 9 Vultr pomocí Node.js, MongoDB, PM2, Nginx, Git a Acme.sh.

Požadavky

• Node.js 6.9.0 nebo novější
• MongoDB 3.2 nebo novější
• Nginx
• Git 2.7.4 nebo novější
• Úložiště kompatibilní s Git (veřejné nebo soukromé) ( volitelné )
• Minimálně 768MB RAM
• Název domény s nastavenými záznamy A/AAAA

Zkontrolujte verzi Debianu.

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

Ujistěte se, že váš systém je aktuální.

apt update && apt upgrade -y

Nainstalujte potřebné balíčky.

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

Vytvořte nový non-rootuživatelský účet s sudopřístupem a přepněte na něj.

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

POZNÁMKA : Nahraďte johndoesvým uživatelským jménem.

Nastavte časové pásmo.

sudo dpkg-reconfigure tzdata

Nainstalujte Git

Nainstalujte Git na Debian.

sudo apt install -y git

Ověřte verzi Git.

git --version
# git version 2.11.0

Nainstalujte Node.js

Nainstalujte Node.js pomocí úložiště NodeSource APT pro Node.js.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs

Zkontrolujte verze Node.js a npm.

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

Nainstalujte MongoDB

Wiki.js používá MongoDB jako databázový stroj. Podle toho budeme muset nainstalovat MongoDB na náš server. K instalaci použijeme oficiální úložiště MongoDB .

Nainstalujte 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

Zkontrolujte verzi.

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

Povolte a spusťte MongoDB.

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

Nainstalujte a nakonfigurujte Nginx

Důrazně se doporučuje umístit před Wiki.js standardní webový server. To zajišťuje, že můžete používat funkce jako SSL, více webových stránek, ukládání do mezipaměti a další. V tomto tutoriálu použijeme Nginx, ale bude fungovat jakýkoli jiný server, stačí jej správně nakonfigurovat.

Nainstalujte 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

Zkontrolujte verzi.

sudo nginx -v
# nginx version: nginx/1.15.0

Povolte a spusťte Nginx.

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

Nakonfigurujte Nginx jako HTTPnebo HTTPS(pokud používáte SSL) reverzní proxy pro aplikaci Wiki.js.

Spusťte sudo vim /etc/nginx/conf.d/wiki.js.confa naplňte jej základní konfigurací reverzního proxy níže.

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;
    }

}

Jediné, co musíte ve výše uvedené konfiguraci změnit, je server_namesměrnice a případně proxy_passsměrnice, pokud se rozhodnete nakonfigurovat jiný port než 3000. Wiki.js standardně používá port 3000.

Zkontrolujte konfiguraci.

sudo nginx -t

Znovu načtěte Nginx.

sudo systemctl reload nginx.service

Nainstalujte Acme.sh a získejte certifikát Let's Encrypt (volitelné)

Zabezpečení vaší wiki HTTPSnení nutné, ale je dobrým zvykem, jak zabezpečit návštěvnost vašeho webu. K získání SSL certifikátu od Let's Encrypt použijeme klienta Acme.sh. Acme.sh je čistě unixový shell software pro získávání SSL certifikátů od Let's Encrypt s nulovými závislostmi. Díky tomu je velmi lehký ve srovnání s některými jinými klienty protokolu ACME, kteří k úspěšnému spuštění vyžadují mnoho závislostí.

Stáhněte a nainstalujte 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 ~

Zkontrolujte verzi.

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

Získejte certifikáty RSA a ECDSA pro 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 

POZNÁMKA : Nezapomeňte nahradit wiki.example.comnázvem vaší domény.

Po spuštění výše uvedených příkazů budou vaše certifikáty a klíče v následujících adresářích.

• Pro RSA: /etc/letsencrypt/wiki.example.comadresář.
• Pro ECC/ECDSA: /etc/letsencrypt/wiki.example.com_eccadresář.

Po získání certifikátů z Let's Encrypt musíme nakonfigurovat Nginx, abychom je mohli využívat.

Spusťte sudo vim /etc/nginx/conf.d/wiki.js.confznovu a nakonfigurujte Nginx jako HTTPSreverzní proxy.

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;
    }

}

Zkontrolujte konfiguraci.

sudo nginx -t

Znovu načtěte Nginx.

sudo systemctl reload nginx.service

Nainstalujte Wiki.js

Vytvořte prázdnou kořenovou složku dokumentů, kam by měla být nainstalována Wiki.js.

sudo mkdir -p /var/www/wiki.example.com

Přejděte do kořenové složky dokumentu.

cd /var/www/wiki.example.com

Změnit vlastnictví /var/www/wiki.example.comsložky na uživatele johndoe.

sudo chown -R johndoe:johndoe /var/www/wiki.example.com

Ze /var/www/wiki.example.comsložky spusťte následující příkaz ke stažení a instalaci Wiki.js.

curl -sSo- https://wiki.js.org/install.sh | bash

Chcete-li zobrazit aktuálně nainstalovanou verzi Wiki.js, můžete spustit následující příkaz.

node wiki --version
# 1.0.78

Po dokončení instalace budete vyzváni ke spuštění průvodce konfigurací.

Spusťte průvodce konfigurací spuštěním.

node wiki configure

To vás upozorní, abyste http://localhost:3000přešli na a nakonfigurovali Wiki.js. Pokud máte před Wiki.js Nginx, znamená to, že si můžete otevřít název své domény (např. http://wiki.example.com) namísto přechodu na localhost.

Pomocí webového prohlížeče přejděte na http://wiki.example.compokyny na obrazovce a postupujte podle nich. Všechna nastavení zadaná během průvodce konfigurací se uloží do config.ymlsouboru. Průvodce konfigurací za vás automaticky spustí Wiki.js.

Nastavení PM2

Ve výchozím nastavení se Wiki.js nespustí automaticky po restartu systému. Aby se to spustilo při bootování, musíme nastavit správce procesů PM2. PM2 je dodáván s Wiki.js jako lokální modul NPM, takže PM2 nemusíme instalovat globálně.

Řekněte PM2, aby se nakonfiguroval jako spouštěcí služba.

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup

Nakonec uložte aktuální konfiguraci PM2.

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Vaše instance Wiki.js běží jako proces na pozadí a jako správce procesů používá PM2. Svůj operační systém můžete restartovat sudo reboota zkontrolovat, zda se po restartu spustí Wiki.js.