FrankenPHP怎么用Docker Compose部署网站-php教程-PHP中文网

frankenphp开箱即用，内置caddy和php运行时，无需nginx或php-fpm配置；只需挂载代码到/app/public、设置server_name、映射80/443/443/udp端口即可运行。

frankenphp怎么用docker compose部署网站

直接用 dunglas/frankenphp 镜像启动就行，不用额外配 Nginx 或 PHP-FPM

FrankenPHP 自带 Caddy Web 服务器和 PHP 运行时，dunglas/frankenphp 镜像开箱即用，省去传统 LNMP 中 Nginx + PHP-FPM 的通信配置。你只需要把代码放对位置、设好 SERVER_NAME，容器起来就能响应 HTTP 请求。

常见错误是照搬旧习惯：比如还在 docker-compose.yml 里定义 nginx 和 php 两个服务，或者挂载 /etc/nginx/conf.d/ —— 这些在 FrankenPHP 里不仅多余，还会因端口冲突或配置覆盖导致 502/404。

SERVER_NAME 必须设（哪怕只是 :80），否则 Caddy 不知道监听哪个域名或端口
PHP 文件默认从 /app/public 提供服务，不是 /var/www/html 或 /usr/share/nginx/html
HTTPS 自动启用，证书由 Caddy 后台静默申请；若本地测试不想走 HTTPS，改用 ENV SERVER_NAME=:80

docker-compose.yml 关键字段不能漏：ports、volumes、environment

FrankenPHP 容器默认监听 80（HTTP）、443（HTTPS）和 443/udp（HTTP/3），这三个端口映射必须显式写出，否则外部访问不到。

volumes 只需挂载代码目录到 /app/public，不需要挂载日志、配置或临时文件 —— Caddy 的配置由环境变量驱动，运行时自动生成。

services:
  php:
    image: dunglas/frankenphp
    restart: always
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    environment:
      SERVER_NAME: example.com
    volumes:
      - ./public:/app/public

如果项目结构不是 ./public（比如 Laravel 是 ./public，但 Symfony 是 ./public 或 ./public/index.php），确认入口文件路径正确
restart: always 比 unless-stopped 更稳妥，避免容器异常退出后服务中断
不要加 command: 覆盖默认启动逻辑，除非你明确要传参给 frankenphp run

多应用共存？靠 worker 入口和 Caddyfile 路由分发

单个 FrankenPHP 容器只能跑一个主应用（/app/public），但你可以通过 worker 模式部署多个子服务，比如 API 后端、管理后台、静态资源站。这时需要自定义 Caddyfile 并挂载进去。

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

典型场景：主站用 example.com，后台用 admin.example.com，两者代码目录不同，但共享同一 FrankenPHP 容器。

在项目根目录写 Caddyfile，内容类似：

example.com {
    root * /app/public
    php_backend
}
admin.example.com {
    root * /app/admin
    php_backend
}

docker-compose.yml 中加挂载：- ./Caddyfile:/etc/caddy/Caddyfile
确保 environment 里 SERVER_NAME 设为通配符（如 *）或留空，让 Caddyfile 完全接管路由
worker 模式下，PHP 进程常驻内存，但每个请求仍走完整生命周期 —— 不是 FastCGI 那种长连接，别误以为能复用数据库连接

build 自定义镜像时，别动 `/app/public` 的 COPY 时机

如果你用 build: 替代 image:，Dockerfile 里必须把代码 COPY 到 /app/public，且要在 RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini" 之后做 —— 否则 php.ini 生效前，COPY 的文件可能被后续构建步骤覆盖或忽略。

容易踩的坑是沿用 Laravel/Symfony 的老 Dockerfile 模板，把 COPY . /app 放在最前面，结果 /app/public 下没东西，或者 index.php 被复制到了 /app/index.php 而非 /app/public/index.php，导致 404。

正确顺序：RUN mv ... → COPY . /app/public → WORKDIR /app/public
如果项目有构建步骤（如 Vite 打包、composer install），必须在 COPY 之后执行，且目标路径仍是 /app/public
Alpine 镜像中，opcache.enable_cli=1 默认关闭，如需 CLI 模式加速（比如 Artisan 命令），得手动在 php.ini 里打开

真正麻烦的从来不是启动容器，而是搞清请求到底进了哪个路径、被哪个 handler 处理、有没有触发 worker 生命周期 —— 建议第一次部署时，在 index.php 里加 var_dump($_SERVER['SERVER_SOFTWARE']);，确认看到的是 Caddy 而不是空值或 Apache 字样。