以下信息来自服务器上正在运行的 WordPress 容器（docker inspect wordpress 实测）。本服务器 WordPress 当前由 docker run 手动启动，本教程给出标准化的 Docker Compose 方案（配置与现网一致，可直接落地）。

1. Docker 与 Docker Compose 已安装（Docker ≥ 20.10，Compose v2）。
2. MySQL 8.0 已按《MySQL Docker Compose 部署图文教程》部署，且已创建 WordPress 库与用户（即 compose 中 MYSQL_DATABASE=wordpress、MYSQL_USER=wordpress）。
3. 两个容器处于同一个 Docker 网络（本教程沿用 1panel-network），否则 WordPress 无法用 mysql 主机名连库。

创建项目目录与 compose 文件：

sudo mkdir -p /opt/docker/wordpress
sudo vi /opt/docker/wordpress/docker-compose.yml

粘贴以下内容（数据库密码替换为 MySQL 教程中设置的值）：

services:
  wordpress:
    image: wordpress:latest             # 官方镜像（Apache+PHP+WordPress）
    container_name: wordpress
    restart: unless-stopped
    ports:
      - "8080:80"                       # 外部 8080 → 容器 80（想用 80 直接访问则改 "80:80"）
    environment:
      WORDPRESS_DB_HOST: mysql:3306     # 数据库主机：MySQL 容器名:端口（同网络）
      WORDPRESS_DB_USER: wordpress      # 数据库用户
      WORDPRESS_DB_PASSWORD: 你的数据库密码   # 必改
      WORDPRESS_DB_NAME: wordpress      # 数据库名
      WORDPRESS_TABLE_PREFIX: wp_       # 表前缀（默认 wp_）
      WORDPRESS_CONFIG_EXTRA: |
        define( 'WP_MEMORY_LIMIT', '256M' );   # 可选：提高 PHP 内存上限
        define( 'FS_METHOD', 'direct' );       # 可选：允许后台直接安装主题/插件
      TZ: Asia/Shanghai
    volumes:
      - wordpress_data:/var/www/html    # 站点全部文件（含 wp-content 上传）
    depends_on:
      - mysql                           # 等待 MySQL 先启动
    networks:
      - 1panel-network

  mysql:
    image: mysql:8.0
    container_name: mysql
    restart: unless-stopped
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: 你的Root强密码    # 必改
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: 你的数据库密码
      TZ: Asia/Shanghai
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --default-authentication-plugin=mysql_native_password
    volumes:
      - /opt/mysql/data:/var/lib/mysql
      - /opt/mysql/conf:/etc/mysql/conf.d
    networks:
      - 1panel-network

volumes:
  wordpress_data:                       # named volume，数据持久化

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

cd /opt/docker/wordpress
docker compose up -d          # 后台启动（首次会拉取 wordpress 镜像）
docker compose ps             # 状态应为 Up
docker logs -f wordpress      # 看到 "AH00094: Command line: 'apache2-foreground'" 即就绪

浏览器访问（首次安装时）http://（服务器IP）:8080 或你的域名，进入安装界面：

# 验证站点文件与权限
docker exec wordpress ls /var/www/html          # 应看到 wp-admin、wp-content、wp-config.php 等

# 验证数据库连接（容器内 PHP 连接测试）
docker exec wordpress php -r '$c=@new mysqli("mysql","wordpress","你的数据库密码","wordpress"); echo $c->connect_error ? "FAIL: ".$c->connect_error : "DB OK";'

# 进入后台
# 浏览器打开 http://IP:8080/wp-admin  → 安装时设置的管理员账号登录

登录后台后即可：安装主题/插件（外观、插件）、发布文章、配置固定链接、接入 CDN 与 HTTPS 等。主题与插件会写入 /var/www/html/wp-content，位于 wordpress_data 卷内，容器重建不丢失。

# 查看日志 / 重启
docker compose logs -f wordpress
docker compose restart wordpress

# 升级 WordPress 镜像（先备份！）
docker compose pull wordpress
docker compose up -d wordpress

# 备份站点文件（wordpress_data 卷）
docker run --rm -v wordpress_data:/data -v /opt/docker/backup:/backup alpine tar czf /backup/wp-$(date +%F).tar.gz -C /data .

# 数据库备份（对应 MySQL 教程）
docker exec mysql mysqldump -uroot -p你的Root密码 wordpress --single-transaction > /opt/docker/backup/wp-db-$(date +%F).sql

Q1：安装时报 “Error establishing a database connection”

按顺序排查：① WORDPRESS_DB_HOST 必须是 mysql:3306；② WordPress 与 MySQL 是否在同一 Docker 网络（docker network inspect 1panel-network 看两个容器是否都在）；③ 用户名/密码/库名是否与 MySQL 实际一致；④ MySQL 是否正常 docker compose ps。

Q2：8080 端口被占用 / 想直接用 80 端口

改 compose 端口映射 "80:80"（需先停掉占用 80 的进程，如 nginx），或换 "8081:80"；改后 docker compose up -d 重建。若配了域名和 HTTPS，建议在 80/443 前挂 Nginx 反向代理。

Q3：后台提示 “要执行请求的操作，WordPress 需要访问您网页服务器的权限”（无法直接装主题/插件）

compose 已通过 WORDPRESS_CONFIG_EXTRA 写入 FS_METHOD=direct；若仍失败，检查 docker exec wordpress chown -R www-data:www-data /var/www/html 修正文件属主。

Q4：启用 HTTPS / 绑定域名

站点地址在「设置 → 常规」中改为 https://你的域名；推荐在容器外部署 Nginx + Let’s Encrypt 反代到 127.0.0.1:8080，并给 wp-config.php 增加 $_SERVER['HTTPS']='on';（或通过 WORDPRESS_CONFIG_EXTRA 注入反向代理处理代码）。

Q5：升级后页面样式/插件异常

多为缓存问题：后台「设置 → 固定链接」点一次「保存更改」刷新重写规则；同时清理浏览器缓存与 CDN 缓存。仍异常则检查 wp-content/plugins 是否有不兼容插件，可暂时重命名插件目录排障。

Q6：本服务器当前是 docker run 启动的，如何平滑切换到 Compose？

① docker inspect wordpress 拿到现网参数（本服务器：8080→80、env 连 mysql:3306、卷 wordpress_data）；② 按本教程 compose 内容写文件；③ docker stop wordpress && docker rm wordpress 移除旧容器（卷保留）；④ docker compose up -d。切换期间站点有短暂停机，建议低峰操作。