别再手动配环境了！用Docker Compose一键部署WordPress+MySQL（附完整docker-compose.yml）-平芜编程栈

告别手动配置：用Docker Compose高效部署WordPress全栈环境

在当今快速迭代的开发环境中，效率就是生命线。想象一下这样的场景：你需要为一个客户快速搭建一个WordPress演示站点，或者需要在本地开发环境中模拟生产服务器配置，甚至可能需要在多台服务器上部署相同的环境。传统的手动配置方式不仅耗时耗力，而且极易出错，特别是在处理容器间网络连接和数据库配置时。这正是Docker Compose的价值所在——它让我们能够用一份声明式的配置文件，轻松定义和管理多容器应用。

1. 为什么选择Docker Compose部署WordPress

手动配置WordPress和MySQL容器虽然可行，但存在几个明显的痛点。首先，每次部署都需要重复执行一系列命令，不仅效率低下，而且难以保证环境一致性。其次，容器间的网络连接需要手动查找IP地址并配置，这一过程既繁琐又脆弱——任何容器重启都可能导致IP变化，进而破坏整个环境。最后，缺乏版本控制的配置难以在不同环境间迁移和复用。

Docker Compose通过YAML格式的配置文件解决了这些问题。它允许我们：

一键启动/停止整个应用栈：无需记住复杂的docker run命令
自动处理容器间网络：通过服务名直接通信，无需关心IP地址
声明式配置：所有环境参数集中管理，易于版本控制和共享
环境一致性：确保开发、测试和生产环境完全一致

下面是一个最基本的docker-compose.yml框架示例：

version: '3.8' services: wordpress: image: wordpress:latest ports: - "8080:80" depends_on: - db db: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: example

这个简单的配置已经包含了WordPress和MySQL两个服务，并建立了它们之间的依赖关系。但要让这个配置真正实用，我们还需要考虑更多生产级的需求。

2. 生产级Docker Compose配置详解

2.1 数据持久化配置

默认情况下，容器停止后所有数据都会丢失。对于数据库和WordPress上传的内容，我们需要配置持久化存储。

services: wordpress: volumes: - wordpress_data:/var/www/html db: volumes: - db_data:/var/lib/mysql volumes: wordpress_data: db_data:

这里我们定义了两个命名卷(wordpress_data和db_data)，分别用于存储WordPress网站文件和MySQL数据库。Docker会自动管理这些卷的生命周期，即使容器被删除，数据也会保留。

提示：对于生产环境，建议将数据库卷挂载到主机特定目录，便于备份和管理。例如：
volumes: db_data: driver_opts: type: none device: /path/on/host o: bind

2.2 环境变量与安全配置

直接在docker-compose.yml中硬编码敏感信息(如数据库密码)是不安全的。更好的做法是使用环境变量文件：

services: db: environment: MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD} MYSQL_DATABASE: ${DB_NAME} MYSQL_USER: ${DB_USER} MYSQL_PASSWORD: ${DB_PASSWORD} env_file: - .env

对应的.env文件内容示例：

DB_ROOT_PASSWORD=secure_root_password DB_NAME=wordpress DB_USER=wpuser DB_PASSWORD=secure_password

重要：确保将.env文件添加到.gitignore中，避免敏感信息泄露

2.3 网络配置优化

默认情况下，Docker Compose会为服务创建专用网络，但我们可以显式定义网络特性：

networks: wp_network: driver: bridge ipam: config: - subnet: 172.20.0.0/16

然后在服务中指定网络：

services: wordpress: networks: - wp_network db: networks: - wp_network

这种配置提供了更好的网络隔离性和可预测性，特别适合多项目共存的环境。

3. 完整生产级docker-compose.yml示例

结合上述所有优化点，下面是一个完整的生产就绪配置：

version: '3.8' services: wordpress: image: wordpress:latest ports: - "8080:80" volumes: - wordpress_data:/var/www/html environment: WORDPRESS_DB_HOST: db WORDPRESS_DB_USER: ${DB_USER} WORDPRESS_DB_PASSWORD: ${DB_PASSWORD} WORDPRESS_DB_NAME: ${DB_NAME} depends_on: - db networks: - wp_network restart: unless-stopped db: image: mysql:5.7 volumes: - db_data:/var/lib/mysql environment: MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD} MYSQL_DATABASE: ${DB_NAME} MYSQL_USER: ${DB_USER} MYSQL_PASSWORD: ${DB_PASSWORD} networks: - wp_network restart: unless-stopped command: [ '--character-set-server=utf8mb4', '--collation-server=utf8mb4_unicode_ci', '--lower_case_table_names=1' ] volumes: wordpress_data: db_data: networks: wp_network: driver: bridge

这个配置包含了以下生产级特性：

数据持久化卷
环境变量分离管理
自定义网络配置
容器自动重启策略
MySQL字符集和排序规则优化
服务健康检查和依赖管理

4. 高级配置与优化技巧

4.1 多环境配置管理

在实际开发中，我们通常需要区分开发、测试和生产环境。可以通过多个Compose文件实现：

docker-compose.yml # 基础配置 docker-compose.override.yml # 开发环境扩展 docker-compose.prod.yml # 生产环境扩展

