phpMyAdmin auf Ubuntu 24.04 installieren und absichern

phpMyAdmin ist ein webbasiertes Open-Source-Tool zur Verwaltung von MySQL-Datenbanken. Es stellt eine benutzerfreundliche Oberfläche bereit, mit der sich Datenbanken, Tabellen und Felder bequem erstellen, bearbeiten und löschen lassen. Darüber hinaus können Benutzerkonten verwaltet, Datenbanken importiert und exportiert sowie SQL-Abfragen ausgeführt werden. Dank der grafischen Weboberfläche ist keine Nutzung der Kommandozeile notwendig.

In dieser Anleitung erfährst du, wie du phpMyAdmin unter Ubuntu 24.04 installierst. Du lernst, MySQL-Datenbanken einzurichten und die phpMyAdmin-Oberfläche zu nutzen, um Benutzer und Datenbanken effizient zu verwalten.

Voraussetzungen

Stelle vor Beginn sicher, dass du:

• Zugriff auf ein Ubuntu 24.04-System mit einem Nicht-Root-Benutzer und sudo-Rechten hast.

MySQL-Server installieren und einrichten

Führe die folgenden Schritte aus, um den MySQL-Server zu installieren und eine Testdatenbank für phpMyAdmin vorzubereiten.

APT-Paketindex aktualisieren

Aktualisiere die Paketliste deines Systems mit folgendem Befehl:

$ sudo apt update

MySQL-Server installieren

Falls MySQL noch nicht installiert ist, kannst du es mit folgendem Befehl installieren:

$ sudo apt install mysql-server -y

MySQL-Shell öffnen

Melde dich in der MySQL-Kommandozeile an:

$ sudo mysql

Beispieldatenbank erstellen

Erstelle eine neue Datenbank mit dem Namen my_company:

mysql> CREATE DATABASE my_company;

Neuen Benutzer anlegen

Lege einen neuen Benutzer company_admin mit einem sicheren Passwort an. Ersetze your_password durch dein eigenes starkes Passwort:

mysql> CREATE USER 'company_admin'@'localhost' IDENTIFIED BY 'your_password';

Benutzerrechte vergeben

Gib dem Benutzer company_admin vollständigen Zugriff auf die my_company-Datenbank:

mysql> GRANT ALL PRIVILEGES ON my_company.* TO 'company_admin'@'localhost';

Rechte übernehmen

Aktualisiere die Berechtigungstabelle, damit die Änderungen wirksam werden:

mysql> FLUSH PRIVILEGES;

MySQL-Sitzung beenden

Verlasse die MySQL-Kommandozeile mit folgendem Befehl:

mysql> EXIT;

phpMyAdmin unter Ubuntu 24.04 installieren

phpMyAdmin ist in den offiziellen Paketquellen von Ubuntu 24.04 enthalten. Die folgenden Schritte zeigen dir, wie du die Installation mit dem APT-Paketmanager durchführst.

Paketliste aktualisieren

Aktualisiere die Liste der verfügbaren Pakete mit folgendem Befehl:

$ sudo apt update

PHP und notwendige Erweiterungen installieren

Installiere PHP zusammen mit allen für phpMyAdmin erforderlichen Erweiterungen:

$ sudo apt install php php-mysql php-mbstring php-json php-xml php-curl php-zip php-common -y

phpMyAdmin installieren

Installiere phpMyAdmin mit folgendem Befehl:

$ sudo apt install phpmyadmin -y

Hinweise zur Installation

Während der Installation wirst du aufgefordert, einige Optionen zu konfigurieren:

• Wähle apache2 aus, indem du Leertaste drückst und bestätige mit Enter.
• Wenn du gefragt wirst, ob die Datenbank mit dbconfig-common konfiguriert werden soll, bestätige mit Ja und drücke Enter.
• Vergib ein sicheres Passwort für phpMyAdmin und bestätige es durch zweimalige Eingabe.

Erfolg der Installation prüfen

Führe den folgenden Befehl aus, um zu überprüfen, ob phpMyAdmin korrekt installiert wurde:

$ dpkg -l | awk '/phpmyadmin / {print}'

