phpMyAdmin: «Временный ключ был автоматически сгенерирован для вас» — как задать blowfish_secret длиной 32 байта
После входа phpMyAdmin шифрует данные входа в cookie браузера. Для этого ему нужен секретный ключ — настройка blowfish_secret длиной ровно 32 байта. Если ключа нет или длина другая, phpMyAdmin показывает предупреждение на главной странице. Работать оно не мешает, но убрать его просто — ниже как.
Содержание 11
Что сделать прямо сейчас
- Прочитайте предупреждение: ключа нет или он короткий или он слишком длинный.
- Если phpMyAdmin ставили из пакета Ubuntu — проверьте файл ключа.
- Если ставили вручную — впишите ключ в config.inc.php.
Как выглядит предупреждение
Внизу главной страницы phpMyAdmin, после входа. По-английски:
The configuration file needs a valid key for cookie encryption. A temporary key was automatically generated for you. Please refer to the documentation.По-русски в этом предупреждении есть фраза «Временный ключ был автоматически сгенерирован для вас.»
Другое предупреждение — когда ключ слишком длинный:
The cookie encryption key in the configuration file is longer than necessary. It should only be 32 bytes long.Что такое blowfish_secret
$cfg['blowfish_secret'] — секретная строка, которой phpMyAdmin шифрует cookie с данными входа. Запоминать её не нужно, вводить тоже: phpMyAdmin читает её из файла настроек сам.
| Длина ключа | Что делает phpMyAdmin 5.2.1 |
|---|---|
| ровно 32 байта | шифрует этим ключом, предупреждения нет |
| меньше 32 байт или ключа нет | придумывает временный ключ на одну сессию и показывает предупреждение |
| больше 32 байт | берёт первые 32 байта и показывает предупреждение «longer than necessary» |
32 байта — это 32 латинские буквы, цифры или знака. Русская буква занимает 2 байта, поэтому в ключе только латиница и цифры.
С временным ключом вход работает. Но после закрытия браузера phpMyAdmin не сможет прочитать свою старую cookie и не подставит имя пользователя в окно входа.
Ключ в пакете Ubuntu
Пакет phpmyadmin из Ubuntu сам создаёт ключ из 32 символов при установке и хранит его в отдельном файле. Подключитесь к серверу по SSH (как) и проверьте его:
sudo ls -l /var/lib/phpmyadmin/blowfish_secret.inc.phpСмотрите начало строки ответа: должно быть -rw-r----- 1 root www-data.
| Что ответила команда | Что сделать |
|---|---|
права -rw-r-----, владелец root, группа www-data | файл в порядке — проверьте журнал |
группа не www-data | sudo chgrp www-data /var/lib/phpmyadmin/blowfish_secret.inc.php |
права не -rw-r----- | sudo chmod 640 /var/lib/phpmyadmin/blowfish_secret.inc.php |
| файла нет | создайте его |
PHP на сайте работает от пользователя www-data. Права 640 с группой www-data дают ему прочитать файл, а другим пользователям сервера — нет.
Что пишет журнал
Если PHP не смог прочитать файл ключа, пакет пишет об этом в журнал ошибок. Для nginx с PHP-FPM:
sudo grep 'phpmyadmin: Failed to load' /var/log/nginx/error.logДля Apache — /var/log/apache2/error.log вместо файла nginx. Строка из пакета заканчивается так: Check group www-data has read access and open_basedir restrictions. — проверьте, что у файла группа www-data, и что для phpMyAdmin не задан open_basedir, который закрывает папку /var/lib/phpmyadmin.
Если PHP-FPM для phpMyAdmin работает не от www-data, а от своего пользователя, этот пользователь не прочитает файл с правами 640. Подключайте phpMyAdmin через пул PHP-FPM по умолчанию — www, он работает от www-data.
Если файла ключа нет
Сделайте ключ из 32 символов:
openssl rand -hex 163fa19c07b2d84e6a915f0c3e7d2b48a1Команда выдаёт 32 символа из цифр и букв a–f — это и есть 32 байта. Создайте файл:
sudo nano /var/lib/phpmyadmin/blowfish_secret.inc.phpВпишите две строки — вместо примера свой ключ из команды выше, в одинарных кавычках:
<?php
$cfg['blowfish_secret'] = '3fa19c07b2d84e6a915f0c3e7d2b48a1';Сохраните: Ctrl+O, Enter, затем Ctrl+X. Задайте права:
sudo chgrp www-data /var/lib/phpmyadmin/blowfish_secret.inc.phpsudo chmod 640 /var/lib/phpmyadmin/blowfish_secret.inc.phpВыйдите из phpMyAdmin и войдите снова — предупреждение пропадёт.
Ключ при ручной установке
Если phpMyAdmin скачан архивом с сайта, ключ задаётся в файле config.inc.php в его папке. Если файла нет, сделайте его из примера config.sample.inc.php, который лежит там же:
sudo cp config.sample.inc.php config.inc.phpВ файле найдите строку $cfg['blowfish_secret'] = ''; и впишите между кавычками ключ из openssl rand -hex 16:
$cfg['blowfish_secret'] = '3fa19c07b2d84e6a915f0c3e7d2b48a1';Сохраните файл, выйдите из phpMyAdmin и войдите снова.
Ключ длиннее 32 байт
Предупреждение «longer than necessary» значит, что в ключе больше 32 байт. phpMyAdmin работает с первыми 32, но предупреждение будет показываться. Замените ключ новым из openssl rand -hex 16 — в том файле, где он задан. Найти этот файл:
sudo grep -rn blowfish_secret /etc/phpmyadmin/ /var/lib/phpmyadmin/Если в ключе есть русские буквы, он длиннее, чем кажется: каждая русская буква — 2 байта.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
The configuration file needs a valid key for cookie encryption. или «Временный ключ был автоматически сгенерирован для вас.» | ключа нет или он короче 32 байт | проверьте файл ключа |
в журнале phpmyadmin: Failed to load | PHP не может прочитать файл ключа | chgrp www-data и chmod 640 |
файла /var/lib/phpmyadmin/blowfish_secret.inc.php нет | его удалили | создайте заново |
The cookie encryption key in the configuration file is longer than necessary. | ключ длиннее 32 байт | замените ключ |
| имя пользователя не подставляется в окно входа | phpMyAdmin работает с временным ключом | задайте свой ключ из 32 символов |
Надписи сверены по исходному коду и русскому переводу phpMyAdmin 5.2.1, файл ключа — по скрипту установки и настройкам пакета phpmyadmin для Ubuntu 24.04.
Источники
- Документация phpMyAdmin: blowfish_secret — на английском: зачем ключ и какой длины.
- Исходный код phpMyAdmin 5.2.1 — на английском, с русским переводом в po/ru.po: проверка длины ключа и тексты предупреждений.
- Пакет phpmyadmin в Debian — на английском: файл blowfish_secret.inc.php и его права.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Установка phpMyAdmin на Ubuntuустановка из пакета и подключение к nginx.
- Время сессии истеклопочему phpMyAdmin выкидывает на страницу входа.
- Ошибки phpMyAdminвсе ошибки phpMyAdmin на одной странице.