Podręcznik:Instalowanie MediaWiki
Ta strona opisuje kroki ręcznej instalacji MediaWiki, z dodatkowymi krokami konfiguracyjnymi znajdującymi się pod adresem Podręcznik:System administracji#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.
For a quicker local server setup of MediaWiki, refer to the Szybki start rozwoju lokalnego .
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.
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. Jeśli używasz środowiska produkcyjnego, chcesz uruchomić najnowszą stabilną wersję, która wynosi MediaWiki 1.42.3.
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.
For example, if you rename the folder to "wiki", the URL will reflect this as "yourdomain.com/wiki".
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.
- 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';
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:
- prefabrykowane urządzenia programowe
- usługi hostingowe z instalacją 1 kliknięciem lub farmy wiki
- Zestawy oprogramowania
- 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.