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 portálu 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

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/

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.

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

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