WordPress NGINX + php-redis 镜像文档

镜像概述与主要用途

概述

本镜像是基于 bitnami/wordpress-nginx 官方镜像的扩展版本，通过添加 php-redis 扩展，提供对 Redis 数据库的原生支持。其核心目标是作为原镜像的无缝替代品，保持与官方镜像一致的标签版本，确保用户可直接替换使用，无需修改现有部署流程。

主要用途

用于部署需要 Redis 缓存、会话存储或数据持久化支持的 WordPress 应用，尤其适合依赖 Redis 提升性能的场景。作为 bitnami/wordpress-nginx 的功能扩展版，可直接替换原镜像，满足对 Redis 集成的需求。

核心功能与特性

继承原镜像功能

完整保留 bitnami/wordpress-nginx 镜像的所有原生功能，包括：

• 基于 NGINX 和 PHP-FPM 的高性能 WordPress 运行环境
• 预配置的安全最佳实践（非 root 用户运行、最小化镜像体积等）
• 支持多平台架构（如 AMD64、ARM64 等）
• 与 Bitnami 生态（如数据库、Redis 等服务）的无缝集成

扩展功能

• 内置 php-redis 扩展：原生支持 Redis 数据库连接，可用于 WordPress 缓存（如 W3 Total Cache、WP Rocket）、会话存储或数据处理。
• 每日同步更新：通过自动化任务每日拉取 bitnami/wordpress-nginx 官方更新，同步补丁与版本迭代，确保功能一致性。
• 标签兼容：镜像标签与 bitnami/wordpress-nginx 完全一致（如 latest、6.4.3-debian-11-r12 等），可直接作为原镜像的 drop-in 替代品。

使用场景与适用范围

适用场景

• 需要 Redis 缓存的 WordPress 站点：通过 php-redis 扩展启用 Redis 作为页面缓存、对象缓存或数据库查询缓存，提升站点响应速度。
• 会话存储需求：需将 WordPress 用户会话存储于 Redis（而非本地文件系统）的分布式部署场景。
• 与 Bitnami 生态无缝集成：已使用 Bitnami WordPress 镜像且需添加 Redis 支持，同时希望保持部署流程不变的环境。

适用范围

• 开发、测试及生产环境的 WordPress 单实例部署。
• 依赖 Bitnami 官方镜像配置（如环境变量、数据卷挂载）的现有架构。
• 需要快速启用 Redis 功能且不愿手动编译 php-redis 扩展的场景。

使用方法与配置说明

前提条件

• 已安装 Docker Engine（20.10+）或 Docker Desktop。
• 如需使用 Redis 服务，需提前部署 Redis 实例（可使用 bitnami/redis 镜像）。

镜像拉取

镜像标签与 bitnami/wordpress-nginx 完全一致，可直接指定标签拉取（以 latest 为例）：

docker pull wordlift/bitnami-docker-wordpress-nginx:latest

基础部署示例

1. 使用 docker run 部署

通过以下命令启动 WordPress 容器，需指定数据库连接信息（以 MySQL 为例）及 Redis 连接信息（若启用 Redis 缓存）：

docker run -d \
  --name wordpress-nginx-redis \
  -p 80:8080 \
  -e WORDPRESS_DATABASE_HOST=mysql-host \
  -e WORDPRESS_DATABASE_PORT=3306 \
  -e WORDPRESS_DATABASE_NAME=wordpress \
  -e WORDPRESS_DATABASE_USER=wpuser \
  -e WORDPRESS_DATABASE_PASSWORD=wppassword \
  -e WORDPRESS_REDIS_HOST=redis-host \  # Redis 服务地址
  -e WORDPRESS_REDIS_PORT=6379 \       # Redis 端口（默认 6379）
  -e WORDPRESS_REDIS_PASSWORD=redispassword \  # 若 Redis 启用认证
  -v /path/to/wordpress/data:/bitnami/wordpress \  # 持久化 WordPress 数据
  wordlift/bitnami-docker-wordpress-nginx:latest

