Настройки MySQL и MariaDB: какой файл править и как применить
В Ubuntu настройки MySQL и MariaDB лежат в папке /etc/mysql/. Файл my.cnf только подключает другие файлы, а настройки сервера правят в mysqld.cnf у MySQL и в 50-server.cnf у MariaDB. После правки базу перезапускают.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Узнайте, какая база стоит:
readlink -f /etc/mysql/my.cnf. Ответ/etc/mysql/mysql.cnf— у вас MySQL,/etc/mysql/mariadb.cnf— MariaDB. - Откройте файл настроек. MySQL:
sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf. MariaDB:sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Найдите нужную строку: нажмите Ctrl+W, напечатайте имя настройки и нажмите Enter. Если строка начинается со знака
#, уберите#и впишите своё значение. Если строки нет, добавьте её на новой строке под строкой[mysqld]. - Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
- Перезапустите базу:
sudo systemctl restart mysqlдля MySQL илиsudo systemctl restart mariadbдля MariaDB. Если команда ничего не ответила, база запустилась. - Проверьте, что значение действует:
sudo mysql -e "SHOW VARIABLES LIKE 'max_connections'". Вместо max_connections — имя своей настройки, для MariaDB вместоmysql—mariadb.
Если база не запустилась, верните строку как было, снова перезапустите базу и посмотрите причину в журнале: журнал ошибок MySQL и MariaDB.
Где какие файлы
| Что | MySQL | MariaDB |
|---|---|---|
| куда ведёт /etc/mysql/my.cnf | /etc/mysql/mysql.cnf | /etc/mysql/mariadb.cnf |
| какие папки он подключает | conf.d/ и mysql.conf.d/ | conf.d/ и mariadb.conf.d/ |
| настройки сервера | /etc/mysql/mysql.conf.d/mysqld.cnf | /etc/mysql/mariadb.conf.d/50-server.cnf |
| журнал ошибок | /var/log/mysql/error.log | sudo journalctl -u mariadb |
| перезапуск | sudo systemctl restart mysql | sudo systemctl restart mariadb |
| консоль базы | sudo mysql | sudo mariadb |
Файл my.cnf в Ubuntu — ссылка. Главное в файле, на который она ведёт, — строки !includedir: они подключают все файлы .cnf из двух папок. Настройки сервера лежат в этих папках, поэтому править my.cnf не нужно — правьте файл из таблицы.
Как устроен файл
[mysqld]
# строка со знаком решётки не действует
# max_connections = 151
max_connections = 200
innodb_buffer_pool_size = 1G- Строка в квадратных скобках — раздел. Настройки сервера пишут в раздел
[mysqld]: всё, что стоит ниже него и до следующего раздела, читает сервер базы. - Одна строка — одна настройка: имя, знак
=и значение. - Размер памяти пишут с буквой:
K— килобайты,M— мегабайты,G— гигабайты. - Строка
# max_connections = 151со знаком#— подсказка из пакета. Пока перед ней стоит#, база её не читает. - Раздел
[mysql]в других файлах — это настройки программы-клиента mysql, а не сервера. Настройки сервера туда не пишите.
Какое значение действует
Если одна настройка записана несколько раз, действует последнее значение: база читает файлы по очереди, и каждая следующая строка заменяет предыдущую.
- MySQL. В каком порядке читаются файлы внутри одной папки, документация MySQL не обещает. Не заводите вторую копию настройки в соседнем файле — правьте строку в mysqld.cnf.
- MariaDB читает файлы одной папки по порядку имён: 60-my.cnf прочитается после 50-server.cnf, и его строки перебьют строки 50-server.cnf.
Что сервер использует прямо сейчас, показывает команда:
sudo mysql -e "SHOW VARIABLES LIKE 'max_connections'"+-----------------+-------+
| Variable_name | Value |
+-----------------+-------+
| max_connections | 151 |
+-----------------+-------+Не помните имя точно — поставьте знак %: он заменяет любые символы. Команда SHOW VARIABLES LIKE '%buffer_pool%'; в консоли базы покажет все настройки, в имени которых есть buffer_pool.
Как поменять без перезапуска
Команды ниже вводятся в консоли базы. Подключитесь к серверу по SSH (как подключиться) и войдите в консоль: sudo mysql для MySQL или sudo mariadb для MariaDB. Строка ввода сменится на mysql> или MariaDB [(none)]>. Каждая команда заканчивается точкой с запятой, выйти из консоли — exit.
Многие настройки меняются на ходу командой SET GLOBAL:
SET GLOBAL max_connections = 200;Значение действует сразу, но только до перезапуска базы. Потом снова будет то, что записано в файле. В SET GLOBAL буквы K, M и G не работают: размер пишут в байтах или выражением, например 1024*1024*1024 — это 1 ГБ.
Чтобы значение сохранилось и после перезапуска, в MySQL есть SET PERSIST. Она меняет значение сразу и записывает его в файл mysqld-auto.cnf в папке /var/lib/mysql/:
SET PERSIST max_connections = 200;MySQL читает mysqld-auto.cnf после всех остальных файлов, поэтому значение из него важнее строки в mysqld.cnf. Если вы правите mysqld.cnf, а значение не меняется, посмотрите, что сохранено через PERSIST:
SELECT * FROM performance_schema.persisted_variables;Убрать сохранённое значение — RESET PERSIST max_connections;. Текущее значение при этом не меняется, а после перезапуска снова действует строка из mysqld.cnf. Файл mysqld-auto.cnf руками не правьте.
В MariaDB значение, заданное через SET GLOBAL, после перезапуска пропадает. Чтобы оно сохранилось, впишите его в 50-server.cnf.
Главные настройки
| Настройка | Что задаёт | По умолчанию | Подробно |
|---|---|---|---|
innodb_buffer_pool_size | память под кэш таблиц и индексов | 128 МБ | innodb_buffer_pool_size |
max_connections | сколько подключений к базе одновременно | 151 | max_connections |
slow_query_log, long_query_time | журнал медленных запросов | выключен, порог 10 секунд | журнал медленных запросов |
character-set-server | кодировка новых баз | utf8mb4 | utf8mb4 |
log_error | куда писать ошибки сервера | MySQL — файл, MariaDB — журнал systemd | журнал ошибок |
max_allowed_packet | самый большой запрос или строка таблицы | MySQL — 64 МБ, MariaDB — 16 МБ | ошибка 1153 |
bind-address | с каких адресов база принимает подключения | в Ubuntu — 127.0.0.1, только сам сервер | порт 3306 |
Пользователи, права и базы
Эти вещи задают не в файле, а командами в консоли базы:
- Как создать пользователя — CREATE USER, DROP USER и список пользователей.
- Как выдать права — GRANT, REVOKE и SHOW GRANTS.
- Как сменить пароль — ALTER USER.
- Как создать и удалить базу — CREATE DATABASE и DROP DATABASE.
- Список баз и таблиц — SHOW DATABASES, SHOW TABLES и размер базы.
- mysqldump и как загрузить дамп — копия базы в файл и обратно.
- Резервные копии сайта — дамп базы через mysqldump, копия по расписанию и восстановление из неё.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
ERROR 1193 (HY000): Unknown system variable 'max_conection' | опечатка в имени настройки | проверьте имя через SHOW VARIABLES LIKE |
ERROR 1229 (HY000): Variable 'max_connections' is a GLOBAL variable and should be set with SET GLOBAL | пропущено слово GLOBAL | напишите SET GLOBAL |
ERROR 1238 (HY000): Variable 'port' is a read only variable | эту настройку нельзя менять на ходу | впишите её в файл и перезапустите базу |
| база не запустилась после правки файла | опечатка в имени или значении | верните строку и посмотрите журнал ошибок |
| значение не меняется | строку перебивает другой файл или PERSIST | проверьте persisted_variables и соседние файлы в папке |
Все разборы ошибок — в разделе Ошибки MySQL и MariaDB. Всё сверено с MySQL 8.0 и MariaDB 10.11 — эти версии ставятся в Ubuntu 24.04.
Источники
- Документация MySQL 8.0: Using Option Files — на английском: разделы, !includedir, правило последнего значения, mysqld-auto.cnf.
- Документация MySQL 8.0: Using Options to Set Program Variables — на английском: буквы K, M и G в файле и почему их нельзя писать в SET.
- Документация MySQL 8.0: SET Syntax for Variable Assignment — на английском: SET GLOBAL, SET PERSIST и PERSIST_ONLY.
- Документация MySQL 8.0: Persisted System Variables — на английском: файл mysqld-auto.cnf, RESET PERSIST и таблица persisted_variables.
- Документация MySQL 8.0: SHOW VARIABLES Statement — на английском: LIKE и знак %.
- Документация MariaDB: Configuring MariaDB with Option Files — на английском: порядок чтения файлов в папке и правило последнего значения.
- Файл mysql.cnf из пакета mysql-8.0 в Ubuntu 24.04 — строки !includedir для папок conf.d и mysql.conf.d.
- Файл mariadb.cnf из пакета mariadb в Ubuntu 24.04 — строки !includedir для папок conf.d и mariadb.conf.d.
- Файл mysqld.cnf из пакета mysql-8.0 в Ubuntu 24.04 — раздел [mysqld], bind-address, log_error и закомментированные подсказки.
- Файл 50-server.cnf из пакета mariadb в Ubuntu 24.04 — разделы [server] и [mysqld], bind-address, utf8mb4 и закомментированные подсказки.
- Исходный код MySQL 8.0.46: messages_to_clients.txt — номера и тексты ошибок сервера.
Сверено 23 октября 2026 года.
Что почитать дальше
- Как установить MySQL на Ubuntuустановка, вход и пользователь для сайта.
- Как установить MariaDB на Ubuntuто же для MariaDB.
- Сервер для базы данныхгде держать базу и сколько памяти ей отдать.
- Ошибки MySQL и MariaDBчто значат номера ошибок.
- Настройки PostgreSQLкакой файл править и как применить изменения.