Docker部署MySQL实战：安装配置与SQL操作全流程

在日常开发里MySQL 的安装和配置说难不难但说简单也真不简单。尤其当你需要在多台机器、多个环境里来回切换或者想快速验证一个业务逻辑、跑一份测试数据时那种装半天、配半天、最后还出各种幺蛾子的体验我相信很多人都经历过。后来我把 MySQL 的部署整体迁到了 Docker 容器里用了一段时间之后最大的感受就是这件事终于可以标准化了。这篇文章就是基于我自己的实操经验从零开始梳理一遍在 Docker 下完成 MySQL 安装、启动、配置以及进入容器执行 SQL 查询的完整流程。无论你是刚接触 Docker 的新手还是已经用了一段时间但没仔细折腾过 MySQL 的同学看完之后应该都能自己动手跑起来。1. 内容整体设计与思路拆解1.1 为什么要用 Docker 跑 MySQL先把一个最基础的问题说清楚既然直接在操作系统里装 MySQL 也挺方便的为什么还要用 Docker 来跑我自己的体会是Docker 化部署最大的优势在于隔离和一致。所谓隔离是指 MySQL 运行在容器里它的文件、配置、端口都可以和宿主机分开管理。你不需要担心 MySQL 的安装包污染了系统目录也不用担心卸载的时候留下一堆残留文件。所谓一致是指你在自己电脑上构建的 MySQL 容器环境和同事电脑上、测试服务器上、甚至生产环境上的 MySQL 容器环境几乎可以做到完全一致。Docker 镜像本身就是一种环境快照它把 MySQL 的版本、依赖库、默认配置统统打包在一起任何人拉取同一个镜像跑起来就是同一个环境。从实际体验来看Docker 跑 MySQL 还有一个隐藏优势快速重置。我之前在本地直接安装 MySQL 时如果配置乱了或者忘记 root 密码往往要折腾很久才能恢复。用 Docker 之后最暴力的修复方案就是删掉容器重新跑一个整个过程用不了两分钟数据只要挂载在数据卷里也完全不会丢。当然Docker 跑 MySQL 也不是没有缺点比如性能上会有轻微损耗但在开发环境和测试环境下这种损耗基本感知不到。对绝大多数个人项目和中小团队来说Docker 化部署的收益远大于成本。1.2 方案选型镜像、容器、数据卷怎么配合在动手之前我建议先想清楚整体方案避免后面反复返工。我常用的组合就三样东西MySQL 官方镜像、Docker 数据卷volume、以及一个自定义配置文件。镜像优先选择官方镜像mysql版本号建议明确指定不要直接用latest。原因很简单latest会随着时间变化今天拉下来的可能是 8.0过半年再拉就是 8.4 了版本不一致带来的配置差异很容易坑到你。我一般固定用mysql:8.0这个版本足够稳定资料也最多。数据卷MySQL 容器本身是无状态的容器删掉之后里面的数据也跟着没了。所以必须把 MySQL 的数据目录挂载到宿主机或者 Docker 数据卷里。我推荐使用 Docker 数据卷docker volume因为它的读写性能比直接挂载宿主机目录更好而且跨平台兼容性更好不需要关心路径写法差异。配置文件容器里的 MySQL 默认配置一般够用但当你需要调整字符集、时区、最大连接数等参数时就需要把宿主机上的配置文件挂载进容器。这个后面我会详细讲。我的推荐方案是官方镜像 具名数据卷 自定义配置文件挂载。这套组合既简单又灵活适合绝大多数场景。2. 环境准备与镜像拉取2.1 检查 Docker 环境是否就绪在拉取 MySQL 镜像之前先确认 Docker 已经正确安装并且能正常运行。这一步非常简单但很多人会忽略导致后面报各种奇怪的错误。打开终端依次执行docker version docker psdocker version会显示 Docker 客户端和服务端的版本信息。如果你看到Client和Server两段内容都有具体的版本号说明 Docker 守护进程正在运行。如果只有 Client 信息Server 部分报错或者显示Cannot connect to the Docker daemon说明 Docker 服务没有启动你需要先启动 Docker。docker ps的作用是列出当前正在运行的容器。第一次执行时如果输出一个空表格没有任何报错那说明 Docker 环境就是正常的。如果你用的是 Docker DesktopWindows 或 macOS还要注意一点Docker Desktop 需要手动启动启动之后右下角Linux 的桌面发行版一般是托盘图标会显示 Docker 图标。等图标状态变为稳定后再执行上面的命令。提示在 Linux 环境下如果你的用户不在docker用户组里执行docker ps可能会遇到权限报错。解决办法是执行sudo usermod -aG docker $USER然后重新登录终端会话。2.2 拉取合适的 MySQL 镜像环境没问题之后就可以拉取 MySQL 官方镜像了。这里我再说一遍不要直接拉latest而是指定具体的版本号docker pull mysql:8.0执行过程中Docker 会从镜像仓库下载 MySQL 8.0 的镜像分层。下载完成后你可以通过docker images来确认镜像是否已经存在输出中应该能看到mysql这一行TAG 是8.0。关于版本选择我再多解释一句。MySQL 8.0 是目前最主流的版本它在性能、安全性和功能上都比 5.7 有大幅提升比如支持窗口函数、CTE公用表表达式、默认字符集utf8mb4等。很多云数据库服务商也早已全面转向 8.x。所以新项目直接选择 8.0 是完全没有问题的。如果你的项目比较特殊必须用 5.7把命令里的版本号改成5.7即可下面的流程基本一样。拉取镜像还有一个考虑因素网络。如果你在拉取镜像时速度很慢或者超时可以配置 Docker 的镜像加速器。这个配置在不同的 Docker 版本和操作系统上略有差异但基本原理都是在 Docker 的配置文件里增加registry-mirrors字段。具体操作可以查阅 Docker 对应平台的文档这里就不再赘述了。3. 创建并启动 MySQL 容器3.1 规划容器参数端口、数据卷、密码、配置镜像拉取好了下一步就是创建容器。这一步是整个流程的核心参数规划是否合理直接影响后续使用的便利性和数据安全性。我先给出一个生产环境更可用的完整命令然后逐个参数解释。以端口 3306、root 密码MyRoot123456、数据卷mysql-data、配置文件挂载为例docker run -d \ --name mysql-test \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORDMyRoot123456 \ -e TZAsia/Shanghai \ -v mysql-data:/var/lib/mysql \ -v /etc/mysql/conf.d:/etc/mysql/conf.d \ --restartalways \ mysql:8.0下面把每个参数拆开来看-d后台运行容器终端不会卡在前台输出日志。--name mysql-test给容器起一个名字。这个名字在你执行docker exec、docker logs、docker stop等命令时都会用到建议起一个便于识别的名字。-p 3306:3306端口映射。冒号左边是宿主机端口右边是容器内 MySQL 监听的端口。通过这个映射宿主机上的任何程序都可以通过127.0.0.1:3306来访问容器内的 MySQL。如果你本机已经有一个 MySQL 占用了 3306 端口可以把左边改成 3307比如-p 3307:3306。-e MYSQL_ROOT_PASSWORDMyRoot123456设置 MySQL root 用户的初始密码。这是官方镜像提供的一个环境变量在容器首次初始化数据目录时生效。-e TZAsia/Shanghai设置容器内时区为北京时间。这个参数很容易被忽略但不设置的话MySQL 的时间函数比如NOW()返回的时间会与北京时间相差 8 小时。对于国内开发者来说这个参数建议一定加上。-v mysql-data:/var/lib/mysql把具名数据卷mysql-data挂载到容器内的数据目录。这样 MySQL 的所有数据文件、日志文件都保存在这个数据卷里即使容器被删除数据也不会丢失。下次重新创建容器时只要挂载同一个数据卷数据就还在。-v /etc/mysql/conf.d:/etc/mysql/conf.d把宿主机的目录挂载到容器内的配置目录。MySQL 官方镜像默认会加载/etc/mysql/conf.d目录下所有.cnf结尾的配置文件。你可以把自定义配置放到这个目录里实现配置的灵活调整。--restartalways设置 Docker 守护进程启动时自动拉起这个容器。这个参数在服务器环境特别重要可以避免服务器重启后 MySQL 容器没有自动恢复从而减少故障时间。注意~/mysql/conf:/etc/mysql/conf.d这种写法是宿主机绝对路径加冒号加容器内路径。路径可能因人而异你在实际使用中根据自己的目录结构调整。3.2 启动容器与初始化日志观察命令敲回车之后Docker 会基于镜像创建一个容器并启动。启动过程很快但 MySQL 容器的首次初始化需要一点时间因为官方镜像在首次运行时需要执行一系列初始化操作包括创建数据目录、初始化系统表、设置 root 密码等。你可以用下面的命令来实时查看容器日志docker logs -f mysql-test看到日志中出现类似ready for connections的提示就说明 MySQL 已经初始化完成可以接受连接了。这里我特别提醒一句很多人执行完docker run之后立刻就用客户端去连 MySQL结果报Cant connect to MySQL server其实不是配置的问题而是容器还在初始化中连接请求被拒绝了。耐心等几秒钟再看一下日志一般就正常了。容器启动之后你可以用docker ps查看容器状态。STATUS列显示Up就代表运行中。如果你想确认端口映射是否生效docker ps里还会显示类似0.0.0.0:3306-3306/tcp的信息这就是端口映射的直观表现。3.3 配置文件的挂载与基础参数调整MySQL 在容器里跑起来之后你可能还想调整一些参数比如max_connections、character-set-server、collation-server等。这些参数在默认配置下可能不是最优的尤其是你打算把容器作为团队共用的开发数据库时调整一下还是很有必要的。我的习惯是先在宿主机上建立一个配置目录比如~/mysql/conf然后在里面创建一个名为my.cnf的配置文件。这个文件的内容可以覆盖默认配置例如[mysqld] character-set-serverutf8mb4 collation-serverutf8mb4_unicode_ci max_connections500 default-time-zone08:00创建好之后在docker run命令中加上-v ~/mysql/conf:/etc/mysql/conf.d挂载参数或者如果容器已经跑了则需要重新创建容器来应用配置。关于重新创建容器的操作我放到后面的常见问题部分再具体讲。这里有个容易踩坑的地方挂载目录里的配置文件有多个时MySQL 的加载顺序可能会影响最终生效的配置值。在官方镜像中/etc/mysql/目录下的配置加载顺序一般是my.cnf里依次!includedir各个目录越靠后的配置优先级越高。为了简单起见我建议在自定义配置文件里只写你确定要覆盖的项不要试图复制官方的一份完整配置再修改否则容易覆盖掉镜像里一些必要的初始化设置。简洁、精准是容器化配置的正确姿势。4. 进入容器执行 SQL 与基础配置验证4.1 使用 docker exec 进入容器内部容器跑起来了接下来最常用的操作就是进入容器内部通过 MySQL 自带的命令行工具来执行 SQL。这里用到的核心命令是docker exec。交互式进入容器的命令如下docker exec -it mysql-test bash这条命令的意思是在mysql-test这个容器里执行bash命令-it参数表示以交互模式运行这样你可以直接获得一个容器内的 shell 终端。进入之后你就好像登录了一台安装了 MySQL 的 Linux 机器。执行ls /var/lib/mysql就能看到数据目录里的文件执行cat /etc/os-release可以查看容器使用的操作系统版本。有了 shell接下来就可以用 MySQL 客户端连接本机 MySQL 服务。注意这时候是在容器内部所以主机名写localhost或127.0.0.1都是可以的端口是 3306mysql -uroot -p输入之前设置的 root 密码MyRoot123456就能进入 MySQL 的命令行界面。看到mysql提示符后你就拥有了一个交互式 SQL 执行环境。4.2 不进入容器直接执行 SQL 查询使用docker exec进入容器再执行 SQL适合做管理操作。但如果你只是临时想查询一下数据、执行一条 DDL完全可以不用进入容器直接在宿主机上通过docker exec把 SQL 传给容器内的 mysql 客户端一条命令搞定docker exec -it mysql-test mysql -uroot -p注意这里-it仍然保留因为要交互式输入密码。你也可以把密码直接写在命令里适合在脚本中自动化执行docker exec -it mysql-test mysql -uroot -pMyRoot123456更进一步如果你想直接执行一段 SQL 而不进入交互式终端可以用-e参数docker exec -it mysql-test mysql -uroot -pMyRoot123456 -e SELECT VERSION(); SELECT NOW(); SHOW DATABASES;这条命令会依次执行括号里的三条 SQL输出结果后自动退出。在执行多条 SQL 时用分号分隔即可。这个方式我在写自动化脚本时非常常用比如批量巡检 MySQL 状态、定时备份数据等场景都是这么干的。4.3 SQL 查询实战建库、建表、插入与查询结合前面的命令我现在用一套完整的流程演示一下从建库到查询数据把常用操作全部过一遍。以下操作既可以在容器内的mysql提示符下逐条执行也可以使用docker exec加-e参数执行。我建议初学阶段先在交互式界面里敲一遍感受一下反馈。第一步查看当前所有数据库SHOW DATABASES;默认会有information_schema、mysql、performance_schema、sys这四个系统数据库这些不要动。第二步创建业务数据库CREATE DATABASE IF NOT EXISTS test_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;这里我显式指定了字符集和排序规则这是推荐的做法避免 MySQL 默认配置有问题导致之后出现中文乱码。第三步使用这个库并建表USE test_db; CREATE TABLE IF NOT EXISTS user ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL, email VARCHAR(100) UNIQUE, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;表结构定义得很简单但足以说明问题了。ENGINEInnoDB是 MySQL 8.0 的默认引擎支持事务和行级锁一般不需要特别指定不过写出来也算一种防御性习惯。第四步插入几条测试数据INSERT INTO user (name, email) VALUES (张三, zhangsanexample.com); INSERT INTO user (name, email) VALUES (李四, lisiexample.com); INSERT INTO user (name, email) VALUES (王五, wangwuexample.com);第五步查询数据SELECT * FROM user;输出结果应该能看到三行记录。到这里一个完整的建库-建表-写数据-查数据流程就走通了。4.4 验证字符集、时区与远程连接刚部署好 MySQL我建议顺手验证三件事字符集、时区、远程连接。这三项如果没弄对后面使用中很容易出现一些比较隐蔽的问题。字符集验证执行SHOW VARIABLES LIKE character_set%;重点关注character_set_server和character_set_database正常应该是utf8mb4。如果你发现是latin1或其他值那么创建数据库时最好显式指定字符集避免上层建表时默认继承了一个不规范的值。时区验证执行SELECT NOW();如果输出是北京时间说明时区设置生效了。如果你看到的是 UTC 时间需要检查容器启动时的TZ环境变量或者在 MySQL 里执行SET GLOBAL time_zone 08:00;来临时修改重启失效。远程连接验证这个稍微复杂一点。默认情况下MySQL 8.0 的 root 用户只允许从 localhost 登录通过宿主机映射端口从外部连接会通不过。这个限制是安全设计是为了避免 root 账密泄露后任何机器都能直接连上。在开发或者测试环境如果确实需要远程连建议专门创建一个新用户并授权比如CREATE USER devuser% IDENTIFIED BY DevPassword123; GRANT ALL PRIVILEGES ON test_db.* TO devuser%; FLUSH PRIVILEGES;devuser%中的%表示允许从任意 IP 连接test_db.*表示只授予这个库的所有权限。这是相对安全的做法。创建好之后就可以从宿主机上用mysql -h127.0.0.1 -P3306 -udevuser -p来测试连接了。5. 常见问题与排查技巧实录5.1 容器启动失败或反复重启遇到容器起不来第一步永远是看日志docker logs mysql-test常见的失败原因有这么几类第一类是端口冲突。宿主机上的 3306 已经被其他 MySQL 实例占用Docker 会报端口 bind 失败。解决办法是停掉旧服务或者换一个宿主机端口。第二类是数据目录冲突。如果你之前用同一个数据卷启动过一个不同版本的 MySQL新容器就可能因为数据版本不一致而初始化失败。这个坑我踩过解决办法是删除旧的数据卷重新初始化或者把数据卷备份后再创建。第三类是配置文件的权限问题。MySQL 容器内的 mysqld 进程对配置文件有严格的权限要求如果挂载进去的配置目录或配置文件名不对mysqld 会直接拒绝使用。比如文件名必须以.cnf结尾目录里的文件不能有所有者和权限过于宽松的设置。如果遇到奇怪的初始化失败可以考虑把挂载目录暂时去掉用最简参数先跑起来再逐步加回配置。5.2 忘记 root 密码或密码不生效开发环境经常会遇到密码搞不清的情况Docker 化之后解决起来反而更简单。思路是先停掉容器然后临时跳过权限验证启动一个临时实例在里面重置 root 密码再恢复。具体步骤首先停掉 MySQL 容器docker stop mysql-test然后手动启动一个临时容器挂载同一个数据卷但把启动命令改成跳过权限验证docker run -d --name mysql-reset \ --entrypoint mysqld \ -v mysql-data:/var/lib/mysql \ mysql:8.0 \ --skip-grant-tables这个临时容器启动后进入它并执行修改密码的操作docker exec -it mysql-reset mysql -uroot在 MySQL 提示符下先刷新权限然后改密码。8.0 版本的密码字段在mysql.user表里叫authentication_stringFLUSH PRIVILEGES; ALTER USER root% IDENTIFIED BY NewPassword123; FLUSH PRIVILEGES;修改完成后退出并删除临时容器再重新启动原来的mysql-test容器docker rm -f mysql-reset docker start mysql-test这个流程基本覆盖了绝大多数忘记密码的场景。核心逻辑就是利用同名数据卷挂载让密密码重置在同一份数据上生效。提示重置密码时如果root用户只有一个rootlocalhost没有root%你需要先确认实际存在的账号名可以执行SELECT user, host FROM mysql.user;查看后再修改。5.3 修改配置后如何平滑生效很多人在容器跑起来之后才发现要调配置这时候就涉及要不要重建容器的问题。理想状态下MySQL 的大部分配置可以动态修改即使用SET GLOBAL语句但这只能临时生效容器重启后就会丢失。要让配置永久生效更规范的做法是改挂在宿主机上的配置文件然后重启容器。注意docker restart mysql-test只是重启容器不会重新读取挂载目录里的文件吗实际上会但前提是配置文件本身有修改。这个流程是有个前提的你在创建容器时已经挂载了配置目录。如果没有挂载那就只能把配置文件docker cp进容器里再重启。不过这样做的话配置就写在容器可写层了docker rm重建后配置会丢失所以不推荐。最推荐的方案是创建容器时一定把配置目录挂载出来。之后凡是需要调整 MySQL 参数直接编辑宿主机上的my.cnf然后执行docker restart mysql-test。我实测过这种方式的生效非常可靠而且配置变更全程可追溯配合 Git 管理配置文件非常舒服。5.4 数据备份与恢复的简单方案容器化之后数据备份依然不能省。好在用数据卷的话备份也很直接。最原始也最可靠的方式是将容器里的 SQL 导出到宿主机docker exec mysql-test mysqldump -uroot -pMyRoot123456 --all-databases backup.sql恢复就更简单了把备份文件导入容器docker exec -i mysql-test mysql -uroot -pMyRoot123456 backup.sql注意恢复命令里用的是-i而不是-it因为在重定向输入时不能分配交互式终端这个细节很容易踩坑。这套方式对于开发环境来说已经足够了。如果你到了生产环境建议再用专业的备份工具、自动定时备份脚本甚至结合云厂商的备份服务。但无论怎样掌握容器里的mysqldump用法是每个用 Docker 跑 MySQL 的开发者都应该会的基本功。我的几点实操感受整套流程用顺了之后我的感觉是Docker 改变的不只是部署方式更是一个心态问题。以前在一个新机器上装 MySQL我总会担心装错版本、影响系统、留下垃圾文件而现在一条docker run下去干净、规范、可控。数据放在数据卷里容器随便删随便建数据一点不受影响。配置写到挂载目录里改起来也不用 SSH 进服务器编辑各种深层路径。最后分享一个小技巧如果你已经用 Docker 跑 MySQL 一段时间了建议你把自己的docker run命令、配置文件、初始化脚本都整理成一个项目仓库。这样不管换电脑还是帮同事搭环境都能在五分钟内还原出一套完全一致的数据库环境。这其实就是容器化带来的最大红利。