FrankenPHP 本身不支持开机自启，需依赖系统服务管理机制：Linux 用 systemd（配置 User、WorkingDirectory、Restart 等），Windows 用 sc 命令注册服务，Docker 则靠 restart: always 及 Docker daemon 自启，并确保 Caddyfile 存在且可读。
FrankenPHP 本身不提供系统级服务注册能力，服务器重启后自动启动必须靠宿主操作系统的服务管理机制来保障——不是 FrankenPHP 自己“开机自启”，而是你把它包装进 systemd 或 Windows Service 后，由系统拉起。
Linux 下用 systemd 管理 FrankenPHP 进程
这是生产环境最稳妥的方式。FrankenPHP 二进制（如 frankenphp）本质是个长期运行的 Go 程序，适合交由 systemd 托管。
- 创建 service 文件：
/etc/systemd/system/frankenphp.service，内容类似：
[Unit] Description=FrankenPHP Server After=network.target [Service] Type=simple User=www-data WorkingDirectory=/var/www/myapp ExecStart=/usr/local/bin/frankenphp run --config /var/www/myapp/Caddyfile Restart=always RestartSec=5 Environment=SERVER_NAME=myapp.example.com [Install] WantedBy=multi-user.target
-
Restart=always确保进程意外退出时自动拉起；RestartSec=5避免频繁崩溃重试 - 务必指定
User和WorkingDirectory，否则 PHP worker 可能因权限或路径问题加载失败 - 执行
systemctl daemon-reload && systemctl enable frankenphp && systemctl start frankenphp，enable才能让它随系统启动
Windows 下注册为服务（需管理员权限）
FrankenPHP 官方不提供 Windows Service 封装，但可用 sc 命令手动注册，前提是使用完整路径且避免空格。
- 以管理员身份打开 CMD，执行：
sc create FrankenPHP binPath= "C:\frankenphp\frankenphp.exe run --config C:\frankenphp\Caddyfile" start= auto
-
binPath=后必须有空格，路径中不能含中文或空格（否则要用英文双引号包裹整个值） -
start= auto表示开机自启；若想延迟启动可改用start= delayed-auto - 注册后检查状态：
sc query FrankenPHP；启动失败时看sc qtriggerservice FrankenPHP或事件查看器中的系统日志 - 注意：Windows 上 FrankenPHP 不支持
watch: true（文件监听），所以代码更新仍需手动重启服务
Docker 环境下如何保证重启后恢复
如果你用 Docker 部署，自动启动逻辑不在 FrankenPHP 侧，而在容器编排层。
立即学习“PHP免费学习笔记（深入）”；
- 在
docker-compose.yaml中确保restart: always已设置（你已经在用） - 但要注意：
restart: always只对容器有效；如果宿主机重启，Docker daemon 自身需设为开机自启：
sudo systemctl enable docker
- 验证：
systemctl is-enabled docker应返回enabled - 别漏掉 volume 持久化 ——
caddy_data和caddy_config必须挂载，否则证书和配置会在容器重建后丢失
真正容易被忽略的是：FrankenPHP 启动依赖 Caddyfile 存在且语法正确，而 systemd 或 sc 注册的服务不会校验配置文件是否存在或是否可读。一旦 Caddyfile 被误删或权限错误，服务会静默失败，只在 journalctl 或 Windows 事件日志里留一行“failed to open config”。上线前务必手动执行一次 frankenphp run --config xxx 确认能跑通。
