官方镜像启动MySQL最稳妥，需挂载数据卷、配置文件和初始化脚本，指定ROOT密码，注意字符集与连接方式。
直接用官方镜像启动 MySQL 容器最稳妥
MySQL 官方 Docker 镜像（mysql:8.0 或 mysql:5.7）已预置初始化逻辑和权限模型，比自己从基础镜像构建更可靠。不建议用 debian 或 alpine 自建，容易遗漏 mysqld 初始化步骤，导致容器反复重启或 Access denied 错误。
启动前需明确：是否需要持久化数据、是否要自定义配置、是否暴露端口给宿主机。常见错误是忽略 -v 挂载 /var/lib/mysql，容器一删，数据库就彻底丢失。
- 用
docker run启动时，必须指定MYSQL_ROOT_PASSWORD环境变量，否则容器会退出并报错MYSQL_ROOT_PASSWORD not set - 若需兼容旧应用，可加
MYSQL_ALLOW_EMPTY_PASSWORD=yes，但仅限测试环境 - 默认监听
0.0.0.0:3306，如只允许本地连接，启动时加--bind-address=127.0.0.1（需挂载自定义my.cnf）
挂载自定义 my.cnf 配置文件的关键写法
Docker 中 MySQL 不读取宿主机的 /etc/mysql/my.cnf，必须通过 -v 映射到容器内 /etc/mysql/conf.d/ 或 /etc/mysql/mysql.conf.d/ 下，且文件后缀必须为 .cnf。放在 /etc/mysql/my.cnf 顶层路径会被忽略。
常见错误是把配置写成 [mysqld] 段但漏掉 skip-host-cache 或 skip-name-resolve，导致容器启动慢甚至卡住——这是 DNS 解析失败引起的。
docker run -d \ --name mysql-dev \ -e MYSQL_ROOT_PASSWORD=devpass \ -v $(pwd)/my-custom.cnf:/etc/mysql/conf.d/custom.cnf \ -v $(pwd)/data:/var/lib/mysql \ -p 3306:3306 \ -d mysql:8.0
my-custom.cnf 示例内容（仅覆盖必要项，不全量复制官方配置）：
[mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci skip-host-cache skip-name-resolve innodb_buffer_pool_size=256M
初始化 SQL 脚本自动执行的触发条件
MySQL 容器启动时，会自动执行 /docker-entrypoint-initdb.d/ 目录下所有 .sql、.sql.gz 或 .sh 文件，但**仅当数据目录为空（首次初始化）时生效**。如果已挂载非空 /var/lib/mysql，脚本将被跳过——这点极易被忽略。
WOC-YII是rschome.com基于yii framework 1.1.8框架所开发的一款开源简易站群管理系统。它的功能与WOC完全一样。目前版本为V1.3，新版本正在开发中，同时欢迎大家参与到开发中来！ WOC-YII 1.3在1.2的基础上优化了登录系统（密码加密），优化了权限控制系统，新增seo管理功能，新增自动安装向导！ 程序框架：yiiframework1.1.8 配置文件：p
- 脚本必须是 UTF-8 编码，含中文注释或表名时，BOM 头会导致语法错误
- SQL 文件中不要用
CREATE DATABASE，因为MYSQL_DATABASE环境变量已自动创建库；重复创建会报错中断初始化 - 若需创建非 root 用户，必须在脚本末尾显式执行
FLUSH PRIVILEGES;，否则权限不生效
示例初始化脚本 init.sql：
CREATE USER 'appuser'@'%' IDENTIFIED BY 'apppass'; GRANT ALL ON myapp.* TO 'appuser'@'%'; FLUSH PRIVILEGES;
连接容器内 MySQL 的实际验证方式
别依赖 localhost 连接。在容器内用 mysql -h 127.0.0.1 -P 3306 -u root -p；从宿主机连接则用 mysql -h 127.0.0.1 -P 3306 -u root -p（不是 localhost），因为 macOS / Windows 的 Docker Desktop 会把 localhost 解析为宿主机而非容器网关。
常见连不上原因：防火墙拦截 3306 端口、MySQL 用户未授权 % 主机、bind-address 设为 127.0.0.1 且没改配置。
调试命令：
docker logs mysql-dev # 查看初始化是否成功 docker exec -it mysql-dev mysql -uroot -p # 进入容器手动连 netstat -tuln | grep :3306 # 宿主机确认端口是否监听
字符集问题常出现在客户端连接后查出乱码，此时检查三处：容器内 my.cnf 的 character-set-server、连接时加 --default-character-set=utf8mb4、建表语句是否带 CHARSET=utf8mb4。
