erfmedien/frankenphp

FrankenPHP (含caddy-dns/cloudflare模块) 镜像文档

镜像概述

本镜像基于FrankenPHP构建，集成了caddy-dns/cloudflare模块。FrankenPHP是一款将PHP与Caddy服务器深度集成的运行环境，而caddy-dns/cloudflare模块则为其提供了通过Cloudflare DNS进行域名验证和TLS证书自动管理的能力，特别适用于依赖Cloudflare DNS服务的PHP应用部署。

核心功能与特性

• FrankenPHP基础能力：融合PHP运行时与Caddy服务器，支持FastCGI、PHP-FPM替代方案及HTTP/2、HTTP/3协议
• Cloudflare DNS集成：通过caddy-dns/cloudflare模块实现：
  • 自动通过Cloudflare DNS验证域名所有权
  • 基于DNS-01挑战自动签发和续期Let's Encrypt TLS证书
  • 支持Cloudflare API令牌鉴权
• 简化部署：无需手动配置TLS证书，降低HTTPS部署复杂度

使用场景

• 需通过Cloudflare管理域名的PHP应用（如Laravel、Symfony、WordPress等）
• 要求自动HTTPS且依赖Cloudflare DNS服务的生产环境
• 需要简化证书管理流程的容器化PHP部署

使用方法

环境变量配置

Docker Run示例

bash
docker run -d \
  --name frankenphp-cloudflare \
  -p 80:80 \
  -p 443:443 \
  -e CLOUDFLARE_API_TOKEN="your_cloudflare_api_token" \
  -e DOMAIN="example.com" \
  -v /path/to/your/php/app:/app \
  your-image-name:tag

Docker Compose示例

yaml
version: '3.8'
services:
  frankenphp:
    image: your-image-name:tag
    ports:
      - "80:80"
      - "443:443"
    environment:
      - CLOUDFLARE_API_TOKEN=your_cloudflare_api_token
      - DOMAIN=example.com,*.example.com
      - PHP_MEMORY_LIMIT=512M
    volumes:
      - ./php-app:/app
    restart: unless-stopped

自定义Caddyfile

如需高级配置，可通过挂载自定义Caddyfile覆盖默认配置：

bash
docker run -d \
  --name frankenphp-cloudflare \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/your/Caddyfile:/etc/caddy/Caddyfile \
  -v /path/to/your/php/app:/app \
  your-image-name:tag

Caddyfile示例（含Cloudflare DNS配置）：

caddyfile
{
  acme_dns cloudflare {env.CLOUDFLARE_API_TOKEN}
}

example.com {
  root * /app/public
  php_fastcgi unix//run/php/php-fpm.sock
  file_server
  encode gzip
}

注意事项

• Cloudflare API令牌需至少包含Zone.DNS编辑权限
• 确保域名已通过Cloudflare管理，且DNS记录正确指向部署服务器
• 首次启动时需等待证书签发，可能需要1-2分钟
• 生产环境建议挂载持久化卷存储证书（路径：/data/caddy）