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.
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 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
K nově vytvořenému adresáři vytvořte systémového uživatele wikijs, přiřaďte ho ke skupině www-data:
adduser --system --no-create-home --group wikijs
usermod -a -G www-data wikijs
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
Po stažení nastavte správná oprávnění složce wiki a jejímu obsahu a nastavte složce /opt/wiki a jejímu obsahu správného uživatele:
chown -R wikijs:www-data /opt/wiki/
chmod -R 750 /opt/wiki/
chmod -R 770 /opt/wiki/data/

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.
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=wikijs
Group=www-data
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 domény (případně subdomény) 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;
}
Zároveň smažte ostatní definice tak, aby blok server vypadal podle následujícího vzoru:
server {
server_name wiki.vas-hosting.cz wikijs.vas-hosting.cz.<ID>.vas-server.cz;
include /etc/nginx/sites-available/domains_conf/vas-hosting.cz.conf;
### redirect to https - zacatek
# if ($scheme != https) { return 308 https://$host$uri$is_args$args; }
### redirect to https - konec
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 pro doménu (případně subdoménu), do sekce definování makra doplňte:
ProxyPreserveHost On
ProxyPass / http://localhost:3000/
ProxyPassReverse / http://localhost:3000/
ProxyTimeout 360
Zároveň smažte mod_proxy_fcgi tak, aby makro vypadalo podle následujícího vzoru:
<Macro wiki.vas-hosting.cz>
## odkomentovat, pokud se ma web presmerovavat automaticky z http na https - pozor, bude automaticky pro vsechny subdomeny!!!
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteCond %{REQUEST_URI} !^/\.well\-known/acme\-challenge/ [NC]
# RewriteRule (.*) https://%{SERVER_NAME}$1 [R,L]
ProxyPreserveHost On
ProxyPass / http://localhost:3000/
ProxyPassReverse / http://localhost:3000/
ProxyTimeout 360
</Macro>
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.
Video postup
Kdyby cokoliv haprovalo…celý proces instalace jsme pro vás pro jistotu natočili: