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.

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: