apsl/wordpress

WordPress Docker镜像文档

镜像概述

本镜像为基于LAMP架构的WordPress Docker镜像，使用circus进行进程管理，通过envtpl工具在启动时基于环境变量动态生成配置文件。若未通过环境变量指定WordPress安全密钥，镜像将自动生成。该镜像基于apsl/lamp基础镜像构建，继承其底层环境特性。

核心功能与特性

• 动态配置生成：通过envtpl工具在容器启动时基于环境变量生成wp-config.php配置文件
• 自动密钥生成：若未通过环境变量设置WordPress安全密钥，将自动生成
• 进程管理：使用circus工具管理容器内进程（[***]
• 环境变量驱动配置：支持通过环境变量灵活配置WordPress参数
• 基础镜像支持：基于apsl/lamp基础镜像（https://registry.hub.docker.com/u/apsl/lamp/%EF%BC%89%EF%BC%8C%E5%8C%85%E5%90%AB%E5%AE%8C%E6%95%B4LAMP%E7%8E%AF%E5%A2%83

使用场景

• 快速部署WordPress网站，需灵活配置数据库连接及站点参数
• 开发/测试环境中需要动态调整WordPress配置
• 需要自动化管理WordPress进程的场景

使用方法与配置说明

环境变量配置

以下环境变量可用于配置镜像，括号内为默认值：

• 数据库配置

  • DB_NAME：数据库名称（wordpress）
  • DB_USER：数据库用户名（wpuser）
  • DB_PASSWORD：数据库密码（1234）
  • DB_HOST：数据库主机地址（172.17.42.1）
  • DB_PORT：数据库端口（3306）
  • DB_COLLATE：数据库排序规则（空字符串）

• 站点配置

  • DOMAIN：站点域名，用于设置WP_SITEURL、WP_HOME及Apache ServerName（容器主机名）
  • WP_TABLE_PREFIX：数据库表前缀（wp_）
  • WPLANG：WordPress语言（es_ES）
  • WP_DEBUG：调试模式开关（False）
  • WP_AUTO_UPDATE_CORE：核心自动更新开关（true）
  • WP_URL_PREFIX：URL前缀（空字符串）

部署示例

Docker Run命令

bash
docker run -d \
  -p 80:80 \
  -e DB_NAME=mywordpress \
  -e DB_USER=myuser \
  -e DB_PASSWORD=mypassword \
  -e DB_HOST=mysql-container \
  -e DOMAIN=example.com \
  --name wordpress-site \
  [镜像名称]

Docker Compose配置示例

yaml
version: '3'
services:
  wordpress:
    image: [镜像名称]
    ports:
      - "80:80"
    environment:
      - DB_NAME=mywordpress
      - DB_USER=myuser
      - DB_PASSWORD=mypassword
      - DB_HOST=mysql
      - DOMAIN=example.com
      - WP_DEBUG=True
    depends_on:
      - mysql
    restart: always

  mysql:
    image: mysql:5.7
    environment:
      - MYSQL_DATABASE=mywordpress
      - MYSQL_USER=myuser
      - MYSQL_PASSWORD=mypassword
      - MYSQL_ROOT_PASSWORD=rootpassword
    volumes:
      - mysql-data:/var/lib/mysql
    restart: always

volumes:
  mysql-data:

注：实际部署时需将[镜像名称]替换为具体的镜像标识。使用前确保数据库服务已启动并可被WordPress容器访问。