2012 字
10 分钟
MySQL 安装与初始配置
2026-11-15

这篇解决什么问题#

从这一篇开始进入 MySQL 部分。目标很具体:把 MySQL 8.4 LTS 以正确的姿势跑起来——字符集不错、时区不错、关键参数不踩默认值坑,后面讲用户权限和命令实战时就不用再回头补课。

安装路线有两条:Docker Compose 和系统包安装。本系列整体推荐 Docker 路线(用 Docker 快速搭建三大数据库 里已经给过三合一的 Compose),这一篇会把 MySQL 单独拆开讲透,并补上系统包安装方式方便对照。选型还没想清楚的,先看 数据库怎么选。

路线一:Docker Compose 部署(推荐)#

目录结构与 Compose 文件:

Terminal window
mkdir -p ~/mysql8/{data,conf,logs} && cd ~/mysql8
docker-compose.yml
services:
mysql:
image: mysql:8.4
container_name: mysql8
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: "ChangeMe_2026!"
TZ: Asia/Shanghai
ports:
- "127.0.0.1:3306:3306"
volumes:
- ./data:/var/lib/mysql
- ./conf/my.cnf:/etc/mysql/conf.d/my.cnf:ro
- ./logs:/var/log/mysql
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_0900_ai_ci

自定义配置文件 conf/my.cnf:

[mysqld]
# 基础
character-set-server = utf8mb4
collation-server = utf8mb4_0900_ai_ci
default-time-zone = '+08:00'
max_connections = 300
wait_timeout = 28800
# InnoDB(内存按机器规格调整,下面按 4 GB 内存机器示例)
innodb_buffer_pool_size = 2G
innodb_log_file_size = 512M
innodb_flush_log_at_trx_commit = 1
sync_binlog = 1
# 日志:慢查询先开起来,下一篇优化全靠它
slow_query_log = 1
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 1
log_error = /var/log/mysql/error.log

启动并验证:

Terminal window
docker compose up -d
docker compose logs -f mysql # 看到 ready for connections 再继续
docker exec -it mysql8 mysql -uroot -p -e "SELECT VERSION(); SHOW VARIABLES LIKE 'character_set_server';"

路线二:系统包安装(Debian / Ubuntu)#

MySQL 官方 APT 仓库提供 8.4 LTS。简化流程如下:

Terminal window
# 安装官方仓库配置包后
sudo apt update
sudo apt install -y mysql-server
sudo systemctl enable --now mysql
sudo mysql_secure_installation

mysql_secure_installation 会引导设置 root 密码强度策略、删除匿名用户、禁止 root 远程登录、删除 test 库,这一步不要跳过,它是裸装 MySQL 最重要的安全动作。系统包方式的配置文件在 /etc/mysql/mysql.conf.d/mysqld.cnf,参数名与上面 my.cnf 完全通用。

两条路线对比:

维度Docker Compose系统包安装
环境隔离好,版本切换靠换镜像 tag与系统耦合,升级走 APT
数据目录宿主机挂载目录,直观可控/var/lib/mysql
配置位置项目内 conf/my.cnf/etc/mysql/
适合场景个人服务器、多实例、快速试错长期单实例、习惯 systemd 管理
备份迁移打包目录即可搬走需配合 mysqldump 或停机拷数据

初始配置的四个必查项#

1. 字符集必须是 utf8mb4#

MySQL 历史上的 utf8 是残缺版(每字符最多 3 字节),存不下 emoji 和部分生僻字。新装实例一律 utf8mb4,排序规则用 utf8mb4_0900_ai_ci(8.x 默认)或需要区分大小写时用 utf8mb4_bin。验证:

SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';

建库时也显式写明,别依赖默认值漂移:

CREATE DATABASE appdb CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

2. 时区显式设为 +08:00#

TIMESTAMP 类型会按时区转换存储与显示,时区不一致是「时间差了 8 小时」类 Bug 的头号来源。Docker 方式已通过环境变量和 my.cnf 双保险;系统包安装记得在 my.cnf 写 default-time-zone = '+08:00',并确认系统时区正确:

SELECT @@global.time_zone, @@session.time_zone, NOW();

3. InnoDB 缓冲池按内存给#

innodb_buffer_pool_size 是 MySQL 最重要的性能参数,决定多少热数据能留在内存里。经验值:专职数据库机器给物理内存的 50%–70%,与其它服务混跑时保守些。给太小查询全走磁盘,给太大则可能触发 OOM。修改后需重启生效(8.0 起部分场景支持在线调整,但重启最稳妥)。

4. root 账号只用于初始化#

官方镜像首次启动时用环境变量里的密码初始化 root。初始化完成后,第一件事应该是创建业务账号和管理员账号,root 只留作应急。账号体系与授权方法在下一篇 MySQL 用户权限与安全管理 专门讲,这里先记住原则:不要用 root 账号跑业务程序,更不要把 root 开放到公网远程登录。

WARNING

Docker 部署时端口绑定务必注意:ports 写成 "3306:3306" 等于对所有网卡开放,配合弱密码很容易被扫描爆破。本文示例绑定 127.0.0.1:3306 只允许本机访问,需要远程连接时优先走 SSH 隧道或内网,不要图省事直接把 3306 暴露到公网。

常用参数速览:知道每个参数在管什么#

上面 my.cnf 里出现的参数只是起步集,这里把日常最常打交道的参数汇成一张表,调优时对照着看:

参数默认值(8.4)作用调整建议
max_connections151允许的最大并发连接数按应用连接池总量留 20% 余量,不是越大越好,每个连接都占内存
innodb_buffer_pool_size128MInnoDB 数据与索引的缓存区默认值小得离谱,装完第一件事就是按内存改大
innodb_log_file_size48MRedo 日志单个文件大小写密集型可调到 512M–1G,减少刷盘频率
max_allowed_packet64M单个数据包最大大小导入大 SQL 文件或存大字段时报包过大,就是调它
wait_timeout28800 秒非交互连接的空闲断开时间连接池场景可适当调小,避免僵尸连接占坑
slow_query_logOFF慢查询日志开关生产必须开,阈值起步设 1 秒
binlog_expire_logs_seconds2592000(30 天)binlog 自动过期时间磁盘紧张时调小,但要先确认备份与主从不再需要老日志
character_set_serverutf8mb4服务端默认字符集8.x 默认已是 utf8mb4,老实例升级来的要专门确认

查参数当前值与来源的命令:

-- 看某个参数现在是多少
SHOW GLOBAL VARIABLES LIKE 'innodb_buffer_pool_size';
-- 看某个参数是在哪个配置文件里定义的(Performance Schema,8.0+)
SELECT VARIABLE_NAME, VARIABLE_SOURCE, SET_TIME
FROM performance_schema.variables_info
WHERE VARIABLE_NAME IN ('max_connections', 'innodb_buffer_pool_size');

VARIABLE_SOURCE 会告诉你值来自编译默认(COMPILED)、配置文件(FILE)还是运行时动态修改(DYNAMIC),排「改了配置没生效」类问题时特别好用。

连接与健康检查#

Terminal window
# 宿主机装了客户端时
mysql -h 127.0.0.1 -P 3306 -uroot -p
# 没装客户端就借容器内的
docker exec -it mysql8 mysql -uroot -p

连上后跑一轮体检 SQL:

SHOW VARIABLES LIKE 'max_connections';
SHOW VARIABLES LIKE 'innodb_buffer_pool_size';
SHOW STATUS LIKE 'Threads_connected';
SHOW ENGINE INNODB STATUS\G

最后一段 SHOW ENGINE INNODB STATUS 输出很长,重点看有没有死锁记录和异常等待,日常排障时是重要线索。

常见问题#

Q:容器反复重启,日志报 Table 'mysql.plugin' doesn't exist 或数据目录权限错误? 多半是 data 目录曾经被其它版本或空目录污染。确认目录里没有要保留的数据后清空重新初始化;另外宿主机目录属主问题在官方镜像里一般会自动处理(容器内以 mysql 用户运行),不要手动乱改属主。

Q:改了 my.cnf 没生效? 先确认挂载路径对不对:官方镜像读取 /etc/mysql/conf.d/ 和 /etc/mysql/mysql.conf.d/ 下的配置。用 docker exec mysql8 mysqld --verbose --help | grep -A1 'Default options' 查看它实际读取的配置文件列表。

Q:Access denied for user 'root' 本地都登不上? Docker 方式先确认连的是不是刚初始化的那个实例、密码是否与环境变量一致。注意:MYSQL_ROOT_PASSWORD 只在数据目录为空、首次初始化时生效,事后改环境变量不会修改已有密码,改密码要用 SQL:

ALTER USER 'root'@'localhost' IDENTIFIED BY 'NewStrongPass_2026!';

Q:内存只有 1–2 GB 的小机器参数怎么调? innodb_buffer_pool_size 给 256M–512M,max_connections 降到 100 以内,并关掉不用的功能如 Performance Schema 的部分消费者。小机器能跑稳比参数好看重要。

小结#

  • 推荐 Docker Compose 部署 MySQL 8.4,配置、数据、日志都落在项目目录里,可控可迁移。
  • 初始配置四件套:utf8mb4 字符集、+08:00 时区、合理大小的 InnoDB 缓冲池、root 只作初始化。
  • 安全底线:跑 mysql_secure_installation(系统包)或等效处理,3306 不裸奔公网。

环境就绪,下一篇给它上锁:MySQL 用户权限与安全管理;日常操作命令则在 MySQL 常用命令与操作实战 里系统梳理。

MySQL 安装与初始配置
https://www.anexns.cloudns.org/posts/mysql-install-config/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0