以下信息来自服务器上正在运行的 MySQL 容器（docker inspect mysql 实测），教程后面的步骤将以此配置为蓝本，密码位置已用占位符替代。

确认 Docker 与 Compose 已安装且版本可用：

docker --version
docker compose version
# 本服务器实测：
#   Docker version 26.1.4
#   Docker Compose version v2.27.1

创建数据与配置目录（目录路径可按需调整，教程沿用服务器实际路径 /opt/mysql）：

sudo mkdir -p /opt/mysql/data /opt/mysql/conf
sudo chmod -R 755 /opt/mysql

关于网络：如果服务器上已存在一个供多个容器共用的外部网络（本服务器即 1Panel 创建的网络 1panel-network），直接复用它；没有则创建一个自定义网络：

# 创建自定义网络（若 1panel-network 已存在可跳过）
docker network create 1panel-network

新建项目目录并编写 compose 文件：

sudo mkdir -p /opt/1panel/docker/compose/mysql
sudo vi /opt/1panel/docker/compose/mysql/docker-compose.yml

粘贴以下内容（密码请替换为强密码）：

services:
  mysql:
    image: mysql:8.0                # MySQL 官方 8.0 镜像
    container_name: mysql           # 容器名，同网络容器用它访问
    restart: unless-stopped         # 开机自启、崩溃自动拉起
    ports:
      - "3306:3306"                 # 宿主机 3306 → 容器 3306
    volumes:
      - /opt/mysql/data:/var/lib/mysql      # 数据持久化
      - /opt/mysql/conf:/etc/mysql/conf.d   # 自定义配置目录
    environment:
      - MYSQL_ROOT_PASSWORD=你的Root强密码    # 必改
      - MYSQL_DATABASE=wordpress              # 自动创建业务库（可改为自己的库名）
      - MYSQL_USER=wordpress                  # 自动创建业务用户
      - MYSQL_PASSWORD=你的业务库密码          # 必改，WordPress 教程要用
      - TZ=Asia/Shanghai                      # 时区
    command: >
      --character-set-server=utf8mb4
      --collation-server=utf8mb4_unicode_ci
      --default-authentication-plugin=mysql_native_password
    networks:
      - 1panel-network

networks:
  1panel-network:
    external: true                  # 引用已存在的网络复制

关键参数说明

cd /opt/1panel/docker/compose/mysql
docker compose up -d          # 后台启动
docker compose ps             # 查看状态，STATUS 应为 Up

首次启动会拉取镜像并初始化数据目录，稍等片刻（初始化约 10~30 秒）：

docker logs mysql            # 看到 "ready for connections" 即初始化完成
docker compose logs -f mysql  # 实时跟踪日志

6.1 容器内验证

docker exec -it mysql mysql -uroot -p
# 输入 root 密码后执行：
SHOW DATABASES;              -- 应看到 information_schema / mysql / performance_schema / sys / wordpress
USE wordpress;
SHOW TABLES;                 -- 新库应为空
exit;

6.2 宿主机 / 远程验证

# 宿主机本机测试（需已安装 mysql 客户端，或用容器内客户端代替）
mysql -h 127.0.0.1 -P 3306 -uwordpress -p wordpress

# 远程机器测试（防火墙/安全组需放行 3306）
mysql -h （服务器IP） -P 3306 -uwordpress -p wordpress

# 重启 / 停止 / 启动
docker compose restart mysql
docker compose stop mysql
docker compose start mysql

# 查看日志
docker compose logs -f mysql

# 全库备份到宿主机（推荐配合 crontab 定时执行）
docker exec mysql mysqldump -uroot -p你的Root密码 --all-databases --single-transaction > /opt/mysql/backup-$(date +%F).sql

# 恢复备份
docker exec -i mysql mysql -uroot -p你的Root密码 < /opt/mysql/backup-2026-08-30.sql

Q1：3306 端口被占用 / 想换端口

修改 compose 中 ports 为 "13306:3306"，然后 docker compose up -d 重建。同时记得同步修改 WordPress 等客户端的 DB_HOST 为 mysql:3306（容器间端口不变，仍是容器内 3306）。

Q2：忘记 root 密码

通过 docker exec -it mysql mysql -uroot -p 登录失败时，可临时跳过认证：先 docker compose stop mysql，再以 --skip-grant-tables 启动并改密；或直接重置：docker exec -it mysql mysql -uroot -p你的旧密码 -e "ALTER USER 'root'@'%' IDENTIFIED BY '新密码';"（需要能登录）。

Q3：客户端报 "Authentication plugin 'caching_sha2_password'" 或 "Unknown authentication method"

老客户端不支持 MySQL 8 默认认证，compose 里已用 --default-authentication-plugin=mysql_native_password 规避；若仍有问题，对单个用户执行 ALTER USER 'wordpress'@'%' IDENTIFIED WITH mysql_native_password BY '密码';

Q4：数据目录 /opt/mysql/data 里有什么，能直接拷走吗？

目录里是 MySQL 的物理数据文件（ibdata1、binlog 等）。停库后（docker compose stop mysql）整个目录拷走即可整体迁移；不建议在运行中直接复制。日常备份用 mysqldump 更安全。

Q5：容器时区 / 时间不对

compose 已设置 TZ=Asia/Shanghai；若容器内仍差 8 小时，检查宿主机时区 timedatectl，或给容器挂载 /etc/localtime:/etc/localtime:ro。