koalaphils/wordpress

WordPress Docker镜像

镜像概述和主要用途

本镜像基于官方WordPress镜像扩展，旨在加速WordPress站点的Docker化安装与恢复流程。它特别适用于需要在多个WordPress站点中统一安装常用插件和主题的维护者，通过自动化配置减少重复操作，提升管理效率。

核心功能和特性

扩展环境变量

支持通过环境变量预设站点基础配置，无需手动输入：

• WORDPRESS_URL: 站点URL
• WORDPRESS_TITLE: 站点标题
• WORDPRESS_ADMIN_USER: 初始管理员用户名
• WORDPRESS_ADMIN_PASS: 管理员密码
• WORDPRESS_ADMIN_EMAIL: 管理员***
• WORDPRESS_BACKUP: 备份计划（Cron格式）

自动备份与恢复

提供专用备份卷，支持wp-content目录和.htaccess文件的自动备份与恢复，需挂载至/backup路径。

自动化部署流程

• 自动检测备份目录，若存在则恢复至/var/www/html
• 未安装时自动执行WordPress核心安装
• 预设wp_options配置（如隐藏站点可发现性、设置固定链接）
• 自动安装插件和主题并设置默认主题

使用场景和适用范围

• 维护多个WordPress站点的管理员
• 需要快速部署标准化WordPress环境的场景
• 需定期备份站点数据的个人或企业用户
• 希望统一插件和主题配置的团队

使用方法和配置说明

环境变量配置

启动容器时需设置以下环境变量（示例值）：

bash
-e WORDPRESS_URL="https://example.com" \
-e WORDPRESS_TITLE="My WordPress Site" \
-e WORDPRESS_ADMIN_USER="admin" \
-e WORDPRESS_ADMIN_PASS="securepassword" \
-e WORDPRESS_ADMIN_EMAIL="admin@example.com" \
-e WORDPRESS_BACKUP="0 2 * * *"  # 每天凌晨2点备份

卷配置

• 必须挂载的卷：
  • /var/www/html: WordPress站点文件（建议持久化）
  • /backup: 备份存储目录（用于自动备份与恢复）

工作流程

1. 备份检测与恢复

   • 容器启动时检查/backup目录
   • 若存在备份且站点未安装：恢复备份至/var/www/html
   • 若站点已安装：同步/backup内容至/var/www/html

2. WordPress安装流程

   • 使用环境变量安装WordPress核心
   • 配置wp_options（隐藏站点可发现性、设置固定链接）
   • 安装预设插件和主题
   • 激活默认主题

配置默认插件和主题

1. 插件配置

   • 创建plugins/pluginx.txt文件，每行填写一个插件名称（官方插件库）
   • 或在plugins目录放置插件ZIP文件，将自动安装

2. 主题配置

   • 创建themes/default.txt文件，填写默认主题名称（官方主题库）
   • 或在themes目录放置主题ZIP文件，将自动安装并设为默认

部署示例

docker-compose.yml示例

yaml
version: '3'

services:
  wordpress:
    image: [镜像名称]  # 替换为实际镜像名称
    ports:
      - "80:80"
    environment:
      - WORDPRESS_URL="https://example.com"
      - WORDPRESS_TITLE="My Site"
      - WORDPRESS_ADMIN_USER="admin"
      - WORDPRESS_ADMIN_PASS="secure123"
      - WORDPRESS_ADMIN_EMAIL="admin@example.com"
      - WORDPRESS_BACKUP="0 2 * * *"
    volumes:
      - ./html:/var/www/html
      - ./backup:/backup
      - ./plugins:/var/www/html/wp-content/plugins  # 插件目录
      - ./themes:/var/www/html/wp-content/themes    # 主题目录
    depends_on:
      - db
    restart: always

  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=wordpress
      - MYSQL_USER=wordpressuser
      - MYSQL_PASSWORD=wordpresspass
    volumes:
      - db_data:/var/lib/mysql
    restart: always

volumes:
  db_data:

启动命令

bash
docker-compose up -d