HowtoForge

Wie man MediaWiki unter Debian 12 installiert

von ·

MediaWiki ist eine Open-Source-Wikisoftware, die von den größten Wikiseiten wie Wikipedia und Wikimedia verwendet wird. Es ist eine kostenlose Wiki-Software, die als Plattform für Zusammenarbeit und Dokumentation genutzt werden kann. Es ist eine leistungsstarke, skalierbare und funktionsreiche Wiki-Implementierung.

In diesem Lernprogramm zeigen wir dir, wie du MediaWiki mit dem LAMP-Stack (Apache, MariaDB und PHP) auf dem Debian 12 Server installierst. Außerdem zeigen wir dir, wie du MediaWiki mit HTTPS über Certtbot und Letsencrypt absicherst.

Voraussetzungen

Bevor du beginnst, solltest du sicherstellen, dass du Folgendes hast:

  • Einen Debian 12 Server.
  • Einen Nicht-Root-Benutzer mit Administrator-Rechten.
  • Einen Domainnamen, der auf eine Server-IP-Adresse zeigt.

Installation des LAMP-Stacks

MediaWiki ist eine Open-Source-Software, die auf PHP mit MySQL/MariaDB als Datenspeicher basiert. Die aktuelle stabile Version von MediaWiki (1.41) erfordert mindestens PHP 7.3.4 oder höher und MariaDB 10.3.0. Als Webserver kannst du entweder Apache oder Nginx verwenden.

In diesem Abschnitt installierst du den LAMP-Stack (Apache, MariaDB und PHP), auf dem deine MediaWiki-Installation laufen wird.

Aktualisiere zunächst dein Debian-Repository mit dem folgenden Befehl.

sudo apt update

Sobald das Repository aktualisiert ist, installierst du die LAMP-Stack-Abhängigkeiten mit dem folgenden Befehl. Gib Y ein, um die Installation zu bestätigen.

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php php php-common php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu

deps installieren

Sobald die Installation abgeschlossen ist, überprüfe den Apache- und MariaDB-Dienst, um sicherzustellen, dass beide Dienste laufen.

Überprüfe den Apache-Webserver mit dem unten stehenden Befehl. Wenn du eine aktivierte Ausgabe erhältst, bestätigt dies, dass Apache aktiviert ist und beim Start automatisch gestartet wird. Wenn er läuft, siehst du die Ausgabe active (läuft).

sudo systemctl is-enabled apache2
sudo systemctl status apache2

apache2 überprüfen

Als Nächstes überprüfst du den MariaDB-Datenbankserver mit dem unten stehenden Befehl. Die Ausgabe sollte ähnlich sein, eine Ausgabe enabled bestätigt, dass MariaDB aktiviert ist, und active (running) bestätigt, dass MariaDB läuft.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

verifiziere mariadb

Überprüfe schließlich die PHP-Version und liste die aktivierten Module mit dem unten stehenden Befehl auf. Du wirst sehen, dass PHP 8.2 auf deinem Debian-Server installiert ist.

php -v
php -m

php verifizieren

PHP konfigurieren

Nachdem du den LAMP Stack installiert hast, musst du deine PHP-Installation konfigurieren, indem du die Datei php.ini bearbeitest und einige Standardparameter für MediaWiki änderst.

Um PHP zu konfigurieren, öffnest du die PHP-Konfigurationsdatei /etc/php/8.2/apache2/php.ini mit dem folgenden Befehl des nano-Editors.

sudo nano /etc/php/8.2/apache2/php.ini

Ändere die Standardkonfiguration wie folgt und stelle sicher, dass du date.timezone und memory_limit an deine aktuelle Umgebung anpasst.

date.timezone = Europe/Amsterdam
upload_max_filesize = 80M
memory_limit = 512M
max_execution_time = 360

Speichere und beende die Datei.

Führe nun den folgenden Befehl aus, um den Apache-Dienst neu zu starten und deine Änderungen zu übernehmen.

sudo systemctl restart apache2

MariaDB Server konfigurieren

Nachdem du PHP konfiguriert hast, musst du im nächsten Schritt den MariaDB-Server sichern und eine neue Datenbank und einen neuen Benutzer für MediaWiki anlegen. In diesem Beispiel sicherst du den MariaDB-Server mit der Befehlszeile mariadb-secure-installation und erstellst eine neue Datenbank und einen neuen Benutzer über den MariaDB-Client.

Um die Installation des MariaDB-Servers zu sichern, führe den Befehl mariadb-secure-installation aus.

sudo mariadb-secure-installation

Gib nun Y ein, um die neue Konfiguration auf dem MariaDB-Server zu akzeptieren oder n, um sie abzulehnen:

  • Die Standardinstallation von MariaDB wird ohne Passwort geliefert. Drücke ENTER, wenn du zur Eingabe des Passworts aufgefordert wirst.
  • Gib nun Y ein, um das MariaDB Root-Passwort einzurichten. Gib dann das neue Passwort für MariaDB ein und wiederhole das Passwort.
  • Gib Y ein, um den anonymen Benutzer aus deiner MariaDB-Installation zu entfernen.
  • Gib erneut Y ein, wenn du aufgefordert wirst, die Fernanmeldung für den MariaDB-Root-Benutzer zu deaktivieren.
  • Gib Y ein, um den Standard-Datenbanktest aus deiner MariaDB zu entfernen.
  • Gib schließlich Y ein, um die Tabellenberechtigungen neu zu laden und die neuen Änderungen anzuwenden.

Nachdem du den Einsatz des MariaDB-Servers gesichert hast, melde dich mit dem unten stehenden Befehl mariadb am MariaDB-Server an. Gib dein MariaDB Root-Passwort ein, wenn du dazu aufgefordert wirst.

sudo mariadb -u root -p

Führe nun die folgenden Abfragen aus, um eine neue MariaDB-Datenbank und einen neuen Benutzer für MediaWiki zu erstellen. In diesem Beispiel erstellst du eine neue Datenbank mediawikidb, einen Benutzer mediawiki mit dem Passwort mediawikipassdb. Du kannst das Folgende mit deinen Zugangsdaten anpassen.

CREATE DATABASE mediawikidb;
CREATE USER mediawiki@localhost IDENTIFIED BY 'mediawikipassdb';
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;

Datenbank und Benutzer anlegen

Als Nächstes führst du die folgende Abfrage aus, um die Berechtigungen des MariaDB-Benutzers mediawiki zu überprüfen. Stelle sicher, dass der Benutzer mediawiki auf die Datenbank mediawikidb zugreifen kann.

SHOW GRANTS FOR mediawiki@localhost;

Zum Schluss gibst du quit ein, um MariaDB zu verlassen, wenn du fertig bist.

Benutzerberechtigungen prüfen

Herunterladen des MediaWiki-Quellcodes

Jetzt, da die Abhängigkeiten installiert und konfiguriert sind, kannst du MediaWiki installieren. Es gibt mehrere Versionen von MediaWiki: stable, legacy und LTS. In diesem Fall wirst du die letzte stabile Version von MediaWiki 1.41 installieren.

Wechsle in das Verzeichnis /var/www und lade den MediaWiki-Quellcode mit dem unten stehenden wget-Befehl herunter. Achte darauf, dass du die MediaWiki-Downloadseite besuchst, um die neueste Version zu erhalten.

cd /var/www/
wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.0.tar.gz

Nach dem Download entpackst du den Quellcode mit dem folgenden Befehl. Benenne dann das extrahierte Verzeichnis in mediawiki um. Das DocumentRoot-Verzeichnis für MediaWiki befindet sich dann unter /var/www/mediawiki.

tar -xvzf mediawiki-*.tar.gz
mv mediawiki-*/ mediawiki/

Zuletzt änderst du den Eigentümer des Verzeichnisses /var/www/mediawiki auf den Benutzer www-data und änderst die Berechtigung auf 0755.

sudo chown -R www-data:www-data /var/www/mediawiki
sudo chmod 755 /var/www/mediawiki

Einrichten des virtuellen Apache-Hosts

Nachdem du nun den MediaWiki-Quellcode heruntergeladen hast, wirst du in diesem Abschnitt eine neue Apache Virtual Host-Datei für den Betrieb von MediaWiki erstellen. Stelle also sicher, dass der Domainname auf die IP-Adresse deines Servers verweist. Für die Produktion kaufst du die öffentliche Domain, oder du kannst auch den lokalen Domainnamen verwenden.

Bevor du beginnst, aktiviere das Apache-Rewrite-Modul mit dem folgenden Befehl.

sudo a2enmod rewrite

Erstelle nun eine neue Apache Virtual Host Konfiguration/etc/apache2/sites-available/mediawiki.conf mit dem unten stehenden nano Editor Befehl.

sudo nano /etc/apache2/sites-available/mediawiki.conf

Füge die folgende Konfiguration ein und stelle sicher, dass du die Option ServerName mit deinem Domainnamen und dem Pfad der Zugriffs- und Fehlerprotokolle änderst.

<VirtualHost *:80>
ServerName wiki.hwdomain.io

ServerAdmin admin@wiki.hwdomain.io
DocumentRoot /var/www/mediawiki

ErrorLog /var/log/apache2/wiki.hwdomain.io_error.log
CustomLog /var/log/apache2/wiki.hwdomain.io_access.log combined

<Directory /var/www/mediawiki/>
Options FollowSymlinks
AllowOverride All
Require all granted
</Directory>

</VirtualHost>

Speichere die Datei und beende den Editor.

Als Nächstes aktivierst du die virtuelle Hostdatei mediawiki.conf und überprüfst die Apache-Syntax mit dem unten stehenden Befehl. Wenn du eine korrekte Apache-Syntax hast, wirst du eine Ausgabe wie Syntax OK sehen.

sudo a2ensite mediawiki.conf
sudo apachectl configtest

Starte schließlich den Apache-Webserver neu, um den neuen virtuellen Host für MediaWiki zu übernehmen. Nach dem Neustart sollte deine MediaWiki-Installation fertig sein.

sudo systemctl restart apache2

apache vhost einrichten

MediaWiki mit HTTPS absichern

Nachdem du einen virtuellen Apache-Host für MediaWiki eingerichtet hast, musst du deine Installation mit HTTPS über Certbot und letsencrypt absichern. Dies gilt nur, wenn du die öffentliche Domain verwendest. Wenn du die lokale Domain verwendest, kannst du selbstsignierte Zertifikate erstellen und HTTPS manuell anwenden.

Installiere Certbot und das Certbot Apache Plugin mit dem unten stehenden Befehl. Gib Y ein, um die Installation zu bestätigen.

sudo apt install certbot python3-certbot-apache

Sobald die Installation abgeschlossen ist, führe den unten stehenden Certbot-Befehl aus, um SSL/TLS-Zertifikate für deinen MediaWiki-Domainnamen zu generieren. Achte darauf, dass du den Domainnamen und die E-Mail-Adresse mit deinen Daten änderst.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email alice@hwdomain.io -d wiki.hwdomain.io

Nachdem der Vorgang abgeschlossen ist, steht dein Zertifikat im Verzeichnis /etc/letsencrypt/live/domain.com zur Verfügung, während dein virtueller Host ebenfalls mit HTTPS konfiguriert ist.

Installation von MediaWiki

Öffne deinen bevorzugten Webbrowser und rufe deinen Domainnamen auf, z. B. http://wiki.hwdomain.io/. Wenn alles gut geht, solltest du die MediaWiki-Willkommensseite sehen. Klicke auf den Link Wiki einrichten.

Setup-Wiki

Wähle die Standardsprache für dein MediaWiki und klicke auf Weiter.

Sprache auswählen

Vergewissere dich bei der Umgebungsprüfung, dass dein System die Anforderungen von MediaWiki erfüllt. Klicke dann erneut auf Weiter.

Umwelt-Check

Wähle als Datenbank MariaDB und gib deinen Namen, deinen Benutzer und dein Passwort ein. Klicke dann auf Weiter, um fortzufahren.

db-Konfiguration

Als Nächstes gibst du deinen Benutzernamen, deine E-Mail-Adresse und dein Passwort für MediaWiki ein und klickst dann auf Weiter.

Admin-Setup

Für weitere Einstellungen wählst du das Standardthema aus, das du verwenden möchtest, und klickst dann auf Weiter, um mit der Installation fortzufahren.

Standardeinstellungen

Klicke auf Weiter, um die Installation von MediaWiki zu bestätigen.

bestätige die Installation

Vollständige

Sobald die Installation abgeschlossen ist, wird die Datei LocalSettings.php automatisch auf deinen lokalen Computer heruntergeladen und du erhältst die Anweisung, die Datei in dein MediaWiki-Installationsverzeichnis hochzuladen.

Installation beendet

Gehe zurück zu deinem Terminal und führe den folgenden Befehl aus, um eine neue Datei LocalSettings.php zu erstellen.

sudo -u www-data nano /var/www/mediawiki/LocalSettings.php

Öffne die Datei LocalSettings.php, die du heruntergeladen hast, und kopiere den PHP-Code und füge ihn auf deinem Server ein. Speichere dann die Datei und beende sie.

Kehre zu deinem Webbrowser zurück und klicke auf den Link, um das Wiki zu betreten. Du wirst die Standard-Startseite von MediaWiki sehen, die du installiert hast.

mediawiki home

Fazit

Herzlichen Glückwunsch! Du hast MediaWiki nun erfolgreich auf dem Debian 12 Server installiert. Du hast MediaWiki mit dem LAMP-Stack (Apache, MariaDB und PHP) installiert und MediaWiki mit HTTPS von Letsencrypt gesichert.

Das könnte dich auch interessieren …