liupeng0518/mysql

MySQL镜像介绍

镜像概述

MySQL是全球最流行的开源数据库，以卓越的性能、可靠性和易用性成为Web应用的首选数据库，广泛应用于个人项目、电商平台、信息服务及大型Web属性（如***、***等）。本镜像提供了快速部署MySQL实例的便捷方式，支持多种配置和扩展场景。

核心功能

• 快速启动MySQL实例，通过环境变量配置关键参数
• 支持容器内客户端连接、远程连接及跨容器网络访问
• 允许自定义配置文件或命令行参数调整数据库设置
• 通过Docker Secrets安全管理敏感信息（如密码）
• 初始化时自动执行指定目录下的脚本（.sh、.sql、.sql.gz）
• 支持数据持久化存储和数据库备份/恢复操作

使用场景

• 个人项目或小型网站的轻量数据库服务
• 电商平台、信息服务系统的后端数据存储
• 开发测试环境的快速数据库部署与迭代
• 大型分布式系统中的数据节点或从库

配置说明

环境变量

• MYSQL_ROOT_PASSWORD：必填，设置root用户密码
• MYSQL_DATABASE：可选，初始化时创建的数据库名称
• MYSQL_USER/MYSQL_PASSWORD：可选，创建新用户及其密码（获指定数据库超级权限）
• MYSQL_ALLOW_EMPTY_PASSWORD：可选，允许空root密码（不推荐）
• MYSQL_RANDOM_ROOT_PASSWORD：可选，生成随机root密码并输出到日志
• MYSQL_ONETIME_PASSWORD：可选，强制root首次登录修改密码（MySQL 5.6+）

Docker Secrets

通过_FILE后缀从文件加载敏感信息，例如：

bash
docker run --name some-mysql -e MYSQL_ROOT_PASSWORD_FILE=/run/secrets/mysql-root -d liupeng0518/mysql

数据持久化

推荐将主机目录挂载到容器内MySQL数据目录：

bash
docker run --name some-mysql -v /my/own/datadir:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d liupeng0518/mysql

部署示例

快速启动实例

bash
docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d liupeng0518/mysql

Docker Compose部署

yaml
version: '3.1'
services:
  db:
    image: liupeng0518/mysql
    command: --default-authentication-plugin=mysql_native_password
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - ./datadir:/var/lib/mysql
  adminer:
    image: adminer
    restart: always
    ports:
      - 8080:8080

运行命令：docker-compose up -d，访问http://localhost:8080即可通过Adminer管理数据库。

连接到数据库

bash
# 跨容器连接（需在同一网络）
docker run -it --network some-network --rm liupeng0518/mysql mysql -hsome-mysql -uroot -pmy-secret-pw
# 远程连接
docker run -it --rm liupeng0518/mysql mysql -hremote.mysql.host -uroot -p

备份与恢复

• 备份所有数据库：

  bash
  docker exec some-mysql sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > all-databases.sql
  

• 恢复数据库：

  bash
  docker exec -i some-mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD"' < all-databases.sql
  

注意事项

• 首次启动时会初始化数据库，期间无法接受连接，需等待初始化完成
• 已有数据目录时，MYSQL_ROOT_PASSWORD会被忽略，保持原有数据库状态
• 可通过--user指定运行用户以适配主机目录权限（如--user 1000:1000）
• 自定义配置文件需挂载到/etc/mysql/conf.d目录下，优先级高于默认配置