Wikimore

Install MediaWiki

Szybki start rozwoju lokalnego

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 dostępna jest pod adresami Project: Support desk oraz Komunikacja .

Sekcja Dodatki poniżej oferuje alternatywy dla ręcznej instalacji, wraz ze szczegółowymi uwagami dotyczącymi instalacji dla różnych konfiguracji systemu operacyjnego.

Informacje dotyczące szybkiej instalacji na serwerze lokalnym dostępne są pod adresem 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.

Dla instalacji MediaWiki w środowisku produkcyjnym, menedżer ds. wdrożeń zdecydowanie zaleca wersje wymienione na tej liście i oznaczone statusami "current stable and long-term support version", "legacy stable version" lub "legacy long-term support version". Starsze wersje mogą zawierać krytyczne luki w zabezpieczeniach i inne poważne błędy, w tym zagrożenie utratą i/lub uszkodzeniem danych. Obecna stabilna wersja to MediaWiki 1.43.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

Bezpieczeństwo i uprawnienia plików - Podczas rozpakowywania pliku archiwum z konta użytkownika z uprawnieniami roota lub administratora, może zaistnieć konieczność późniejszej zmiany właściciela plików ze względów bezpieczeństwa, w zależności od konfiguracji systemu. W systemach Linux polecenie zostanie wykonane przy użyciu główna w następujący sposób: chown -R <new_owner_user> <mediawiki_folder> Aby uzyskać więcej informacji na temat zabezpieczania uprawnień do plików, zapoznaj się z 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 małe litery", musisz to wyłączyć, aby zapobiec przypadkowym modyfikacjom nazw plików podczas przesyłania.

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.

Zmień nazwę przesłanego folderu na własną, gdyż od tego będzie zależeć jego wygląd w adresie URL. Na przykład, jeśli zmienisz nazwę folderu na wiki, adres URL będzie wyglądał tak: example.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.

Nie używaj nazwy /wiki/, jeśli chcesz skonfigurować krótkie URLe po uruchomieniu skryptu instalacyjnego.

Konfiguracja bazy danych

Skrypt instalacyjny MediaWiki skrypt instalacyjny wymaga nazwy bazy danych i nazwy użytkownika bazy danych do przechowywania zawartości 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.

panel kontrolny oferowany 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. Możesz również zwrócić się do dostawcy hostingu z prośbą o utworzenie bazy danych i użytkownika.

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!

Zapisz się na listę mailingową ogłoszeń o wydaniach MediaWiki

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