在京东云服务器上使用 Docker 部署 MySQL 数据库
一、前置准备
1. 确认服务器环境
# 检查操作系统版本
cat /etc/os-release
# 检查是否有 root 权限
whoami
# 确保系统已更新
yum update -y # CentOS/RedHat
apt update && apt upgrade -y # Ubuntu/Debian
2. 安装 Docker
CentOS/RHEL 系:
# 安装依赖
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
# 添加 Docker 仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
# 安装 Docker CE
sudo yum install -y docker-ce docker-ce-cli containerd.io
# 启动并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
# 验证安装
docker --version
Ubuntu/Debian 系:
# 安装依赖
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
# 添加 Docker GPG 密钥和仓库
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 安装 Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
# 启动并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
3. 配置 Docker 非 root 用户运行(可选)
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
二、部署 MySQL
方法一:使用 docker run 快速部署
# 创建数据持久化目录
mkdir -p ~/mysql/data
mkdir -p ~/mysql/conf
mkdir -p ~/mysql/logs
# 创建自定义配置文件 my.cnf
cat > ~/mysql/conf/my.cnf << 'EOF'
[mysqld]
# 字符集
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
# 最大连接数
max_connections=500
# 缓冲池大小(根据服务器内存调整,建议为物理内存的50%-70%)
innodb_buffer_pool_size=1G
# 日志相关
log-error=/var/log/mysqld.log
slow_query_log=1
slow_query_log_file=/var/log/mysql-slow.log
long_query_time=2
# 时区
default-time-zone='+08:00'
# InnoDB 优化
innodb_flush_log_at_trx_commit=1
sync_binlog=1
# 绑定所有地址(Docker 环境下通常不需要改)
bind-address=0.0.0.0
EOF
# 拉取 MySQL 镜像
docker pull mysql:8.0
# 启动 MySQL 容器
docker run -d
--name mysql-db
--restart=always
-p 3306:3306
-v ~/mysql/data:/var/lib/mysql
-v ~/mysql/conf/my.cnf:/etc/mysql/conf.d/my.cnf
-v ~/mysql/logs:/var/log/mysql
-e MYSQL_ROOT_PASSWORD=YourStrongPassword123!
-e MYSQL_DATABASE=myapp_db
-e MYSQL_USER=myapp_user
-e MYSQL_PASSWORD=MyAppUserPass123!
mysql:8.0
⚠️ 安全提示:生产环境中请使用强密码,并通过环境变量或 Docker secrets 管理敏感信息。
方法二:使用 Docker Compose(推荐)
1. 安装 Docker Compose
# 下载最新稳定版
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# 赋予执行权限
sudo chmod +x /usr/local/bin/docker-compose
# 验证
docker-compose --version
2. 创建项目目录和配置文件
mkdir -p ~/mysql-docker
cd ~/mysql-docker
3. 编写 docker-compose.yml
version: '3.8'
services:
mysql:
image: mysql:8.0
container_name: mysql-db
restart: always
ports:
- "3306:3306"
volumes:
- ./data:/var/lib/mysql
- ./conf/my.cnf:/etc/mysql/conf.d/my.cnf
- ./logs:/var/log/mysql
environment:
MYSQL_ROOT_PASSWORD: YourStrongRootPassword123!
MYSQL_DATABASE: myapp_db
MYSQL_USER: myapp_user
MYSQL_PASSWORD: MyUserPassword123!
TZ: Asia/Shanghai
command: >
--character-set-server=utf8mb4
--collation-server=utf8mb4_unicode_ci
--max_connections=500
--innodb-buffer-pool-size=1G
--default-time-zone=+08:00
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
interval: 10s
timeout: 5s
retries: 5
networks:
- mysql-net
networks:
mysql-net:
driver: bridge
4. 创建配置文件 conf/my.cnf
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
max_connections = 500
innodb_buffer_pool_size = 1G
log-error = /var/log/mysqld.log
slow_query_log = 1
slow_query_log_file = /var/log/mysql-slow.log
long_query_time = 2
default-time-zone = '+08:00'
innodb_flush_log_at_trx_commit = 1
sync_binlog = 1
bind-address = 0.0.0.0
5. 启动服务
# 首次启动(创建卷并初始化)
docker-compose up -d
# 查看日志
docker-compose logs -f mysql
# 查看运行状态
docker-compose ps
6. 常用操作
# 停止服务
docker-compose down
# 重启服务
docker-compose restart
# 进入容器内部
docker exec -it mysql-db bash
mysql -u root -p
# 备份数据库
docker exec mysql-db mysqldump -u root -p'YourStrongRootPassword123!' myapp_db > backup.sql
# 恢复数据库
docker exec -i mysql-db mysql -u root -p'YourStrongRootPassword123!' myapp_db < backup.sql
三、京东云安全组配置
1. 开放 MySQL 端口
登录 京东云控制台 → ECS 实例 → 安全组 → 添加入方向规则:
| 协议 | 端口范围 | 来源 | 策略 |
|---|---|---|---|
| TCP | 3306 | 0.0.0.0/0(或指定IP) | 允许 |
🔒 强烈建议:将来源限制为应用服务器的内网 IP 或特定公网 IP,避免暴露给互联网。
2. 防火墙配置(如启用 firewalld)
# CentOS
sudo firewall-cmd --permanent --add-port=3306/tcp
sudo firewall-cmd --reload
# Ubuntu (ufw)
sudo ufw allow 3306/tcp
sudo ufw reload
四、验证部署
# 1. 检查容器是否运行
docker ps | grep mysql
# 2. 测试本地连接
mysql -h 127.0.0.1 -P 3306 -u myapp_user -p
# 3. 从其他机器远程连接
mysql -h <京东云公网IP> -P 3306 -u myapp_user -p
# 4. 检查 MySQL 版本和状态
docker exec mysql-db mysql -u root -p'YourStrongRootPassword123!' -e "SELECT VERSION();"
# 5. 检查慢查询日志
docker exec mysql-db tail -f /var/log/mysql/mysql-slow.log
五、生产环境最佳实践
1. 数据持久化与备份
# 定时备份脚本
cat > /opt/mysql-backup.sh << 'EOF'
#!/bin/bash
BACKUP_DIR="/backup/mysql"
DATE=$(date +%Y%m%d_%H%M%S)
MYSQL_CONTAINER="mysql-db"
ROOT_PASS="YourStrongRootPassword123!"
DB_NAME="myapp_db"
mkdir -p $BACKUP_DIR
docker exec $MYSQL_CONTAINER mysqldump -u root -p$ROOT_PASS $DB_NAME > $BACKUP_DIR/${DB_NAME}_${DATE}.sql
# 保留最近7天的备份
find $BACKUP_DIR -name "*.sql" -mtime +7 -delete
echo "Backup completed: ${DB_NAME}_${DATE}.sql"
EOF
chmod +x /opt/mysql-backup.sh
# 添加到 crontab(每天凌晨2点备份)
echo "0 2 * * * /opt/mysql-backup.sh >> /var/log/mysql-backup.log 2>&1" | sudo tee -a /etc/crontab
2. 资源限制
# docker-compose.yml 中添加资源限制
services:
mysql:
image: mysql:8.0
deploy:
resources:
limits:
cpus: '2.0'
memory: 4G
reservations:
cpus: '0.5'
memory: 1G
3. 监控与健康检查
# 使用 Prometheus + Grafana 监控 MySQL
# 或使用简单的健康检查脚本
cat > /opt/check-mysql.sh << 'EOF'
#!/bin/bash
if docker exec mysql-db mysqladmin ping -h localhost >/dev/null 2>&1; then
echo "MySQL is running"
else
echo "MySQL is DOWN!"
docker restart mysql-db
fi
EOF
4. 定期更新 MySQL 镜像
docker pull mysql:8.0
docker-compose down
docker-compose up -d
六、常见问题排查
| 问题 | 解决方案 |
|---|---|
| 容器启动失败 | docker logs mysql-db 查看详细错误 |
| 无法远程连接 | 检查京东云安全组、防火墙、MySQL 用户权限 |
| 中文乱码 | 确保 character-set-server=utf8mb4 |
| 磁盘空间不足 | df -h 检查,清理旧日志或备份 |
| 性能差 | 调整 innodb_buffer_pool_size,检查索引 |
| 忘记密码 | 进入容器重置:ALTER USER 'root'@'%' IDENTIFIED BY 'newpass'; |
# 重置 root 密码示例
docker exec -it mysql-db bash
mysql -u root
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'NewPassword123!';
FLUSH PRIVILEGES;
exit
通过以上步骤,你可以在京东云服务器上成功使用 Docker 部署一个安全、可维护的 MySQL 数据库实例。如需更高可用性,可考虑使用 MySQL 主从复制 或迁移到京东云的 RDS 服务。
轻量云Cloud