shinsenter/kirby 镜像文档

镜像概述和主要用途

shinsenter/kirby 是一个用于 PHP/Kirby 的生产就绪 Docker 镜像，内置自动 Kirby 安装器。该镜像支持 Debian 和 Alpine 两种版本，设计目标是通过环境变量轻松配置 PHP 和 PHP-FPM 设置，无需在修改配置时重建镜像。同时集成最新版 Composer，可快速启动项目，无需额外安装步骤。

• Docker Hub: [***]
• GitHub Packages: [***]
• 更多 PHP 应用镜像: [***]

核心功能和特性

• 灵活配置: 通过环境变量配置 PHP 和 PHP-FPM，无需重建镜像
• 快速启动: 内置最新版 Composer，直接启动项目
• 自动安装: 挂载空目录时自动下载 Kirby 框架源码，快速初始化新项目
• HTTPS 支持: 内置测试 SSL 证书，支持自定义证书替换
• 持续更新: 每日构建确保 PHP、基础 OS、Composer 等组件保持最新

使用场景和适用范围

• 快速搭建新的 Kirby 项目
• 运行现有 Kirby 应用程序
• 生产环境部署（通过标记稳定版本镜像）

详细使用方法和配置说明

创建新项目

当挂载空目录到容器时，镜像会自动下载 Kirby 框架完整源码，快速完成项目初始化。

步骤：

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

   shell
   mkdir kirby
   

2. 运行容器并挂载该目录：

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

容器会检测到空目录并自动克隆框架源码到挂载目录。

使用现有项目

将现有 Kirby 项目代码目录挂载到容器的 /var/www/html 路径即可运行：

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v /path/to/your/kirby/project:/var/www/html \
    shinsenter/kirby:latest

主机上的代码更改会实时同步到容器内，便于开发和测试。

使用 HTTPS

镜像内置 HTTPS 测试证书（路径：/etc/ssl/site/server.crt 和 /etc/ssl/site/server.key），生产环境可替换为自定义证书。

通过 Dockerfile 替换证书

Dockerfile
FROM shinsenter/kirby: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 ./kirby/ /var/www/html/

通过 docker run 替换证书

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

通过 docker-compose 替换证书

yaml
services:
  web:
    image: shinsenter/kirby:latest
    volumes:
      - ./kirby:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

稳定镜像标签

由于每日构建会更新 PHP、基础 OS、Composer 等组件，相同标签的镜像内容可能变化。建议将 latest 镜像标记为稳定版本用于生产：

shell
# 拉取最新镜像
docker pull shinsenter/kirby:latest

# 标记为稳定版本
docker tag shinsenter/kirby:latest your-repo/kirby:stable

# 推送到私有仓库（如需要）
docker push your-repo/kirby:stable

使用 your-repo/kirby:stable 作为生产环境基础镜像。

贡献和许可证

贡献

如发现镜像有用，可通过 *** ***，或在 GitHub 提交 issue。

许可证

本项目基于 GNU General Public License v3.0 许可。使用或基于本项目构建时，请注明出处。