FrankenPHP容器重建后数据丢失是必然结果，因caddy_data、/var/www/html等目录未挂载持久化卷，导致证书、网站文件、session全部随可写层清空；必须显式挂载命名卷如caddy_data:/var/lib/caddy和www_data:/var/www/html才能持久化。
FrankenPHP容器重建后网站数据丢失，不是意外，而是没挂载持久化存储的必然结果——容器可写层随销毁而清空，caddy_data、/var/www/html、/var/lib/php/sessions 这些目录若没挂卷，全都会丢。
为什么重建后证书和网站文件一起没了？
FrankenPHP 本身不管理证书或网站内容，它完全依赖 Caddy 的 ACME 流程和你挂载的文件路径。证书默认存于容器内 /var/lib/caddy（即 caddy_data 目录），网站文件通常放在 /var/www/html。这两个位置都属于容器可写层：
-
caddy_data不挂卷 → ACME 申请的证书、私钥、账户信息全部丢失，下次启动触发新申请，可能撞上 Let’s Encrypt 速率限制 -
/var/www/html不挂卷 → 所有 PHP 文件、上传图片、静态资源随容器删除而清空 - session 文件若写在默认
/var/lib/php/sessions（未挂卷）→ 用户登录态丢失，购物车清空
docker run 启动时必须显式挂载两个关键卷
别信“FrankenPHP 自带持久化”这种说法。它和普通 PHP 容器一样，需要你手动指定挂载点。最简安全启动命令应包含：
docker run -d \ --name frankenphp-app \ -v caddy_data:/var/lib/caddy \ -v www_data:/var/www/html \ -p 80:80 -p 443:443 \ dunglas/frankenphp
注意：caddy_data 和 www_data 是命名卷名，不是宿主机路径。它们由 Docker 管理，重启/重建容器时数据自动保留。
立即学习“PHP免费学习笔记（深入）”；
- 首次运行前先创建卷：
docker volume create caddy_data和docker volume create www_data - 不要用
-v ./caddy_data:/var/lib/caddy这类绑定挂载，除非你明确要调试且能控制宿主机路径权限 - 确认挂载生效：
docker inspect frankenphp-app | grep -A 5 Mounts，看 Source 是否指向/var/lib/docker/volumes/xxx/_data
docker-compose.yml 中必须声明 volumes 且路径严格对齐
很多人写对了 volumes 字段，但漏掉一个致命细节：Caddy 镜像固化了证书存储路径为 /var/lib/caddy，FrankenPHP 官方镜像也继承此约定。挂载路径错一个字符，数据就落进可写层。
- 错误写法：
- ./caddy_data:/var/lib/cadd（少个 y）或- caddy_data:/var/lib/caddy/（末尾斜杠导致挂载失败） - 正确写法（docker-compose.yml 片段）：
volumes: - caddy_data:/var/lib/caddy - www_data:/var/www/html
- 验证是否挂载成功：
docker exec -it frankenphp-app ls -l /var/lib/caddy—— 输出应为空或含certificates/目录；若显示一堆文件但ls /var/lib/caddy/certificates报错，则说明挂载失败，数据仍在可写层
重建后发现数据丢了？三步紧急抢救
如果已经重建且没挂卷，现在看到的是全新容器，旧数据大概率还在旧卷里，但需人工捞取：
- 查旧容器 ID：
docker ps -a | grep frankenphp，找状态为Exited的上一个容器 - 进旧容器文件系统（不启动）：
docker export -o old-container.tar OLD_CONTAINER_ID，然后tar -tf old-container.tar | grep -E "(html|caddy)"看是否有残留 - 更可靠方式：直接查命名卷内容（如果你当初用了命名卷但没删）：
docker volume inspect caddy_data得到 Mountpoint 路径，然后ls -l /var/lib/docker/volumes/caddy_data/_data/certificates/查证书是否存在
真正容易被忽略的点是：FrankenPHP 不支持在 Caddyfile 里用 tls /path/to/cert.pem /path/to/key.pem 手动加载证书——它强制走 ACME。所以就算你把 PEM 文件拷进容器，也不会生效。唯一可靠的证书持久化方式，就是让 caddy_data 持久化，并确保它第一次申请成功后不再被覆盖。
