SERVER_NAME环境变量优先级高于Caddyfile域名块，设为:80时强制纯HTTP监听并忽略Caddyfile中所有域名配置及tls、redir等指令，是FrankenPHP的设计行为而非bug。
SERVER_NAME 环境变量优先级高于 Caddyfile 中的域名块
生效，但只在特定条件下起作用：当你挂载了自定义 Caddyfile，同时设置了 SERVER_NAME=:80（或 :8080），FrankenPHP 会直接忽略 Caddyfile 里所有基于域名的 server 块（比如 example.com { }），强制启用一个纯 HTTP 监听器，地址为 SERVER_NAME 的值。这不是 bug，是设计行为。
这意味着你写在 Caddyfile 里的 tls、redir、https:// 相关指令全被跳过——Caddy 根本不解析那些块。
-
SERVER_NAME=example.com→ 触发 ACME 自动证书申请，强制 HTTPS -
SERVER_NAME=:80→ 禁用域名匹配，监听容器内:80，纯 HTTP -
SERVER_NAME=localhost:8080→ 无效格式，Caddy 不识别带端口的主机名，fallback 到默认行为
Caddyfile 里用环境变量动态监听端口，和 SERVER_NAME 不冲突但用途不同
SERVER_NAME 控制的是“是否启用域名匹配 + 是否走 HTTPS 流程”，而 Caddyfile 内部的环境变量插值（如 http://:${HTTP_PORT}）只是字符串替换，最终仍需 Caddy 实际监听那个地址——但它不会覆盖 SERVER_NAME 的模式决策。
举例：你设了 SERVER_NAME=:80，又在 Caddyfile 里写了 http://:${HTTP_PORT} { ... }，且 HTTP_PORT=8080，结果是 Caddy 尝试监听 :8080，但因为 SERVER_NAME 强制关闭了域名逻辑，它仍然只建一个 server，只是端口变了。这时候你必须同步调整 Docker 的 -p 映射，否则连不上。
立即学习“PHP免费学习笔记（深入）”；
- 仅靠
Caddyfile插值改端口，不配SERVER_NAME，可能意外触发 HTTPS 自动配置 - 想彻底禁用 HTTPS 并指定端口，
SERVER_NAME=:端口号是唯一可靠方式 -
Caddyfile中的servers { https_port 8443 }这类全局配置，只在SERVER_NAME允许 HTTPS 时才生效
Docker Compose 中 ports 字段不展开环境变量，别指望 ${HTTP_PORT} 在这里起作用
ports 字段由 Docker 引擎原生处理，不支持变量展开。写 - "${HTTP_PORT}:80" 不会变成 - "8080:80"，而是被当字面量解析，大概率报错 invalid port specification 或静默映射到随机端口。
真正能用变量的地方只有 environment 和 volumes 等少数字段。端口映射必须硬编码右侧（容器内端口），左侧（宿主机端口）可借助 .env 文件 + 默认值语法间接管理：
- 在
.env文件里写HTTP_PORT=8080 -
docker-compose.yml中写- "${HTTP_PORT:-80}:80"（注意右边固定为80，因 FrankenPHP 默认监听:80当SERVER_NAME=:80） - 运行
docker-compose config验证输出是否已展开成数字，没展开说明.env没加载或变量名拼错
端口不生效？先确认三件事：SERVER_NAME 值对不对、Docker -p 映射对不对、Caddyfile 是否被加载
常见“端口没变”的假象，其实是链路断在某个环节：
-
SERVER_NAME写成localhost:80或127.0.0.1:80—— Caddy 只认:80这种格式 - Docker 启动没加
-p 8080:8080，却指望SERVER_NAME=:8080让宿主机 8080 可访问（实际只监听容器内，外部不通） - 挂载了
Caddyfile，但路径不对（比如挂到/etc/caddy/Caddyfile却没用-config参数指定），FrankenPHP 仍用默认空配置启动
最稳的验证方式：启动后进容器执行 netstat -tlnp | grep :80（或对应端口），看监听地址是不是你预期的 *:80 或 *:8080 —— 这比查日志更快定位问题根源。