2. 使用 docker-compose 部署

创建 docker-compose.yml 文件，集成 WordPress、MySQL 和 Redis 服务（完整示例）：

version: '3.8'

services:
  wordpress:
    image: wordlift/bitnami-docker-wordpress-nginx:latest
    ports:
      - "80:8080"
    environment:
      - WORDPRESS_DATABASE_HOST=mysql
      - WORDPRESS_DATABASE_PORT=3306
      - WORDPRESS_DATABASE_NAME=wordpress_db
      - WORDPRESS_DATABASE_USER=wp_user
      - WORDPRESS_DATABASE_PASSWORD=wp_pass123
      - WORDPRESS_REDIS_HOST=redis
      - WORDPRESS_REDIS_PORT=6379
      - WORDPRESS_REDIS_PASSWORD=redis_pass123  # 若 Redis 启用认证
      - WORDPRESS_USERNAME=admin  # WordPress 管理员用户名
      - WORDPRESS_PASSWORD=admin_pass123  # WordPress 管理员密码
      - WORDPRESS_EMAIL=***  # WordPress 管理员邮箱
    volumes:
      - wordpress_data:/bitnami/wordpress  # 持久化 WordPress 数据
    depends_on:
      - mysql
      - redis

  mysql:
    image: bitnami/mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass123
      - MYSQL_DATABASE=wordpress_db
      - MYSQL_USER=wp_user
      - MYSQL_PASSWORD=wp_pass123
    volumes:
      - mysql_data:/bitnami/mysql/data

  redis:
    image: bitnami/redis:7.2
    environment:
      - REDIS_PASSWORD=redis_pass123  # 启用 Redis 认证
    volumes:
      - redis_data:/bitnami/redis/data

volumes:
  wordpress_data:
  mysql_data:
  redis_data:

启动服务：

docker-compose up -d

配置说明

继承的环境变量

本镜像完全继承 bitnami/wordpress-nginx 的所有环境变量，核心配置项包括（详细列表见 Bitnami 官方文档）：

• 数据库配置：WORDPRESS_DATABASE_HOST、WORDPRESS_DATABASE_PORT、WORDPRESS_DATABASE_NAME、WORDPRESS_DATABASE_USER、WORDPRESS_DATABASE_PASSWORD。
• WordPress 基础配置：WORDPRESS_USERNAME（管理员用户名）、WORDPRESS_PASSWORD（管理员密码）、WORDPRESS_EMAIL（管理员邮箱）、WORDPRESS_BLOG_NAME（站点名称）。
• 网络配置：WORDPRESS_SITE_URL（站点 URL）、WORDPRESS_HOME_URL（首页 URL）。

Redis 相关配置

若需启用 Redis 缓存，需通过 WordPress 插件（如 W3 Total Cache）配置 Redis 连接，插件将自动使用容器内已启用的 php-redis 扩展。插件配置中需填写 Redis 地址（如 redis，对应 docker-compose 中的服务名）、端口及密码（与环境变量 WORDPRESS_REDIS_* 一致）。

数据持久化

通过挂载数据卷持久化 WordPress 数据（如主题、插件、上传文件），默认挂载路径为 /bitnami/wordpress（与原镜像一致），避免容器删除后数据丢失。

注意事项

• 标签兼容性：请使用与原 bitnami/wordpress-nginx 相同的标签（如 6.4.3-debian-11-r12）以确保版本匹配。
• Redis 依赖：本镜像仅提供 php-redis 扩展，需独立部署 Redis 服务（推荐使用 bitnami/redis 镜像）。
• 更新策略：镜像每日同步 bitnami 官方更新，建议定期拉取最新标签以获取安全补丁。

相关链接

• 镜像源码仓库：GitHub
• 原镜像文档：bitnami/wordpress-nginx
• Redis 镜像：bitnami/redis