Podręcznik:Instalowanie MediaWiki
Ta strona opisuje kroki ręcznej instalacji MediaWiki, z dodatkowymi krokami konfiguracyjnymi znajdującymi się pod adresem Manual:System_administration#Configuration.
Instalacja MediaWiki wymaga podstawowej znajomości korzystania z hostingu internetowego. Łatwiej jest, jeśli masz doświadczenie z Apache (programowaniem serwera internetowego), PHP i MySQL/MariaDB (bazą danych). Dodatkowa pomoc jest dostępna za Project: Support desk.
Sekcja Dodatki poniżej oferuje alternatywy dla ręcznej instalacji. W tym celu można uzyskać informacje dotyczące instalacji w celu określenia konfiguracji systemu.
Check Szybki start rozwoju lokalnego for a quick way to install a local setup for development.
Sprawdź wymagania instalacyjne
Sprawdź, czy twój system spełnia wymagania instalacyjne.
Upewnij się, że sprawdzasz również Rejestr zmian wersji MediaWiki, którą planujesz zainstalować.
Pobierz oprogramowanie MediaWiki
Pobierz plik tar MediaWiki z oficjalna strona pobierania.
Jeśli używasz środowiska produkcyjnego, chcesz uruchomić najnowszą stabilną wersję, która wynosi MediaWiki 1.42.1.
Wyodrębnij oprogramowanie MediaWiki
Zawieszony plik jest w formie .zip lub w formie .tar.gz pliku.
Musisz rozprężć ten plik archiwum przed użyciem.
Plik można rozpakować lokalnie (a następnie przesłać przez FTP na serwer) lub bezpośrednio na serwerze.
Na systemie Windows odkompresja jest zazwyczaj wykonywana za pomocą oprogramowania takiego jak 7-Zip (darmowe), WinZip, WinRAR lub IZArc (darmowy).
Na Linuxie i Mac OS X można rozkompresować plik za pomocą polecenia:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> Więcej informacji: Manual:Security#File_permissions.
Przesyłanie plików na serwer internetowy
Jeśli pliki nie zostały jeszcze przesłane na serwer WWW (lub skopiowane, jeśli oprogramowanie serwera WWW działa lokalnie na localhost), zrób to teraz.
Załóż pliki do katalogu serwera internetowego za pomocą:
- przeczywistnie kopiowanie niewyłączonego folderu lub
- poprzez użycie klienta FTP, takiego jak FileZilla (Windows, OSX i Linux) lub Cyberduck (Windows i OSX).
- korzystając z oprogramowania dostarczonego przez usługę hostingową, takiego jak cPanel File Manager.
Jeśli narzędzie do przesyłania ma opcję "zmieniać nazwy plików na drobne litery", musisz to wyłączyć.
Jeśli używasz serwera internetowego Apache HTTPD, właściwy katalog jest określony w pliku httpd.conf w dyrektywie DocumentRoot.
Domyślnie jest to /var/www/ lub <apache-folder>/htdocs.
Dokładna lokalizacja ustawień serwera Apache i pliku katalogów httpd.conf zależy od systemu operacyjnego.
W Debian i Ubuntu plik ustawień serwera Apache i katalogów jest /etc/apache2/apache2.conf.
W Red Hat i Fedora plik ten ma wartość /etc/httpd/conf/httpd.conf.
Nazwa przesłanego folderu na wszystko, co chcesz mieć w adresie URL.
Jeśli serwer internetowy działa na poziomie http://localhost na przykład, przemiana nazwy na /w/ oznacza, że uzyskasz dostęp do swojego wiki w http://localhost/w/index.php.
/wiki/, jeśli chcesz skonfigurować go jako krótki URL po uruchomieniu skryptu instalacyjnego.
Konfiguracja bazy danych
Skrypt instalacyjny MediaWiki skrypt instalacyjny zapyta o nazwę bazy danych i nazwę użytkownika bazy danych, aby MediaWiki mogło przechowywać zawartość wiki.
Jeśli masz już serwer bazy danych i znasz hasło dla użytkownika "root" (admin), przejdź do sekcji #Uruchom skrypt instalacyjny poniżej.
Jeśli nie znasz hasła użytkownika root, na przykład jeśli jesteś na hostowanym serwerze, będziesz musiał utworzyć nową bazę danych przed uruchomieniem skryptu instalacyjnego MediaWiki w następnej sekcji.
MariaDB/MySQL to zalecana baza danych. PostgreSQL i SQLite mają ograniczony wsparcie i nie powinny być używane, chyba że istnieje powód do tego. Jeśli nie wiesz, którą bazę danych wybrać, użyj MariaDB.
Po zakończeniu konfiguracji bazy danych, kontynuuj #Uruchom skrypt instalacyjny poniżej.
SQLite
Nie jest wymagana dalsza konfiguracja dla SQLite, jeśli moduł pdo-sqlite dla PHP jest zainstalowany w systemie.
Na stronie instalacji SQLite wybierz nazwę bazy danych (który może być czymkolwiek) i katalog bazy danych SQLite. W przypadku katalogu bazy danych instalator będzie próbował użyć podkatalogu poza korzeniem dokumentu i w razie potrzeby go utworzyć. Jeśli katalog ten nie jest bezpieczny (np. czytelny w sieci), należy go zmienić ręcznie, aby uniknąć udostępnienia go wszystkim w sieci.
MariaDB/MySQL
Utwórz bazę danych MariaDB/MySQL i użytkownika bazy danych. Jest kilka sposobów:
- Użyj oprogramowania panela kontrolnego oferowanego przez usługę hostingową (przykład: PhpMyAdmin).
- Użyj ssh, aby zalogować się do swojego hosta i wpisz poniższe polecenia w wierszu MySQL. Zobacz odpowiednią dokumentację dostawcy hostingu. Alternatywnie, skontaktuj się ze swoim dostawcą usług hostingowych, aby utworzył dla ciebie konto.
Następujące polecenia tworzą bazę danych o nazwie my_wiki, użytkownika o nazwie wikiuser i ustawią uprawnienia dla użytkowników na tej bazie danych.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Tylko jeśli baza danych nie jest uruchomiona na tym samym serwerze co serwer WWW, należy podać odpowiednią nazwę hosta serwera WWW (mediawiki.example.com w poniższym przykładzie):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 Uwaga: | MySQL/MariaDB zapisuje wszystkie zapytania w pliku historii. Zawiera on hasło bazy danych konta użytkownika. Jeśli dotyczy to ciebie, usuń i wyłącz plik .mysql_history po uruchomieniu tych zapytań, śledząc dokumentacja MySQL. |
PostgreSQL
Jeśli używasz PostgreSQL, będziesz musiał albo mieć bazę danych i użytkownika utworzonego dla ciebie, albo podać nazwę użytkownika PostgreSQL z uprawnieniami "superużytkownika" do formularza konfiguracyjnego.
Często jest to użytkownik bazy danych o nazwie postgres.
Następujące polecenia w linii poleceń linuksowych, jako użytkownik postgres, tworzą użytkownika bazy danych o nazwie wikiuser, a bazę danych o nazbie my_wiki należącą do użytkowników o nazwie wikiuser
createuser -S -D -R -P -E wikiuser (wstaw hasło bazy danych) createdb -O wikiuser my_wiki
lub jako superużytkownik (default postgres) wykonuje następujące polecenia w proszku bazy danych:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Uważaj na list of known issues when running MediaWiki with PostgreSQL.
Uruchom skrypt instalacyjny
Następnie zakończ instalację MediaWiki, idąc do adresu URL instalacji MediaWiki w przeglądarce internetowej:
Późniejsza konfiguracja
- Podręcznik:Administrowanie systemem - Dodatkowa konfiguracja
- Podręcznik:Administratorzy - Administracja Wiki
Bądź na bieżąco!
Po zainstalowaniu, upewnij się, że jesteś na bieżąco z wydanymi wersjami i zachować bezpieczny serwer!
Załączniki
Alternatywy zamiast ręcznej instalacji
Wykorzystanie instalacji ręcznej jest często preferowanym sposobem, ponieważ daje użytkownikowi większą kontrolę i wgląd w sposób, w jaki jest zainstalowany jego wiki, ułatwiając rozwiązywanie problemów i utrzymanie. Automatyczne procesy, pakiety, pakiety i usługi mają swoje własne idiosynkrasy.
Zamiast ręcznie instalować MediaWiki, alternatywne opcje mogą być łatwiejsze:
- Usługi hostingowe, które zapewniają automatyczną instalację aplikacji takich jak MediaWiki, mogą oferować nieaktualne wersje lub mieć inne problemy. Jeśli napotkasz problemy, nie oznacza to, że nie możesz zainstalować MediaWiki. Oznacza to, że należy zainstalować MediaWiki ręcznie.
Zobacz również comparison of distribution options.
Instrukcje specyficzne dla systemu
Strony wymienione w Manual:OS specific help/pl zawierają szczegółowe instrukcje instalacji skierowane do konkretnych systemów.
Jednakże w większości przypadków te dokumenty są mniej utrzymywane i mogą nie zawsze być aktualne. Najpierw należy zapoznać się z Instalowanie MediaWiki (ta strona) przed zapoznaniem się z dokumentacją instalacji systemu.
Uruchamianie wielu wiki
Patrz Podręcznik:FAQ#Instalacja i konfiguracja.
Importowanie istniejącej bazy danych wiki
Patrz Podręcznik:FAQ#Instalacja i konfiguracja.