Příručka:Instalace MediaWiki
Tato stránka popisuje kroky k ruční instalaci MediaWiki, přičemž další konfigurační kroky naleznete na stránce Příručka:System_administration#Konfigurace.
Instalace MediaWiki vyžaduje základní znalost používání webového hostitele. Je to jednodušší, pokud máte nějaké zkušenosti s Apache (software webového serveru), PHP a MySQL/MariaDB (databáze). Další pomoc je k dispozici na stránce Project: Support desk.
Sekce Dodatky níže nabízí alternativy k ruční instalaci.
For a quicker local server setup of MediaWiki, refer to the Local development quickstart.
Kontrola požadavků na instalaci
Zkontrolujte, zda váš systém splňuje instalační požadavky.
Nezapomeňte také zkontrolovat Poznámky k vydání verze MediaWiki, kterou plánujete nainstalovat.
Stažení software MediaWiki
Stáhněte si soubor tar MediaWiki z oficiální stránky pro stažení.
If you are using MediaWiki in a production environment, the release manager has issued a strong recommendation that only versions listed at Version lifecycle and their end-of-life as the current "stable version", "legacy version" or "long-term support version" should be used in a production environment. Older versions may contain critical security vulnerabilities and other major bugs, including the threat of possible data loss and/or corruption. Obecně platí, že pokud používáte produkční prostředí, chcete používat nejnovější stabilní verzi, kterou je MediaWiki 1.42.4.
Extrahování software MediaWiki
Stažený soubor je ve formátu .zip nebo .tar.gz.
Před použitím musíte tento archivní soubor rozbalit.
Soubor můžete dekomprimovat lokálně (a poté nahrát přes FTP na server) nebo přímo na vašem serveru.
Ve Windows se dekomprimace obvykle provádí pomocí softwaru, jako je 7-Zip (zdarma), WinZip, WinRAR nebo IZArc (zdarma).
V systémech Linux a Mac OS X můžete soubor dekomprimovat pomocí tohoto příkazu:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> Další informace: Příručka:Zbezpečení#File_permissions
Nahrání souborů na váš webový server
Pokud jste ještě nenahráli soubory na váš webový server (nebo je zkopírovali, pokud software vašeho webového serveru běží lokálně na vašem localhost), udělejte tak nyní.
Nahrajte soubory do úložiště serveru buď:
- přímo zkopírováním extrahované složky nebo
- použitím FTP klienta jako FileZilla (Windows, OSX a Linux) nebo Cyberduck (Windows a OSX).
- pomocí softwaru již poskytnutého vaší hostingovou službou, jako je CPanel File Manager
Pokud má váš nahrávací nástroj možnost "změnit názvy souborů na malá písmena", musíte to zakázat.
Pokud používáte webový server Apache HTTPD, správný adresář je uveden ve vašem souboru httpd.conf v direktivě DocumentRoot.
Ve výchozím nastavení je to /var/www/ nebo <apache-folder>/htdocs.
Přesné umístění nastavení serveru Apache a souboru adresářů httpd.conf závisí na vašem operačním systému.
V Debianu a Ubuntu je soubor pro nastavení a adresáře serveru Apache /etc/apache2/apache2.conf.
V Red Hatu a Fedoře je soubor /etc/httpd/conf/httpd.conf.
Přejmenujte nahranou složku na cokoliv co chcete mít v URL.
For example, if you rename the folder to wiki, the URL will reflect this as example.com/wiki.
Pokud váš webový server pracuje například jako http://localhost, přejmenování na adresář /w/ by znamenalo, že byste přistupovali ke své wiki jako http://localhost/w/index.php.
/wiki/, pokud ji chcete po spuštění instalačního skriptu nastavit jako Short URL.
Nastavení databáze
Instalační skript MediaWiki vás požádá o název databáze a uživatelské jméno databáze, takže MediaWiki může uložit obsah wiki.
Pokud již máte databázový server a znáte heslo pro uživatele "root" (admin), přejděte na část #Spustit instalační skript níže.
Pokud neznáte heslo pro uživatele root, například pokud jste na hostovaném serveru, budete muset před spuštěním instalačního skriptu MediaWiki v další části vytvořit novou databázi.
MariaDB/MySQL jsou doporučené databáze. PostgreSQL a SQLite mají omezenou podporu a neměly by se používat, pokud k tomu není důvod. Pokud si nejste jisti, kterou databázi zvolit, použijte MariaDB.
Po dokončení nastavení databáze pokračujte níže #Spuštění instalačního skriptu.
SQLite
Pokud je v systému nainstalován modul pdo-sqlite pro PHP, pro SQLite není potřeba žádné další nastavení.
Na instalační stránce SQLite vyberte název databáze (libovolný) a adresář databáze SQLite. V adresáři databáze se instalační program pokusí použít podadresář mimo kořen dokumentu a v případě potřeby jej vytvořit. Pokud tento adresář není bezpečný (například čitelný na webu), změňte jej ručně. Pro zabránění jeho zpřístupnění všem na webu.
MariaDB/MySQL
Vytvořte databázi a uživatele databáze MariaDB/MySQL.
- Použijte ovládací panel software nabízený vaší hostingovou službou (příklad: PhpMyAdmin)
- Pomocí ssh se přihlaste ke svému hostiteli a zadejte níže uvedené příkazy do řádku MySQL. Podívejte se na příslušnou dokumentaci vašeho poskytovatele hostingu. Případně kontaktujte svého poskytovatele hostingu, aby vám vytvořil účet.
Následující příkazy vytvoří databázi s názvem my_wiki, uživatele s názvem wikiuser a nastaví v této databázi oprávnění pro uživatele.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Pouze pokud vaše databáze neběží na stejném serveru jako váš webový server, musíte zadat příslušný název hostitele webového serveru (mediawiki.example.com v příkladu níže):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 Varování: | MySQL/MariaDB zaznamenává všechny dotazy do souboru historie. Bude obsahovat heslo databáze pro uživatelský účet. Pokud se vás to týká, smažte a deaktivujte soubor .mysql_history po spuštění těchto dotazů podle [dokumentace https://dev.mysql.com/doc/refman/8.0/en/mysql-logging.html#mysql-logging-history-file MySQL]. |
PostgreSQL
Pokud používáte PostgreSQL, musíte mít buď vytvořenou databázi a uživatele nebo jednoduše do konfiguračního formuláře zadat jméno uživatele PostgreSQL s oprávněními "superuživatele" (superuser).
Tím je často uživatel databáze s názvem postgres.
Následující příkazy na příkazovém řádku Linuxu jako uživatel postgres vytvoří uživatele databáze s názvem wikiuser a databázi s názvem my_wiki vlastněnou uživatelem jménem wikiuser.
createuser -S -D -R -P -E wikiuser (poté zadejte heslo databáze) createdb -O wikiuser my_wiki
nebo jako superuser (výchozí postgres) spusťte na příkazovém řádku databáze následující příkazy:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Dejte pozor na seznam známých problémů při spuštění MediaWiki s PostgreSQL.
Spusťte instalační skript
Dále dokončete instalaci MediaWiki tak, že ve webovém prohlížeči přejdete na adresu URL vaší instalace MediaWiki: Postupujte podle pokynů na stránce Příručka:Konfigurační skript.
Další nastavení
- Příručka:Administrace systému - pokročilá konfigurace
- Příručka:Administrátoři - správa wiki
Udržujte systém aktuální!
Po instalaci se ujistěte, že budete neustále informováni o vydáních a udržujte svůj server v bezpečí!
Přílohy
Alternativy k ruční instalaci
Ruční instalace je často preferovanou metodou, protože poskytuje uživateli větší kontrolu a přehled o tom, jak je jeho wiki nainstalována, což usnadňuje odstraňování problémů a údržbu. Automatizované procesy, balíčky, balíčky a služby mají všechny své vlastní zvláštnosti.
Místo ruční instalace MediaWiki mohou být alternativní možnosti jednodušší:
- předintegrovaná softwarová zařízení
- hostingové služby s instalací jedním kliknutím nebo wiki farmy
- Softwarové balíčky
- Hostingové služby, které poskytují automatickou instalaci aplikací, jako je MediaWiki, mohou nabízet zastaralé verze nebo mít jiné problémy. Pokud narazíte na problémy, neznamená to, že nemůžete nainstalovat MediaWiki. Znamená to, že byste měli nainstalovat MediaWiki ručně.
Více na stránce comparison of distribution options.
Pokyny pro konkrétní systémy
Na stránce Příručka:Nápověda pro konkrétní OS najdete podrobnější pokyny k instalaci zaměřené na konkrétní systémy.
Celkově jsou však tyto dokumenty pro jednotlivé systémy méně udržované a nemusí být vždy aktuální. Nejprve se podívejte na Instalace MediaWiki (tuto stránku), než se podíváte na dokumentaci k instalaci jednotlivých systémů.
Pokud provozujete více než jednu wiki
Viz Příručka:FAQ#Instalace a konfigurace.
Import existující wiki databáze
Viz Příručka:FAQ#Instalace a konfigurace.