К содержимому

Настройка phpMyAdmin по http на Ubuntu 24.04

phpMyAdmin открывается по http через nginx и PHP-FPM. На Ubuntu 24.04 пакет phpmyadmin версии 5.2.1 не содержит готового конфига для nginx, поэтому location пишут вручную.

Руководство MySQL 2 мин чтения

01Проверьте, что nginx, PHP-FPM и MySQL установлены

На сервере уже должны работать nginx 1.24, PHP 8.3 и MySQL 8.0. Проверьте службы одной командой. Если чего-то нет, установите пакеты nginx, php8.3-fpm и mysql-server из репозитория Ubuntu.

bash
systemctl is-active nginx php8.3-fpm mysql

02Установите phpMyAdmin без Apache

Пакет phpmyadmin ставьте с --no-install-recommends, иначе по рекомендациям потянется Apache и libapache2-mod-php. Сам phpMyAdmin окажется в /usr/share/phpmyadmin, его конфиги в /etc/phpmyadmin/.

bash
sudo apt update
sudo apt install --no-install-recommends phpmyadmin

03Создайте отдельного пользователя MySQL для phpMyAdmin

Под root phpMyAdmin не войдёт: root@localhost входит через auth_socket, без пароля и только из консоли. Заведите пользователя с паролем и дайте ему права на нужные базы. FLUSH PRIVILEGES после CREATE USER и GRANT не нужен.

bash
sudo mysql -e "CREATE USER 'pma'@'localhost' IDENTIFIED BY 'StrongPassw0rd!';"
sudo mysql -e "GRANT ALL PRIVILEGES ON app.* TO 'pma'@'localhost';"

04Настройте nginx для phpMyAdmin

Создайте файл сайта в /etc/nginx/sites-available/ и включите его симлинком в /etc/nginx/sites-enabled/. В location / укажите root /usr/share/phpmyadmin и подключите PHP через сниппет и сокет php8.3-fpm. Заголовки, включая Cookie, nginx передаёт в PHP-FPM сам.

nginx
server {
    listen 80;
    server_name pma.example.com;

    root /usr/share/phpmyadmin;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

05Включите сайт и проверьте конфиг nginx

Симлинк включает сайт, sudo nginx -t проверяет все файлы конфига. reload применяет настройки без обрыва соединений, при ошибке nginx продолжает работать со старым конфигом.

bash
sudo ln -s /etc/nginx/sites-available/pma.example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

06Проверьте вход в phpMyAdmin по http

Откройте http://pma.example.com в браузере. Войдите пользователем pma с паролем, который задали. Если страница не открывается, смотрите /var/log/nginx/error.log и /var/log/php8.3-fpm.log.

bash
curl -I http://pma.example.com
sudo tail -n 20 /var/log/nginx/error.log

Частые ошибки

  • После sudo apt install phpmyadmin без --no-install-recommends на сервер ставится Apache и libapache2-mod-php. Это лишние пакеты, а готового конфига для nginx в пакете всё равно нет.

    Удалите Apache, если он не нужен: sudo apt remove apache2 libapache2-mod-php. Ставьте phpMyAdmin с --no-install-recommends и настраивайте nginx вручную.

  • Пользователю phpMyAdmin выдали GRANT ALL PRIVILEGES ON *.* WITH GRANT OPTION. Он получает полные права на весь сервер, включая управление пользователями.

    Выдавайте права только на нужные базы: GRANT ALL PRIVILEGES ON app.* TO 'pma'@'localhost';. Для чтения достаточно SELECT.

  • Вход под root в phpMyAdmin даёт ERROR 1698 (28000): Access denied for user 'root'@'localhost'.

    root@localhost входит через auth_socket только из консоли. Заведите отдельного пользователя с паролем и входите им.

  • nginx отдаёт 403 или File not found., в логе PHP-FPM Primary script unknown.

    Проверьте root в конфиге nginx и права на путь: namei -l /usr/share/phpmyadmin/index.php. Пользователь пула www-data должен иметь право чтения файла и входа в каждый каталог.

Deploykin

Как это делается в Deploykin

В Deploykin базы MySQL и пользователи создаются из панели, phpMyAdmin открывается в один клик. Бэкапы баз уходят по расписанию на ваше SFTP-хранилище, сжатыми и проверенными, а восстановление запускается из панели.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему phpMyAdmin не открывается по http?

Проверьте, что сайт включён симлинком в /etc/nginx/sites-enabled/, sudo nginx -t проходит без ошибок, а PHP-FPM запущен. Логи /var/log/nginx/error.log и /var/log/php8.3-fpm.log показывают причину.

Можно ли войти в phpMyAdmin под root?

Нет. root@localhost в MySQL 8 на Ubuntu входит через auth_socket, без пароля и только из консоли. Создайте отдельного пользователя с паролем и правами на нужные базы.

Нужен ли Apache для phpMyAdmin на Ubuntu 24.04?

Нет. Пакет ставится с --no-install-recommends, а nginx и PHP-FPM настраиваются вручную: готового конфига для nginx в пакете нет.

Где лежат файлы phpMyAdmin после установки?

Сам phpMyAdmin в /usr/share/phpmyadmin, конфиги в /etc/phpmyadmin/. В root конфига nginx указывают /usr/share/phpmyadmin.

Ещё по теме

MySQL на своём сервере: установка, настройка и типичные ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.