Erwartete Ausgabe:

ii  phpmyadmin  4:5.2.1+dfsg-3  all  MySQL web administration tool

phpMyAdmin konfigurieren

Nach der Installation ist phpMyAdmin über die URL /phpmyadmin auf deinem Server erreichbar. Führe die folgenden Schritte aus, um sicherzustellen, dass die Apache-Konfiguration aktiviert ist und der Webserver korrekt läuft.

Apache-Konfiguration für phpMyAdmin aktivieren

Aktiviere die Konfigurationsdatei von phpMyAdmin mit diesem Befehl:

$ sudo a2enconf phpmyadmin.conf

Erwartete Ausgabe: Conf phpmyadmin already enabled

Apache neu starten

Starte den Apache-Webserver neu, damit die Änderungen übernommen werden:

$ sudo systemctl restart apache2

Status des Apache-Servers prüfen

Überprüfe, ob der Apache-Dienst aktiv ist:

$ sudo systemctl status apache2

Erwartete Ausgabe:

● apache2.service - The Apache HTTP Server
     Loaded: loaded (/usr/lib/systemd/system/apache2.service; enabled; preset: enabled)
     Active: active (running) since Wed 2025-02-19 14:03:08 UTC; 5min ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 84623 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
   Main PID: 74567 (apache2)
      Tasks: 6 (limit: 1061)

Firewall-Status mit UFW prüfen

Prüfe den aktuellen Status der Firewall:

$ sudo ufw status

UFW installieren und SSH freigeben (falls nötig)

Falls UFW noch nicht installiert ist, kannst du es mit folgendem Befehl installieren und SSH-Zugriff aktivieren:

$ sudo apt install ufw -y && sudo ufw allow ssh

HTTP- und HTTPS-Zugriff für Apache erlauben

Aktiviere den vollständigen Apache-Profilzugriff über die Firewall:

$ sudo ufw allow 'Apache Full'

Firewall-Konfiguration neu laden

Wende die Änderungen an der Firewall mit folgendem Befehl an:

$ sudo ufw reload

Zugriff auf phpMyAdmin unter Ubuntu 24.04

In diesem Abschnitt erfährst du, wie du auf die phpMyAdmin-Weboberfläche zugreifst und die zuvor erstellte my_company-Datenbank verwalten kannst.

phpMyAdmin im Browser aufrufen

Öffne einen Webbrowser (z. B. Chrome) und gib folgende Adresse ein – ersetze your_server_ip durch die IP-Adresse oder Domain deines Servers:

http://your_server_ip/phpmyadmin

Bei phpMyAdmin anmelden

Logge dich mit dem MySQL-Benutzer company_admin ein, den du zuvor eingerichtet hast.

Oberfläche prüfen und Datenbank öffnen

Stelle sicher, dass das phpMyAdmin-Dashboard korrekt angezeigt wird. Wähle in der linken Navigation die Datenbank my_company, um diese zu verwalten.

Wichtiger Sicherheitshinweis

Warnung: Vermeide es, dich mit dem MySQL-Root-Benutzer bei phpMyAdmin anzumelden. Dies kann zu versehentlichen Änderungen oder Sicherheitsproblemen führen. Verwende stattdessen immer dedizierte Benutzer mit gezielten Berechtigungen – das erhöht die Sicherheit und senkt das Risiko bei unbefugtem Zugriff.

phpMyAdmin-URL mit Zugriffsschutz absichern

Zur Absicherung der phpMyAdmin-Oberfläche kannst du eine einfache HTTP-Authentifizierung aktivieren. Dadurch wird ein zusätzlicher Login mit Benutzername und Passwort erforderlich.

.htpasswd-Datei anlegen

Erstelle eine neue .htpasswd-Datei mit Benutzername und Passwort deiner Wahl. Ersetze your_username z. B. mit smith und gib dann das Passwort ein:

$ sudo htpasswd -c /etc/phpmyadmin/.htpasswd your_username

Apache-Konfigurationsdatei bearbeiten

Öffne die Konfigurationsdatei von phpMyAdmin mit dem Nano-Editor:

$ sudo nano /etc/apache2/conf-available/phpmyadmin.conf

Füge innerhalb des /usr/share/phpmyadmin-Verzeichnisses die Direktive AllowOverride All ein.

Beispiel für einen Directory-Block:

<Directory /usr/share/phpmyadmin>
    AllowOverride All
    ...
</Directory>

.htaccess-Datei erstellen

Erstelle jetzt eine neue Datei namens .htaccess im Verzeichnis /usr/share/phpmyadmin/:

$ sudo nano /usr/share/phpmyadmin/.htaccess

Füge folgenden Inhalt in die .htaccess-Datei ein:

AuthType Basic
AuthName "Restricted Access to PhpMyAdmin"
AuthUserFile /etc/phpmyadmin/.htpasswd
Require valid-user

Erklärung der .htaccess-Konfiguration

• AuthType Basic: Legt die Authentifizierungsmethode auf "Basic" fest.
• AuthName "Restricted Access to PhpMyAdmin": Zeigt diesen Hinweis im Anmeldefenster an.
• AuthUserFile /etc/phpmyadmin/.htpasswd: Gibt den Pfad zur Datei mit Benutzern und Passwörtern an.
• Require valid-user: Lässt nur gültige Benutzer zu.

Apache neu starten

Starte Apache neu, damit die neuen Einstellungen übernommen werden:

$ sudo systemctl restart apache2

Zugriffsschutz überprüfen

Öffne erneut http://your_server_ip/phpmyadmin. Du solltest nun zur Eingabe von Benutzername und Passwort aufgefordert werden.

Nach erfolgreicher Anmeldung kannst du dich wie gewohnt mit deinem MySQL-Benutzerkonto einloggen und deine Datenbanken über die phpMyAdmin-Oberfläche verwalten.

phpMyAdmin unter Ubuntu 24.04: Fehlerbehebung

Falls bei der Nutzung von phpMyAdmin Probleme auftreten, helfen dir die folgenden Abschnitte dabei, gängige Fehler zu erkennen und zu beheben.

Probleme bei der Anmeldung

Prüfe zuerst, ob der MySQL-Dienst aktiv ist:

$ sudo systemctl status mysql

Überprüfe außerdem, ob du den richtigen MySQL-Benutzernamen und das passende Passwort verwendest.

Öffne die Konfigurationsdatei von phpMyAdmin und suche nach möglichen Fehlern:

$ sudo nano /etc/phpmyadmin/config.inc.php

Fehler "Internal Server Error"

Wenn du eine interne Serverfehlermeldung erhältst, prüfe das Apache-Fehlerprotokoll auf Details:

$ sudo tail -f /var/log/apache2/error.log

Stelle sicher, dass alle erforderlichen PHP-Erweiterungen installiert und aktiv sind:

$ sudo apt install php-mysql php-mbstring php-json php-xml php-curl php-zip php-common -y

Zugriff verweigert (Access Denied)

Melde dich an der MySQL-Konsole an, um Berechtigungsprobleme zu beheben:

$ sudo mysql

Erstelle einen neuen Benutzer mit gewünschtem Namen und Passwort:

mysql> CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';

Gib diesem Benutzer vollständige Rechte auf alle Datenbanken:

mysql> GRANT ALL PRIVILEGES ON *.* TO 'your_username'@'localhost' WITH GRANT OPTION;

Aktualisiere die Berechtigungen in MySQL mit folgendem Befehl:

mysql> FLUSH PRIVILEGES;

Verlasse die MySQL-Konsole und versuche erneut, dich bei phpMyAdmin anzumelden:

mysql> EXIT;

Fazit

Herzlichen Glückwunsch! Du hast phpMyAdmin erfolgreich auf Ubuntu 24.04 installiert. Das Tool bietet dir eine komfortable und leistungsfähige Weboberfläche zur Verwaltung von MySQL-Datenbanken. Du kannst jetzt Datenbanken verwalten, Daten einfügen, SQL-Abfragen ausführen und Berichte erstellen. Für weiterführende Konfigurationen und Tipps findest du Informationen in der offiziellen phpMyAdmin-Dokumentation.