MySQL容器启动必须设置MYSQL_ROOT_PASSWORD，否则因数据库未初始化且无密码选项而退出；常用组合包括该必需参数及MYSQL_DATABASE、MYSQL_USER/MYSQL_PASSWORD可选参数。
mysql 容器启动时必须设置的参数
不设 MYSQL_ROOT_PASSWORD，容器会直接退出并报错 error: database is uninitialized and password option is not specified。这是最常踩的坑——以为挂载了数据卷就能跳过密码初始化，其实 MySQL 8.0+ 镜像强制要求该环境变量。
其他关键必填项极少，但以下三个组合最常用：
-
MYSQL_ROOT_PASSWORD=your_secure_password（必需） -
MYSQL_DATABASE=myapp（可选，用于自动创建数据库） -
MYSQL_USER=appuser+MYSQL_PASSWORD=apppass（可选，自动建用户并赋读写权限到MYSQL_DATABASE）
挂载数据目录与配置文件的路径选择
Docker MySQL 官方镜像默认将数据存在 /var/lib/mysql，配置文件读取顺序是：/etc/my.cnf → /etc/mysql/my.cnf → /usr/etc/my.cnf → ~/.my.cnf。实际挂载时建议：
- 数据卷挂载到宿主机绝对路径，例如
-v /opt/mysql/data:/var/lib/mysql；避免用相对路径或命名卷（除非明确需要抽象层） - 自定义配置用
-v /opt/mysql/conf/my.cnf:/etc/mysql/my.cnf:ro，注意加:ro防止容器内误改 - 不要覆盖整个
/etc/mysql/目录——镜像自带的conf.d/下可能有字符集或插件启用逻辑
常见性能与兼容性相关参数
MySQL 容器默认使用 innodb_buffer_pool_size=128M，在 2GB 以上内存的宿主机上明显偏低。可通过 --sysctl 和 command 调整底层行为：
- 增大缓冲池：
docker run ... -e MYSQL_ROOT_PASSWORD=... --command="--innodb-buffer-pool-size=512M" - 禁用 DNS 反查（避免连接超时）：
--skip-name-resolve加在command末尾 - 调整最大连接数：
--max-connections=500（注意宿主机 ulimit 限制，需同步调高--ulimit nofile=65536:65536） - MySQL 8.0 默认用
caching_sha2_password插件，老客户端连不上时，加--default-authentication-plugin=mysql_native_password
网络与安全相关的典型命令组合
本地开发通常用 bridge 网络，但暴露端口和绑定地址容易出错：
- 别用
-p 3306（等价于-p 0.0.0.0:3306->3306），生产环境应限定监听地址：-p 127.0.0.1:3306:3306 - 容器间通信优先用自定义网络：
docker network create mynet，然后--network mynet启动，避免暴露端口 - 如果启用了
require_secure_transport=ON，客户端必须走 TLS，否则报错ERROR 3159 (HY000): Connections using insecure transport are prohibited
docker run -d \ --name mysql-dev \ --restart=unless-stopped \ --network mynet \ -v /opt/mysql/data:/var/lib/mysql \ -v /opt/mysql/conf/my.cnf:/etc/mysql/my.cnf:ro \ -e MYSQL_ROOT_PASSWORD=devpass123 \ -e MYSQL_DATABASE=blog \ -e MYSQL_USER=bloguser \ -e MYSQL_PASSWORD=blogpass \ --sysctl net.core.somaxconn=1024 \ -p 127.0.0.1:3306:3306 \ -m 1g \ mysql:8.0.33 \ --innodb-buffer-pool-size=384M \ --max-connections=200 \ --skip-name-resolve
配置里最容易被忽略的是 --sysctl 和 -m（内存限制）的配合：Docker 内存限制会触发 MySQL 的 innodb_buffer_pool_size 自动下调，但只发生在启动时；如果手动指定 buffer 大小超过限制，MySQL 会启动失败且日志里只显示“Aborted”，没具体原因。
