mirror of https://github.com/SeanChang/xuanyuan_docker_proxy.git synced 2026-10-06 14:33:11 +08:00

Files

T

部署文档定期更新

2026-08-22 20:36:37 +08:00

20 KiB

Raw Permalink Blame History

MySQL Server Docker 容器化部署指南

分类: Docker部署教程 | 标签: mysql-server,docker,部署教程 | 发布时间: 2025-11-26 08:06:50

MySQL是世界上最流行的开源关系型数据库管理系统，由Oracle公司开发和维护。它以高性能、可靠性和易用性著称，广泛应用于从个人网站到企业级应用的各种场景。MySQL支持多用户、多线程操作，提供了丰富的SQL功能和强大的数据处理能力，同时具备良好的可扩展性和安全性。

MySQL Server Docker 容器化部署指南

分类: Docker,MySQL Server | 标签: mysql-server,docker,部署教程 | 发布时间: 2025-11-26 08:06:50

概述

MySQL是世界上最流行的开源关系型数据库管理系统，由Oracle公司开发和维护。它以高性能、可靠性和易用性著称，广泛应用于从个人网站到企业级应用的各种场景。MySQL支持多用户、多线程操作，提供了丰富的SQL功能和强大的数据处理能力，同时具备良好的可扩展性和安全性。

随着容器化技术的普及，使用Docker部署MySQL Server已成为简化环境配置、确保部署一致性的理想选择。本文将详细介绍如何通过Docker容器化方式部署MySQL Server，包括环境准备、镜像拉取、容器配置、功能测试及生产环境优化等关键步骤，帮助用户快速实现MySQL Server的容器化部署与管理。

环境准备

Docker安装

在开始部署前，需确保目标服务器已安装Docker环境。推荐使用以下一键安装脚本，可自动完成Docker引擎、Docker Compose的安装及环境配置：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

备用地址：

bash <(wget -qO- https://get.xuanyuan.me/docker.sh)

注意：执行脚本可能需要root权限，请确保当前用户具备sudo权限或直接以root用户操作。脚本运行过程中会自动处理依赖项安装、Docker服务启动及开机自启配置。

镜像准备

镜像信息确认

本次部署使用的镜像为mysql/mysql-server，这是由Oracle MySQL团队官方维护的Docker镜像，包含优化后的MySQL Server版本。该镜像支持多种标签，对应不同的MySQL版本，其中：

8.0、latest标签对应最新的MySQL 8.0 GA版本，支持x86和AArch64(ARM64)架构
5.7标签对应MySQL 5.7版本
更多版本信息可参考MySQL Server镜像标签列表

镜像拉取命令

# 拉取推荐的latest标签（MySQL 8.0 GA版本）
docker pull xxx.xuanyuan.run/mysql/mysql-server:latest

# 如需指定版本，例如拉取5.7版本
# docker pull xxx.xuanyuan.run/mysql/mysql-server:5.7

说明：xxx.xuanyuan.run 请替换为你的专属域名，或使用登录拉取域名 docker.xuanyuan.run（如 docker pull docker.xuanyuan.run/mysql/mysql-server:latest）。docker pull 与 docker run 须使用同一完整镜像名。

镜像拉取过程中，轩辕访问支持能力会自动从国内节点获取缓存镜像，通常可达到MB/s级下载访问表现，大幅优于直接从Docker Hub拉取。

镜像验证

拉取完成后，可通过以下命令验证镜像是否成功获取：

# 查看本地镜像列表
docker images | grep mysql-server

# 预期输出示例：
# xxx.xuanyuan.run/mysql/mysql-server   latest    xxxxxxxx    2 weeks ago    500MB

容器部署

基础部署（快速启动）

如需快速启动一个基础的MySQL Server实例，可使用以下命令：

# 创建并启动名为mysql-server的容器
docker run --name=mysql-server -d \
  -p 3306:3306 \
  xxx.xuanyuan.run/mysql/mysql-server:latest

参数说明：

--name=mysql-server：指定容器名称为mysql-server，便于后续管理
-d：后台运行容器
-p 3306:3306：将容器的3306端口映射到主机的3306端口（MySQL默认端口）

生产级部署（带数据持久化与安全配置）

对于生产环境，建议配置数据持久化、自定义密码及资源限制，命令如下：

# 创建数据存储目录
mkdir -p /data/mysql/{data,conf,logs}
# SELinux 场景（CentOS/Rocky）需设置目录标签
# chcon -Rt svirt_sandbox_file_t /data/mysql

# 首次部署：数据目录必须为空，否则 MySQL 初始化会失败（详见「故障排查」）
ls -la /data/mysql/data   # 应仅有 . 和 ..，无其他文件

# 启动容器（生产环境配置）
docker run --name=mysql-server -d \
  --restart=always \
  -p 3306:3306 \
  -v /data/mysql/data:/var/lib/mysql \
  -v /data/mysql/conf:/etc/my.cnf.d \
  -v /data/mysql/logs:/var/log/mysql \
  -e MYSQL_ROOT_PASSWORD="YourStrongPassword123!" \
  -e MYSQL_INNODB_BUFFER_POOL_SIZE=1G \
  --memory=2G \
  --cpus=1 \
  xxx.xuanyuan.run/mysql/mysql-server:latest

关键参数详解：

--restart=always：容器退出时自动重启，确保服务高可用
-v /data/mysql/data:/var/lib/mysql：将MySQL数据目录挂载到主机，实现数据持久化
-v /data/mysql/conf:/etc/my.cnf.d：挂载配置文件目录，便于自定义MySQL配置（mysql/mysql-server 镜像使用 /etc/my.cnf.d；若使用 Docker 官方的 library/mysql 镜像，配置目录为 /etc/mysql/conf.d，勿混用）
-v /data/mysql/logs:/var/log/mysql：挂载日志目录，方便日志收集与分析
-e MYSQL_ROOT_PASSWORD="YourStrongPassword123!"：设置root用户密码（生产环境务必使用强密码）
-e MYSQL_INNODB_BUFFER_POOL_SIZE=1G：设置InnoDB缓冲池大小（通常建议设为物理内存的50%）
--memory=2G：限制容器最大使用内存为2GB
--cpus=1：限制容器使用1个CPU核心

权限说明：mysql/mysql-server 容器内运行用户 UID 通常为 999（mysql 用户），entrypoint 会自动处理空数据目录权限，一般无需手动 chmod 777 或 chown 1000:1000。

自定义配置（通过配置文件）

如需进行更复杂的配置，可在宿主机的/data/mysql/conf目录下创建自定义配置文件，例如：

# 创建自定义配置文件
cat > /data/mysql/conf/custom.cnf << EOF
[mysqld]
max_connections = 1000
slow_query_log = ON
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 2
EOF

# 重启容器使配置生效
docker restart mysql-server

注意：所有配置项需符合MySQL官方规范，详细参数说明可参考MySQL Server镜像文档（轩辕）及MySQL官方手册。

功能测试

容器状态检查

容器启动后，首先检查运行状态（执行 docker exec 前必须先确认容器在运行）：

# 查看容器运行状态（STATUS 应为 Up）
docker ps | grep mysql-server

# 若未显示或状态为 Exited，查看退出原因
docker ps -a | grep mysql-server
docker logs mysql-server
docker inspect mysql-server --format='{{.State.ExitCode}} {{.State.Error}}'

# 容器名冲突时，先删除旧容器再重建
# docker rm -f mysql-server

# 健康状态检查（MySQL容器内置健康检查机制，容器运行后可用）
docker inspect --format='{{.State.Health.Status}}' mysql-server

# 预期输出：healthy（表示MySQL服务已就绪）

若提示 container ... is not running，说明容器已退出，请查看日志并按「故障排查」章节处理，不要直接 docker exec。

日志查看与初始密码获取

对于未指定MYSQL_ROOT_PASSWORD的部署方式（基础部署），MySQL会自动生成随机root密码，可通过日志查看：

# 查看容器日志
docker logs mysql-server

# 提取初始密码（适用于未设置MYSQL_ROOT_PASSWORD的情况）
docker logs mysql-server 2>&1 | grep "GENERATED ROOT PASSWORD"

# 预期输出示例：
# GENERATED ROOT PASSWORD: Axegh3kAJyDLaRuBemecisu&EShOs

说明：如在部署时已通过MYSQL_ROOT_PASSWORD设置密码，则无需此步骤。

连接MySQL服务器

容器内连接

通过docker exec命令进入容器并连接MySQL：

# 进入容器并启动mysql客户端（使用自定义密码）
docker exec -it mysql-server mysql -uroot -p"YourStrongPassword123!"

# 如使用初始随机密码（基础部署方式）
# docker exec -it mysql-server mysql -uroot -p"Axegh3kAJyDLaRuBemecisu&EShOs"

首次连接（使用随机密码时），需立即修改密码：

-- 修改root用户密码
ALTER USER 'root'@'localhost' IDENTIFIED BY 'NewStrongPassword456!';
FLUSH PRIVILEGES;

外部客户端连接

在宿主机或其他可访问宿主机的机器上，使用MySQL客户端连接：

# 宿主机直接连接（需安装mysql-client）
mysql -h127.0.0.1 -P3306 -uroot -p"YourStrongPassword123!"

# 远程连接（需开放防火墙3306端口并确保root用户允许远程访问）
# mysql -h<服务器IP> -P3306 -uroot -p"YourStrongPassword123!"

注意：默认情况下，root用户仅允许本地连接。如需开启远程访问，需执行：

-- 创建允许远程访问的root用户（生产环境建议使用更严格的IP限制）
CREATE USER 'root'@'%' IDENTIFIED BY 'YourStrongPassword123!';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;

功能验证

连接成功后，可进行基本功能测试：

-- 创建测试数据库
CREATE DATABASE testdb;

-- 使用测试数据库
USE testdb;

-- 创建测试表
CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY,
  name VARCHAR(50) NOT NULL,
  email VARCHAR(100) UNIQUE NOT NULL,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 插入测试数据
INSERT INTO users (name, email) VALUES ('Test User', 'test@example.com');

-- 查询数据
SELECT * FROM users;

-- 预期输出：
-- +----+-----------+-----------------+---------------------+
-- | id | name      | email           | created_at          |
-- +----+-----------+-----------------+---------------------+
-- |  1 | Test User | test@example.com| 2023-11-01 12:00:00 |
-- +----+-----------+-----------------+---------------------+

数据持久化验证

为确保数据持久化生效，可进行以下测试：

# 1. 停止并删除当前容器
docker stop mysql-server
docker rm mysql-server

# 2. 使用相同的数据卷重新创建容器
docker run --name=mysql-server -d \
  -p 3306:3306 \
  -v /data/mysql/data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD="YourStrongPassword123!" \
  xxx.xuanyuan.run/mysql/mysql-server:latest

# 3. 重新连接并查询之前创建的测试数据
docker exec -it mysql-server mysql -uroot -p"YourStrongPassword123!" -e "USE testdb; SELECT * FROM users;"

如能正常查询到之前插入的测试数据，说明数据持久化配置成功。

生产环境建议

数据安全

数据备份策略

创建定期备份脚本（示例：每日凌晨 2 点备份）：

cat > /data/mysql/backup.sh << 'EOF'
#!/bin/bash
BACKUP_DIR="/data/mysql/backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
mkdir -p "$BACKUP_DIR"
docker exec mysql-server mysqldump -uroot -p"YourStrongPassword123!" --all-databases > "$BACKUP_DIR/full_backup_${TIMESTAMP}.sql"
find "$BACKUP_DIR" -name "full_backup_*.sql" -mtime +30 -delete
EOF

chmod +x /data/mysql/backup.sh

配置定时任务：

crontab -e
# 添加以下行（每日凌晨 2 点执行）：
# 0 2 * * * /data/mysql/backup.sh >> /data/mysql/backups/backup.log 2>&1

备份文件输出到宿主机 /data/mysql/backups，勿将备份目录挂载到容器内 /var/lib/mysql 子路径，否则会导致数据目录非空、MySQL 初始化失败。

密码管理
- 避免在命令行直接暴露密码，生产环境建议使用Docker Secrets或环境变量文件
- 定期更换密码，复杂度需包含大小写字母、数字和特殊符号

性能优化

资源配置
- 根据服务器配置合理设置内存和CPU限制，推荐：
```
--memory=4G --memory-swap=4G --cpus=2  # 适用于8GB内存服务器
```
- InnoDB缓冲池大小建议设置为可用内存的50%-70%：
```
-e MYSQL_INNODB_BUFFER_POOL_SIZE=2G
```
存储优化
- 使用SSD存储数据目录，显著提升IO性能
- 对于大型数据库，考虑使用单独的磁盘挂载/data/mysql/data目录

高可用性

容器自愈
- 始终启用--restart=always确保容器故障后自动重启
- 结合监控工具（如Prometheus+Grafana）实时监控容器状态

主从复制 对于关键业务，建议部署主从复制架构：

# 主库配置示例（添加主从复制相关参数）
docker run --name=mysql-master -d \
  -p 3306:3306 \
  -v /data/mysql/master/data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD="MasterPass123!" \
  -e MYSQL_SERVER_ID=1 \
  -e MYSQL_LOG_BIN=mysql-bin \
  xxx.xuanyuan.run/mysql/mysql-server:latest

# 从库配置示例
# docker run --name=mysql-slave -d \
#   -p 3307:3306 \
#   -v /data/mysql/slave/data:/var/lib/mysql \
#   -e MYSQL_ROOT_PASSWORD="SlavePass123!" \
#   -e MYSQL_SERVER_ID=2 \
#   -e MYSQL_MASTER_HOST=mysql-master \
#   -e MYSQL_MASTER_USER=repl \
#   -e MYSQL_MASTER_PASSWORD=ReplPass123! \
#   xxx.xuanyuan.run/mysql/mysql-server:latest

安全加固

网络隔离

使用Docker网络隔离数据库容器，避免直接暴露到公网

# 创建专用网络
docker network create mysql-network

# 连接到专用网络（应用容器也应加入此网络）
docker run --name=mysql-server -d \
  --network=mysql-network \
  -v /data/mysql/data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD="YourStrongPassword123!" \
  xxx.xuanyuan.run/mysql/mysql-server:latest

最小权限原则

为应用创建专用数据库用户，避免直接使用root用户

CREATE USER 'appuser'@'%' IDENTIFIED BY 'AppPass123!';
GRANT SELECT,INSERT,UPDATE,DELETE ON appdb.* TO 'appuser'@'%';
FLUSH PRIVILEGES;

故障排查

容器启动失败

症状：docker ps未显示容器，或状态为Exited

排查步骤：

查看启动日志与退出码：

docker logs mysql-server
docker inspect mysql-server --format='{{.State.ExitCode}} {{.State.Error}}'

常见原因及解决：
- 端口冲突：Bind for 0.0.0.0:3306 failed，需更换主机端口或停止占用端口的进程
- 数据目录非空：日志出现 data directory has files in it 或 /var/lib/mysql/ is unusable，说明 /data/mysql/data 在首次启动时不为空（含上次失败残留）。无重要数据时：
```
docker rm -f mysql-server
rm -rf /data/mysql/data/*
ls -la /data/mysql/data   # 确认仅剩 . 和 ..
# 重新 docker run
```
- CPU 不支持 x86-64-v2：日志出现 Fatal glibc error: CPU does not support x86-64-v2，ExitCode 常为 127。较新的 MySQL 8.0 镜像要求 x86-64-v2 指令集。排查：grep -m1 flags /proc/cpuinfo（若无 sse4_2、popcnt 等即不支持）。解决：换 xxx.xuanyuan.run/mysql/mysql-server:5.7，或虚拟机中将 CPU 类型改为 host / x86-64-v2-AES 后重启 VM
- 数据目录权限问题：Permission denied。优先确认数据目录为空；SELinux 场景执行 chcon -Rt svirt_sandbox_file_t /data/mysql。一般无需 chmod 777 或 chown 1000:1000（容器内 mysql 用户 UID 为 999，entrypoint 会自动处理空目录）
- 配置文件错误：检查/data/mysql/conf目录下的配置文件语法
- 容器名冲突：重复 docker run --name=mysql-server 报 name already in use，先 docker rm -f mysql-server 再重试

连接失败

症状：无法通过客户端连接MySQL服务

排查步骤：

检查容器端口映射：
```
docker port mysql-server 3306
```

验证防火墙规则：

# 查看防火墙状态（CentOS示例）
firewall-cmd --list-ports | grep 3306
# 如未开放，添加规则：
firewall-cmd --add-port=3306/tcp --permanent
firewall-cmd --reload

检查MySQL用户权限：

SELECT user,host FROM mysql.user;
SELECT host,user,Grant_priv,Super_priv FROM mysql.user;

性能问题

症状：查询缓慢、连接数过高

排查步骤：

查看MySQL状态：

docker exec -it mysql-server mysql -uroot -p"YourStrongPassword123!" -e "SHOW GLOBAL STATUS;"

检查慢查询日志：

# 查看慢查询日志内容
cat /data/mysql/logs/slow.log

常见优化方向：
- 增加max_connections参数（默认151）
- 优化慢查询SQL，添加合适索引
- 调整InnoDB缓冲池大小

数据恢复

当数据损坏或需要恢复时，可使用之前创建的备份文件：

# 从备份文件恢复数据
docker exec -i mysql-server mysql -uroot -p"YourStrongPassword123!" < /data/mysql/backups/full_backup_20231101_020000.sql

注意：恢复前建议停止应用写入，避免数据不一致。

参考资源

官方文档
- Deploying MySQL on Linux with Docker - MySQL官方Docker部署指南
- MySQL Reference Manual - MySQL完整参考手册
镜像相关
- MySQL Server镜像文档（轩辕） - 轩辕镜像访问支持服务提供的镜像信息
- MySQL Server镜像标签列表 - 所有可用版本标签
工具与社区
- Docker官方文档 - Docker基础操作与最佳实践
- MySQL Docker GitHub仓库 - 镜像构建源码与贡献指南
- MySQL Bug报告 - 官方问题反馈平台

总结

本文详细介绍了MYSQL-SERVER的Docker容器化部署方案，从环境准备、镜像拉取、容器配置到功能测试和生产环境优化，提供了一套完整的实施指南。通过Docker部署MySQL Server，可大幅简化环境配置流程，确保部署一致性，并通过轩辕镜像访问支持服务显著提升国内环境下的部署效率。

关键要点：

使用一键脚本bash <(wget -qO- https://xuanyuan.cloud/docker.sh)可快速完成Docker环境与轩辕加速配置
镜像拉取需遵循多段镜像名规则，正确命令为docker pull xxx.xuanyuan.run/mysql/mysql-server:latest
生产环境必须配置数据持久化（-v /data/mysql/data:/var/lib/mysql）和定期备份
安全加固措施包括网络隔离、权限控制和密码管理，是生产部署的必备环节
容器健康检查和日志监控是确保服务稳定运行的关键

后续建议：

深入学习MySQL高级特性，如分区表、存储过程、触发器等，充分发挥数据库性能
根据业务需求调整配置参数，特别是缓存大小、连接数和查询优化相关设置
考虑引入监控系统，如Prometheus+Grafana，实时监控数据库性能指标
对于大规模部署，建议研究MySQL集群方案，如InnoDB Cluster或基于Kubernetes的StatefulSet部署
定期关注MySQL Server镜像标签列表，及时更新到安全稳定的版本

通过本文提供的方案，用户可快速实现MySQL Server的容器化部署，并根据实际需求进行扩展和优化，为业务系统提供可靠的数据存储服务。

20 KiB Raw Permalink Blame History Unescape Escape

MySQL Server Docker 容器化部署指南

MySQL Server Docker 容器化部署指南

概述

环境准备

Docker安装

镜像准备

镜像信息确认

镜像拉取命令

镜像验证

容器部署

基础部署（快速启动）

生产级部署（带数据持久化与安全配置）

自定义配置（通过配置文件）

功能测试

容器状态检查

日志查看与初始密码获取

连接MySQL服务器

容器内连接

外部客户端连接

功能验证

数据持久化验证

生产环境建议

数据安全

性能优化

高可用性

安全加固

故障排查

容器启动失败

连接失败

性能问题

数据恢复

参考资源

总结

20 KiB

Raw Permalink Blame History