Поиск
Справочник

Настройки MySQL и MariaDB: какой файл править и как применить

В Ubuntu настройки MySQL и MariaDB лежат в папке /etc/mysql/. Файл my.cnf только подключает другие файлы, а настройки сервера правят в mysqld.cnf у MySQL и в 50-server.cnf у MariaDB. После правки базу перезапускают.

≈ 9 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Узнайте, какая база стоит: readlink -f /etc/mysql/my.cnf. Ответ /etc/mysql/mysql.cnf — у вас MySQL, /etc/mysql/mariadb.cnf — MariaDB.
  3. Откройте файл настроек. MySQL: sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf. MariaDB: sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  4. Найдите нужную строку: нажмите Ctrl+W, напечатайте имя настройки и нажмите Enter. Если строка начинается со знака #, уберите # и впишите своё значение. Если строки нет, добавьте её на новой строке под строкой [mysqld].
  5. Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
  6. Перезапустите базу: sudo systemctl restart mysql для MySQL или sudo systemctl restart mariadb для MariaDB. Если команда ничего не ответила, база запустилась.
  7. Проверьте, что значение действует: sudo mysql -e "SHOW VARIABLES LIKE 'max_connections'". Вместо max_connections — имя своей настройки, для MariaDB вместо mysql — mariadb.

Если база не запустилась, верните строку как было, снова перезапустите базу и посмотрите причину в журнале: журнал ошибок MySQL и MariaDB.

Где какие файлы

ЧтоMySQLMariaDB
куда ведёт /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.logsudo journalctl -u mariadb
перезапускsudo systemctl restart mysqlsudo systemctl restart mariadb
консоль базыsudo mysqlsudo 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сколько подключений к базе одновременно151max_connections
slow_query_log, long_query_timeжурнал медленных запросоввыключен, порог 10 секунджурнал медленных запросов
character-set-serverкодировка новых базutf8mb4utf8mb4
log_errorкуда писать ошибки сервераMySQL — файл, MariaDB — журнал systemdжурнал ошибок
max_allowed_packetсамый большой запрос или строка таблицыMySQL — 64 МБ, MariaDB — 16 МБошибка 1153
bind-addressс каких адресов база принимает подключенияв Ubuntu — 127.0.0.1, только сам серверпорт 3306

Пользователи, права и базы

Эти вещи задают не в файле, а командами в консоли базы:

Ошибки и как их исправить

Что видитеПричинаЧто делать
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.

Источники

Сверено 23 октября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше