secoresearch/wordpress

Apache+PHP+Varnish+WordPress Docker镜像文档

1. 镜像概述

本Docker镜像为预配置的集成环境，整合了Apache Web服务器、PHP运行环境、Varnish缓存服务器和WordPress内容管理系统。旨在简化WordPress网站的部署流程，通过Varnish作为反向代理缓存提升系统性能，减少服务器负载并加快页面响应速度，适用于需要快速上线且对性能有要求的WordPress应用场景。

2. 核心功能与特性

• Apache Web服务器：处理HTTP/HTTPS请求，提供稳定的Web服务基础，支持虚拟主机配置
• PHP运行环境：集成WordPress所需PHP扩展（如mysqli、curl、gd、xml等），确保动态内容正常解析
• Varnish缓存服务器：作为HTTP反向代理缓存静态和动态内容，显著降低后端服务器负载，提升页面加载速度
• WordPress集成：预装最新稳定版WordPress，包含基础安全配置（禁用文件编辑、限制登录尝试等）
• 简化部署：无需手动配置组件间依赖关系，一键启动即可完成基础部署
• 可扩展性：支持通过环境变量和配置文件自定义参数，适应不同场景需求

3. 使用场景与适用范围

• 个人博客/自媒体：快速搭建个人内容平台，借助缓存提升读者访问体验
• 企业官网：满足企业对网站稳定性和加载速度的需求，减少服务器资源消耗
• 中小型电商：加速商品页面加载，优化用户购物流程，提升转化率
• 开发测试环境：快速构建本地WordPress开发环境，无需复杂本地配置
• 高并发场景：适用于访问量较大的WordPress站点，Varnish缓存有效缓解服务器压力

4. 使用方法与部署示例

4.1 前提条件

• 已安装Docker Engine（20.10+）和Docker Compose（可选，用于多容器部署）
• 准备外部MySQL/MariaDB数据库（本镜像不含数据库服务）

4.2 基本部署（docker run）

bash
docker run -d \
  --name wordpress-app \
  -p 80:80 \
  -e WORDPRESS_DB_HOST=mysql-host:3306 \
  -e WORDPRESS_DB_USER=dbuser \
  -e WORDPRESS_DB_PASSWORD=dbpass \
  -e WORDPRESS_DB_NAME=wordpress_db \
  -v /local/wp-content:/var/www/html/wp-content \
  -v /local/varnish-cache:/var/lib/varnish \
  [镜像名称]:latest

参数说明：

• -p 80:80：映射容器80端口至主机，用于HTTP访问
• -e：设置环境变量，配置数据库连接信息（必填）
• -v：挂载卷以持久化WordPress内容（主题、插件、上传文件）和Varnish缓存数据

4.3 Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'

services:
  wordpress:
    image: [镜像名称]:latest
    container_name: wordpress-app
    ports:
      - "80:80"
    environment:
      WORDPRESS_DB_HOST: mysql:3306
      WORDPRESS_DB_USER: wordpress_user
      WORDPRESS_DB_PASSWORD: secure_password
      WORDPRESS_DB_NAME: wordpress_db
      VARNISH_CACHE_TTL: 3600
      PHP_MEMORY_LIMIT: 512M
    volumes:
      - wp-content:/var/www/html/wp-content
      - varnish-cache:/var/lib/varnish
    depends_on:
      - mysql
    restart: always

  mysql:
    image: mysql:8.0
    container_name: wordpress-mysql
    environment:
      MYSQL_ROOT_PASSWORD: root_secure_password
      MYSQL_DATABASE: wordpress_db
      MYSQL_USER: wordpress_user
      MYSQL_PASSWORD: secure_password
    volumes:
      - mysql-data:/var/lib/mysql
    restart: always

volumes:
  wp-content:
  varnish-cache:
  mysql-data:

启动服务：

bash
docker-compose up -d

5. 配置说明

5.1 核心环境变量

WordPress数据库配置（必填）

• WORDPRESS_DB_HOST: 数据库地址（格式：host:port，如mysql:3306）
• WORDPRESS_DB_USER: 数据库用户名
• WORDPRESS_DB_PASSWORD: 数据库密码
• WORDPRESS_DB_NAME: 数据库名称（默认：wordpress）

Varnish缓存配置（可选）

• VARNISH_CACHE_TTL: 默认缓存有效期（秒，默认：3600）
• VARNISH_MEMORY_SIZE: 缓存内存大小（默认：256m，格式如512m/1g）
• VARNISH_BACKEND_PORT: 后端Apache服务端口（默认：8080）

PHP配置（可选）

• PHP_MEMORY_LIMIT: PHP内存限制（默认：256M）
• PHP_MAX_EXECUTION_TIME: 最大执行时间（秒，默认：30）
• PHP_UPLOAD_MAX_FILESIZE: 上传文件大小限制（默认：64M）

5.2 自定义配置文件

如需深度定制，可通过卷挂载替换默认配置：

• Varnish配置: 挂载自定义VCL文件至/etc/varnish/default.vcl
• Apache配置: 挂载站点配置至/etc/apache2/sites-available/000-default.conf
• PHP配置: 挂载自定义php.ini至/usr/local/etc/php/conf.d/custom.ini

6. 访问与管理

容器启动后，通过浏览器访问 http://[主机IP] 进入WordPress安装向导，完成管理员账号设置。管理后台地址为 http://[主机IP]/wp-admin，使用安装时设置的账号登录。

7. 注意事项

• 数据持久化: 务必通过卷挂载wp-content目录以保存WordPress主题、插件和上传文件
• 数据库依赖: 本镜像不含数据库服务，需配合MySQL/MariaDB使用（推荐通过Docker Compose联动）
• 安全加固: 生产环境建议启用HTTPS（可配合Nginx/Traefik反向代理）、设置强密码、定期更新WordPress核心及插件
• 性能调优: 根据访问量调整VARNISH_MEMORY_SIZE和PHP_MEMORY_LIMIT，高并发场景建议增加服务器资源