Jak nainstalovat Wiki.js na Fedoru 28

Požadavky

Než začnete

Nainstalujte Node.js

Nainstalujte MongoDB

Nainstalujte a nakonfigurujte Nginx

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

Nainstalujte Wiki.js

Nastavení PM2

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 Github . Tato příručka vám ukáže, jak nainstalovat Wiki.js na čerstvou instanci Fedory 28 Vultr pomocí Node.js, MongoDB, PM2, Nginx, Git a Acme.sh.

Požadavky

Požadavky pro spuštění Wiki.js jsou následující:

• Node.js verze 6.9.0 nebo novější
• MongoDB verze 3.2 nebo novější
• Webový server, jako je Nginx, Apache, IIS, Caddy nebo H2O. Tato příručka bude používat Nginx
• Git verze 2.7.4 nebo novější
• Úložiště kompatibilní s Git (veřejné nebo soukromé) Toto je volitelné
• Minimálně 768 MB RAM
• Název domény s nastavenými záznamy A/AAAA

Než začnete

Zkontrolujte verzi OS.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Vytvořte nový uživatelský účet bez oprávnění root s přístupem sudo a přepněte na něj.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

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

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

sudo dnf check-upgrade || sudo dnf upgrade -y

Nastavte časové pásmo.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Nainstalujte požadované a užitečné balíčky.

sudo dnf install -y wget vim unzip bash-completion git

Pro jednoduchost deaktivujte SELinux a Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Nainstalujte Node.js

Wiki.js vyžaduje Node.js 6.9.0 nebo novější, takže nejprve budeme muset nainstalovat Node.js.

Nainstalujte Node.js.

sudo dnf install -y nodejs

Zkontrolujte verze Node.js a npm.

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

Nainstalujte MongoDB

Wiki.js používá MongoDB jako databázový stroj. Podle toho budeme muset nainstalovat MongoDB na náš server.

Nainstalujte MongoDB.

sudo dnf install -y mongodb mongodb-server

Zkontrolujte verzi MongoDB.

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

Povolte a spusťte MongoDB.

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

Nainstalujte a nakonfigurujte Nginx

Wiki.js může běžet bez jakéhokoli skutečného webového serveru (jako je Nginx nebo Apache). Důrazně se však 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.

sudo dnf install -y nginx

Zkontrolujte verzi.

nginx -v
# nginx version: nginx/1.12.1

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á věc, kterou musíte změnit ve výše uvedené konfiguraci, je server_namedirektiva a případně proxy_passdirektiva, 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 klienta 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í.

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 your_email@example.com
cd ~

Zkontrolujte acme.shverzi.

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

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.com
• Pro ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecc

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

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/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í 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 spuštěním:

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

Nakonec uložte aktuální konfiguraci PM2 spuštěním příkazu: /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.