Jak nainstalovat Wiki.js na naše virtuální servery (VPS) – přehledný návod

Wiki.js je moderní open-source wiki platforma, která běží na Node.js a můžete jí naprosto důvěřovat – je totiž bezpečná a jednoduchá na používání. Jestli vás nudí zastaralé systémy, tady jste správně. Wiki.js nabízí spoustu vychytávek, díky kterým se vám bude tvořit dokumentace skoro sama. Co třeba?

• pokročilé oprávnění uživatelů, 
• integrace s Git repozitáři, 
• vizuální a markdown editor, 
• nebo třeba podpora SSO (jednotné přihlašování). 

Ať už plánujete interní wiki, znalostní bázi nebo veřejnou dokumentaci, s Wiki.js jste na správné cestě.

(celý videonávod najdete na konci článku)

Krok 1: Příprava VPS serveru

Než začneme, nainstalujeme na serveru potřebné balíčky, bez kterých Wiki.js nešla spustit. Stačí zadat:

apt update && apt install -y nodejs npm

Krok 2: Příprava databáze

V Zákaznickém Centru si na konkrétním VPS vytvořte MariaDB databázi.

Krok 3: Instalace Wiki.js

Nejdřív vytvořte složku, kam chcete Wiki.js umístit (raději mimo standardní adresář /www):

mkdir -p /opt/wiki

cd /opt/wiki

Poté stáhněte nejnovější verzi Wiki.js přímo z GitHubu:

wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz

tar xzf wiki-js.tar.gz

VPS Centrum

Vyzkoušejte zdarma naši aplikaci pro správu serveru a domén. Budete si připadat jako zkušený administrátor.

Krok 4: Konfigurace Wiki.js

V adresáři Wiki.js najdete vzorový konfigurační soubor, který si upravte podle vlastních potřeb:

mv config.sample.yml config.yml

nano config.yml

V konfiguračním souboru upravte sekci „db“ na typ „mariadb“ a zadejte údaje, které jste si na začátku při vytváření databáze poznamenali.

Nastavte také položku BindIP na 127.0.0.1, aby Wiki.js běžela bezpečně jen lokálně.

Soubor uložte.

Krok 5: První spuštění

Ověřte si, že vše funguje správně. Stačí Wiki.js spustit:

node server

Pokud vše proběhne hladce, měli byste vidět potvrzení v logu.

Wiki.js pak můžete zastavit stisknutím kombinace Ctrl + c.

Krok 6: Automatické spuštění po restartu serveru

Aby Wiki.js fungovala nonstop a startovala automaticky po restartu serveru, je potřeba vytvořit tzv. systemd službu:

nano /etc/systemd/system/wiki.service

Do editoru vložte:

[Unit]
Description=Wiki.js
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always
# Consider creating a dedicated user for Wiki.js here:
User=nobody
Environment=NODE_ENV=production
WorkingDirectory=/opt/wiki
[Install]
WantedBy=multi-user.target

Soubor uložte a spusťte službu:

systemctl daemon-reload

systemctl start wiki

systemctl enable wiki

systemctl status wiki

Krok 7: Nastavení webserveru (NGINX nebo Apache)

Aby byla Wiki.js na vaší doméně dostupná, je třeba provést nastavení reverzní proxy přímo z VPS centra.

Přihlaste se do VPS Centra a přejděte do nastavení domény. Tam si vytvořte novou subdoménu:

Poté přejděte do nastavení subdomény:

Vyberte webserver, který máte aktivní a podle toho vložte konfiguraci:

NGINX:

Upravte konfigurační soubor a nahraďte sekci location / následujícím zápisem:

location / {
    proxy_pass http://localhost:3000/;

    proxy_http_version 1.1;

    proxy_set_header Host $host;

    proxy_set_header X-Real-IP $remote_addr;

    proxy_set_header X-Forwarded-For 

$proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Apache2:

Do Apache konfigurace doplňte:

ProxyPreserveHost On
ProxyPass / http://localhost:3000/
ProxyPassReverse / http://localhost:3000/
ProxyTimeout 360

Nezapomeňte konfiguraci uložit a webserver restartovat.

Krok 8: Dokončení instalace

Teď už stačí jen navštívit adresu vaší wiki v prohlížeči a dokončit instalaci registrací administrátora.

Gratulujeme! Máte hotovo a Wiki.js je připravena na vaše dokumenty.

Freelo - Nástroj na řízení úkolů a projektů

Přidej se, pozvi svůj tým a klienty, rozděl práci a sleduj, jak se úkoly dají do pohybu.

Video postup

Kdyby cokoliv haprovalo…celý proces instalace jsme pro vás pro jistotu natočili: