So installieren Sie MediaWiki auf Debian 12

MediaWiki ist eine Open-Source-Wiki-Software, die von den größten Wiki-Seiten 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.

Dieses Tutorial zeigt Ihnen, wie Sie MediaWiki mit dem LAMP-Stack (Apache, MariaDB und PHP) auf dem Debian 12-Server installieren. Darüber hinaus zeigen wir Ihnen, wie Sie MediaWiki mit HTTPS über Certbot und Letsencrypt sichern.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Einen Debian 12-Server.
• Einen Nicht-Root-Benutzer mit Administratorrechten.
• Einen Domainnamen, der auf eine Server-IP-Adresse verweist.

Installation des LAMP-Stacks

MediaWiki ist eine Open-Source-Software, die auf PHP basiert und MySQL/MariaDB als Datenspeicher verwendet. Derzeit erfordert die aktuelle stabile Version von MediaWiki (1.41) mindestens PHP 7.3.4 oder höher und MariaDB 10.3.0. Was Webserver betrifft, können Sie entweder Apache oder Nginx verwenden.

In diesem Abschnitt installieren Sie den LAMP-Stack (Apache, MariaDB und PHP), der verwendet wird, um Ihre MediaWiki-Installation auszuführen.

Zuerst aktualisieren Sie Ihr Debian-Repository mit dem folgenden Befehl.

sudo apt update

Sobald das Repository aktualisiert ist, installieren Sie die Abhängigkeiten des LAMP-Stacks mit dem folgenden Befehl. Geben Sie 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

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

Überprüfen Sie den Apache-Webserver mit dem folgenden Befehl. Wenn Sie die Ausgabe „enabled“ erhalten, bestätigt dies, dass Apache aktiviert ist und beim Start automatisch gestartet wird. Wenn er läuft, sehen Sie die Ausgabe „active (running)“.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Überprüfen Sie als Nächstes den MariaDB-Datenbankserver mit dem folgenden 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

Überprüfen Sie schließlich die PHP-Version und listen Sie die aktivierten Module mit dem folgenden Befehl auf. Sie werden die installierte PHP 8.2 auf Ihrem Debian-Server sehen.

php -v  
php -m

Konfigurieren von PHP

Nachdem Sie den LAMP-Stack installiert haben, konfigurieren Sie Ihre PHP-Installation, indem Sie die php.ini-Datei bearbeiten und einige Standardparameter für MediaWiki ändern.

Um PHP zu konfigurieren, öffnen Sie die PHP-Konfiguration /etc/php/8.2/apache2/php.ini mit dem folgenden Befehl im Nano-Editor.

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

Ändern Sie die Standardkonfiguration wie folgt und stellen Sie sicher, dass Sie sowohl date.timezone als auch memory_limit an Ihre aktuelle Umgebung anpassen.

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

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie nun den folgenden Befehl aus, um den Apache-Dienst neu zu starten und Ihre Änderungen anzuwenden.

sudo systemctl restart apache2

Konfigurieren des MariaDB-Servers

Nachdem PHP konfiguriert wurde, besteht der nächste Schritt darin, den MariaDB-Server zu sichern und eine neue Datenbank und einen Benutzer für MediaWiki zu erstellen. In diesem Beispiel sichern Sie den MariaDB-Server, indem Sie den Befehl mariadb-secure-installation verwenden und eine neue Datenbank und einen Benutzer über den MariaDB-Client erstellen.

Um die Installation des MariaDB-Servers zu sichern, führen Sie den folgenden Befehl aus.

sudo mariadb-secure-installation

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

• Die Standardinstallation von MariaDB kommt ohne Passwort. Drücken Sie ENTER, wenn Sie nach dem Passwort gefragt werden.
• Geben Sie nun Y ein, um das MariaDB-Root-Passwort festzulegen. Geben Sie dann das neue Passwort für MariaDB ein und wiederholen Sie das Passwort.
• Geben Sie Y ein, um den anonymen Benutzer aus Ihrer MariaDB-Installation zu entfernen.
• Geben Sie erneut Y ein, wenn Sie aufgefordert werden, die Remote-Anmeldung für den MariaDB-Root-Benutzer zu deaktivieren.
• Geben Sie Y ein, um die Standarddatenbank „test“ aus Ihrer MariaDB zu entfernen.
• Geben Sie schließlich Y ein, um die Tabellenberechtigungen neu zu laden und die neuen Änderungen anzuwenden.

Nachdem Sie die Bereitstellung des MariaDB-Servers gesichert haben, melden Sie sich mit dem folgenden Befehl beim MariaDB-Server an. Geben Sie Ihr MariaDB-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie nun die folgenden Abfragen aus, um eine neue MariaDB-Datenbank und einen Benutzer für MediaWiki zu erstellen. In diesem Beispiel erstellen Sie eine neue Datenbank mediawikidb, einen Benutzer mediawiki mit dem Passwort mediawikipassdb. Sie können die folgenden Angaben mit Ihren Anmeldeinformationen anpassen.

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

Führen Sie als Nächstes die folgende Abfrage aus, um die Berechtigungen des MariaDB-Benutzers mediawiki zu überprüfen. Stellen Sie sicher, dass der Benutzer mediawiki auf die Datenbank mediawikidb zugreifen kann.

SHOW GRANTS FOR mediawiki@localhost;

Geben Sie schließlich quit ein, um die MariaDB zu verlassen, wenn Sie fertig sind.

Herunterladen des MediaWiki-Quellcodes

Jetzt, da die Abhängigkeiten installiert und konfiguriert sind, können Sie MediaWiki installieren. Es gibt mehrere Versionen von MediaWiki: stabil, veraltet und LTS. In diesem Fall installieren Sie die neueste stabile Version von MediaWiki 1.41.

Wechseln Sie in das Verzeichnis /var/www und laden Sie den MediaWiki-Quellcode mit dem folgenden wget-Befehl herunter. Stellen Sie sicher, dass Sie die MediaWiki-Download-Seite besuchen, um die neueste Version zu erhalten.

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

Sobald der Download abgeschlossen ist, extrahieren Sie den Quellcode mit dem folgenden Befehl. Benennen Sie dann das extrahierte Verzeichnis in mediawiki um. Das DocumentRoot-Verzeichnis für MediaWiki befindet sich also unter /var/www/mediawiki.

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

Ändern Sie schließlich den Eigentümer des Verzeichnisses /var/www/mediawiki in den Benutzer www-data und ändern Sie die Berechtigung auf 0755.

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

Einrichten des Apache-Virtual Hosts

Jetzt, da Sie den MediaWiki-Quellcode heruntergeladen haben, erstellen Sie in diesem Abschnitt eine neue Apache-Virtual-Host-Datei, um MediaWiki auszuführen. Stellen Sie sicher, dass Sie über den Domainnamen verfügen, der auf Ihre Server-IP-Adresse verweist. Für die Produktion kaufen Sie die öffentliche Domain oder Sie können auch den lokalen Domainnamen verwenden.

Bevor Sie beginnen, aktivieren Sie das Apache-Rewrite-Modul mit dem folgenden Befehl.

sudo a2enmod rewrite

Erstellen Sie nun eine neue Apache-Virtual-Host-Konfiguration/etc/apache2/sites-available/mediawiki.conf mit dem folgenden Befehl im Nano-Editor.

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

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie die ServerName-Option mit Ihrem Domainnamen und den Pfad sowohl für Zugriffs- als auch für Fehlerprotokolle ändern.

  
  
 ServerName wiki.howtoforge.local  
  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/mediawiki  
  
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log  
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  

Speichern Sie die Datei und beenden Sie den Editor.

Aktivieren Sie als Nächstes die Virtual-Host-Datei mediawiki.conf und überprüfen Sie Ihre Apache-Syntax mit dem folgenden Befehl. Wenn Sie eine korrekte Apache-Syntax haben, sehen Sie eine Ausgabe wie Syntax OK.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

Starten Sie schließlich den Apache-Webserver neu, um den neuen Virtual Host für MediaWiki anzuwenden. Nach dem Neustart sollte Ihre MediaWiki-Installation bereit sein.

sudo systemctl restart apache2

Sicherung von MediaWiki mit HTTPS

Jetzt, da Sie eine Apache-Virtual-Host-Konfiguration für MediaWiki erstellt haben, sichern wir Ihre Installation mit HTTPS über Certbot und Letsencrypt. Dies gilt nur, wenn Sie die öffentliche Domain verwenden, aber wenn Sie die lokale Domain verwenden, können Sie selbstsignierte Zertifikate erstellen und HTTPS manuell anwenden.

Installieren Sie Certbot und das Certbot-Apache-Plugin mit dem folgenden Befehl. Geben Sie Y ein, um die Installation zu bestätigen.

sudo apt install certbot python3-certbot-apache

Sobald die Installation abgeschlossen ist, führen Sie den folgenden Certbot-Befehl aus, um SSL/TLS-Zertifikate für Ihren MediaWiki-Domainnamen zu generieren. Stellen Sie sicher, dass Sie den Domainnamen und die E-Mail-Adresse mit Ihren Informationen ändern.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

Nachdem der Vorgang abgeschlossen ist, ist Ihr Zertifikat im Verzeichnis /etc/letsencrypt/live/domain.com verfügbar, während Ihr Virtual Host auch mit HTTPS konfiguriert ist.

Installation von MediaWiki

Öffnen Sie Ihren bevorzugten Webbrowser und besuchen Sie Ihren Domainnamen, z. B. http://wiki.howtoforge.local/. Wenn alles gut geht, sollten Sie die Willkommensseite von MediaWiki sehen. Klicken Sie auf den Link Wiki einrichten.

Wählen Sie die Standardsprache für Ihr MediaWiki aus und klicken Sie auf Weiter.

Überprüfen Sie die Systemanforderungen, um sicherzustellen, dass Ihr System die Anforderungen von MediaWiki erfüllt. Klicken Sie dann erneut auf Weiter.

Wählen Sie die Datenbank als MariaDB aus und geben Sie Ihren Namen, Benutzer und Passwort ein. Klicken Sie dann auf Weiter, um fortzufahren.

Geben Sie als Nächstes Ihren Admin-Benutzernamen, Ihre E-Mail-Adresse und Ihr Passwort für MediaWiki ein, und klicken Sie dann auf Weiter.

Wählen Sie für zusätzliche Einstellungen das Standarddesign aus, das Sie verwenden möchten, und klicken Sie dann auf Weiter, um mit der Installation fortzufahren.

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

Sobald die Installation abgeschlossen ist, wird die Datei LocalSettings.php automatisch auf Ihren lokalen Computer heruntergeladen, und Sie sehen eine Anleitung, um die Datei in Ihr MediaWiki-Installationsverzeichnis hochzuladen.

Gehen Sie zurück zu Ihrem Terminal und führen Sie den folgenden Befehl aus, um eine neue Datei LocalSettings.php zu erstellen.

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

Öffnen Sie die Datei LocalSettings.php, die Sie heruntergeladen haben, und kopieren Sie den PHP-Code in Ihren Server. Speichern Sie dann die Datei und beenden Sie den Editor.

Gehen Sie zurück zu Ihrem Webbrowser und klicken Sie auf den Link Wiki betreten. Sie sollten die Standard-Startseite von MediaWiki sehen, die Sie installiert haben.

Fazit

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