开发环境扩展示例(docker-compose.override.yml):

version: '3.8' services: wordpress: volumes: - ./wordpress:/var/www/html # 本地开发目录挂载 environment: WORDPRESS_DEBUG: 1

生产环境扩展示例(docker-compose.prod.yml):

version: '3.8' services: wordpress: deploy: resources: limits: cpus: '0.5' memory: 512M environment: WORDPRESS_DEBUG: 0

使用不同环境的命令：

# 开发环境(自动加载override) docker-compose up # 生产环境 docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

4.2 性能优化配置

对于高流量WordPress站点，可以考虑以下优化：

services: wordpress: environment: PHP_MEMORY_LIMIT: 256M PHP_MAX_EXECUTION_TIME: 300 deploy: resources: limits: cpus: '1' memory: 512M db: environment: MYSQL_INNODB_BUFFER_POOL_SIZE: 512M MYSQL_INNODB_LOG_FILE_SIZE: 128M deploy: resources: limits: cpus: '2' memory: 2G

4.3 备份与恢复策略

定期备份是生产环境的基本要求。可以添加备份服务：

services: db_backup: image: alpine volumes: - db_data:/source - ./backups:/backup command: sh -c "tar czf /backup/db_backup_$$(date +%Y%m%d_%H%M%S).tar.gz -C /source ." depends_on: - db networks: - wp_network

然后通过cron定时执行备份：

0 2 * * * docker-compose run --rm db_backup

5. 常见问题排查与调试技巧

即使有了完善的配置，实际部署中仍可能遇到各种问题。以下是一些常见场景的解决方法：

5.1 容器启动顺序问题

虽然depends_on确保容器启动顺序，但不保证服务就绪。可以添加健康检查：

services: db: healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 5s timeout: 3s retries: 10 wordpress: depends_on: db: condition: service_healthy

5.2 权限问题处理

当使用本地目录挂载时，可能会遇到权限问题。解决方法：

# 查看容器内用户ID docker-compose exec wordpress id # 在主机上修改目录所有者 sudo chown -R 33:33 ./wordpress

5.3 网络连接调试

如果WordPress无法连接MySQL，可以检查：

# 进入WordPress容器 docker-compose exec wordpress bash # 测试数据库连接 apt-get update && apt-get install -y mysql-client mysql -h db -u ${DB_USER} -p${DB_PASSWORD} ${DB_NAME}

5.4 性能问题诊断

对于性能瓶颈，可以使用以下命令：

# 查看容器资源使用情况 docker stats # 查看MySQL慢查询 docker-compose exec db mysql -uroot -p${DB_ROOT_PASSWORD} -e "SHOW FULL PROCESSLIST;"

6. 扩展应用场景

Docker Compose的WordPress部署方案可以轻松扩展到更复杂的场景：

6.1 多站点部署

通过简单修改，可以支持多个WordPress站点共享一个MySQL实例：

services: wordpress_site1: image: wordpress environment: WORDPRESS_DB_HOST: db WORDPRESS_DB_NAME: site1_db ports: - "8081:80" wordpress_site2: image: wordpress environment: WORDPRESS_DB_HOST: db WORDPRESS_DB_NAME: site2_db ports: - "8082:80" db: image: mysql environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: site1_db MYSQL_USER: site1_user MYSQL_PASSWORD: site1_pass MYSQL_DATABASE_2: site2_db MYSQL_USER_2: site2_user MYSQL_PASSWORD_2: site2_pass

6.2 添加Redis缓存

提升WordPress性能的常见做法是添加Redis对象缓存：

services: redis: image: redis:alpine networks: - wp_network wordpress: environment: WORDPRESS_REDIS_HOST: redis depends_on: - redis

然后在WordPress中安装Redis缓存插件即可。

6.3 CI/CD集成

Docker Compose可以无缝集成到CI/CD流程中。例如GitLab CI配置示例：

test: stage: test script: - docker-compose up -d - docker-compose exec wordpress curl -I http://localhost - docker-compose down

7. 最佳实践与经验分享

在实际项目中使用Docker Compose部署WordPress时，有几个关键点值得特别注意：

配置版本控制：将docker-compose.yml和.env.example(不含敏感信息)纳入版本控制，但确保.env文件被忽略。这保证了团队协作时环境配置的一致性。

资源限制：特别是在共享主机上，为容器设置合理的资源限制可以防止单个服务耗尽所有资源。例如：

services: wordpress: deploy: resources: limits: cpus: '0.5' memory: 512M reservations: memory: 256M

日志管理：生产环境中，配置合理的日志策略至关重要：

services: wordpress: logging: driver: "json-file" options: max-size: "10m" max-file: "3"

安全加固：除了使用环境变量管理敏感信息外，还应：

定期更新基础镜像
使用非root用户运行容器
限制不必要的端口暴露

监控与告警：可以添加监控服务如Prometheus：

services: prometheus: image: prom/prometheus ports: - "9090:9090" volumes: - ./prometheus.yml:/etc/prometheus/prometheus.yml

搭配适当的仪表板配置，可以实时监控WordPress和MySQL的性能指标。

别再手动配环境了！用Docker Compose一键部署WordPress+MySQL（附完整docker-compose.yml）