Jak nainstalovat Wiki.js na Ubuntu 18.04

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

Požadavky

Požadavky na spuštění Wiki.js a dokončení tohoto průvodce jsou následující:

• Node.js verze 6.9.0 nebo novější
• MongoDB verze 3.2 nebo novější
• Nginx
• Git verze 2.7.4 nebo novější
• Minimálně 768 MB RAM
• Název domény s nastavenými záznamy A/AAAA

Zkontrolujte verzi Ubuntu.

lsb_release -ds
# Ubuntu 18.04.4 LTS

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

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

sudo apt update && sudo apt upgrade -y

Nainstalujte potřebné balíčky.

sudo apt install -y build-essential apt-transport-https

Nainstalujte Git

Git 2.7.4 je předinstalovaný na serverové edici Ubuntu, takže jej nemusíme instalovat. Pokud chcete nainstalovat novější verzi, můžete použít PPA třetích stran nebo zkompilovat nejnovější verzi Git ze zdroje.

Aktuálně nainstalovanou verzi Git můžete ověřit spuštěním:

git --version
# git version 2.7.4

Pokud chcete nainstalovat novější verzi softwaru Git, můžete použít následující.

# Remove existing git package
sudo apt remove -y git
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:git-core/ppa
sudo apt update && sudo apt upgrade -y
sudo apt install -y git

Ověřte verzi Git.

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

Budeme používat oficiální úložiště MongoDB , která jsou aktualizována podle nejnovějších hlavních a menších vydání MongoDB.

Nainstalujte MongoDB Community Edition.

sudo apt install -y mongodb

Zkontrolujte verzi.

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

Nainstalujte a nakonfigurujte Nginx

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/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(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 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á věc, kterou musíte změnit ve výše uvedené konfiguraci, je server_namedirektiva a případně proxy_passdirektiva, pokud se rozhodnete nakonfigurovat jakýkoli jiný port kromě 3000. Wiki.js standardně používá port 3000.

Zkontrolujte konfiguraci.

sudo nginx -t

Znovu načtěte Nginx.

sudo systemctl reload nginx.service

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

Zabezpečení vaší wiki HTTPSnení nutné, ale zajistí provoz vašeho webu. Acme.sh je čistě unixový shell software pro získávání SSL certifikátů od Let's Encrypt s nulovými závislostmi.

Stahovat a instalovat 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

Získejte certifikáty RSA a ECDSA pro wiki.example.comdoménu/název hostitele.

# 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 

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

• 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, aby je používal.

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

}

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í.

node wiki configure

To vás upozorní, abyste procházeli http://localhost:3000a konfigurovali Wiki.js. Pokud máte Nginx před Wiki.js, 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.

Nainstalujte 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 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

Wiki.js běží jako proces na pozadí a jako správce procesů používá PM2.