shinsenter/wordpress 镜像文档

1. 镜像概述和主要用途

shinsenter/wordpress 是一款生产就绪的 Docker 镜像，专为快速部署 WordPress 应用设计，内置自动 WordPress 安装器。该镜像支持 Debian 和 Alpine 两种基础系统版本，可直接用于开发环境和生产环境。

• Docker Hub 地址：[***]
• GitHub Packages 地址：[***]

2. 核心功能和特性

• 灵活配置：通过环境变量直接配置 PHP 和 PHP-FPM 参数，无需重建镜像
• 内置工具链：包含最新版 Composer 和 WP-CLI，支持命令行管理 WordPress（如插件更新、多站点配置等）
• 自动项目引导：挂载空目录时自动下载 WordPress 源代码，快速初始化新项目
• 多系统支持：提供 Debian 和 Alpine 两种基础版本镜像
• HTTPS 集成：内置测试 SSL 证书，支持替换为生产环境证书
• 持续更新：每日构建确保集成 PHP、基础系统、Composer 等最新上游更新

3. 使用场景和适用范围

• 快速搭建新项目：通过自动源代码下载功能，零配置启动 WordPress 项目
• 运行现有应用：挂载现有 WordPress 代码目录，直接运行应用并支持实时代码更新
• 生产环境部署：支持 HTTPS 配置、稳定镜像版本管理，满足生产环境可靠性要求

4. 详细使用方法和配置说明

4.1 创建新项目

当挂载空目录到容器时，镜像会自动下载 WordPress 源代码并完成初始化。

步骤：

1. 在主机创建空项目目录：

   shell
   mkdir wordpress
   

2. 运行容器并挂载目录（自动下载源代码）：

   shell
   docker run -p 80:80 -p 443:443 -p 443:443/udp \
       -v ./wordpress:/var/www/html \
       shinsenter/wordpress:latest
   

4.2 使用现有项目

挂载主机上的现有 WordPress 代码目录到容器的 /var/www/html 路径，即可运行现有应用。主机端代码修改会实时同步到容器内。

示例（docker run）：

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v /path/to/existing/wordpress:/var/www/html \
    shinsenter/wordpress:latest

4.3 配置 HTTPS

镜像内置测试 SSL 证书（路径：/etc/ssl/site/server.crt 和 /etc/ssl/site/server.key），生产环境需替换为有效证书。

4.3.1 使用 Dockerfile 替换证书

dockerfile
FROM shinsenter/wordpress:latest

# 复制生产证书替换默认证书
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

# 可选：添加自定义代码（如现有项目文件）
# ADD --chown=$APP_USER:$APP_GROUP ./wordpress/ /var/www/html/

4.3.2 使用 docker run 挂载证书

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./wordpress:/var/www/html \
    -v ./my_domain.crt:/etc/ssl/site/server.crt \
    -v ./my_domain.key:/etc/ssl/site/server.key \
    shinsenter/wordpress:latest

4.3.3 使用 docker-compose 配置证书

yaml
services:
  web:
    image: shinsenter/wordpress:latest
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./wordpress:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

4.4 稳定镜像标签

由于镜像每日更新，建议通过以下步骤获取稳定版本并标记，用于生产环境：

1. 拉取最新镜像：

   shell
   docker pull shinsenter/wordpress:latest
   

2. 标记为稳定版本：

   shell
   docker tag shinsenter/wordpress:latest your-repo/wordpress:stable
   

3. 推送至私有仓库（可选）：

   shell
   docker push your-repo/wordpress:stable
   

使用 your-repo/wordpress:stable 作为生产环境基础镜像，确保版本一致性。

5. 贡献

若发现镜像有用，可通过 *** ***，或在 GitHub 提交 issue。您的支持有助于持续维护和改进镜像。

6. 许可证

本项目基于 GNU General Public License v3.0 许可协议。使用或修改时请注明出处。