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: