FrankenPHP 安装后如何设置开机自启服务-php教程-PHP中文网

frankenphp 无内置 windows 服务机制，需通过任务计划程序实现开机自启：配置“系统启动时”触发、延迟30秒、以最高权限运行、指定绝对路径和项目根目录为起始位置，并显式设置--workers参数。

frankenphp 安装后如何设置开机自启服务

FrankenPHP 本身没有内置 Windows 服务注册机制，也不能像 Apache 或 Nginx 那样直接用 sc create 注册为系统服务——它只是一个静态二进制，启动后即运行一个 Go+PHP 混合进程，不提供 --install-service 或类似参数。所以“开机自启”必须借助 Windows 原生机制间接实现，且需特别注意用户上下文、权限和工作目录问题。

Windows 下用任务计划程序启动 FrankenPHP

这是最稳定、兼容性最好、也最贴近实际使用场景的方式。FrankenPHP 启动依赖当前工作目录（尤其是 public/ 路径）、环境变量（如 SERVER_NAME）和可执行权限，任务计划能精确控制这些条件。

以管理员身份打开“任务计划程序”，点击右侧“创建任务”
在“常规”选项卡中：
- 勾选“不管用户是否登录都要运行” → 这样系统启动时就能拉起，但必须同时勾选“不存储密码”；否则会因缺少交互式会话而失败
- 勾选“使用最高权限运行” → 否则可能无法绑定 80/443 端口或读取证书目录
“触发器”设为“系统启动时”，并设置“延迟任务时间：30 秒” → 避开网络服务未就绪、Caddy 证书目录 /data 权限未初始化等问题
“操作”中添加一个“启动程序”：
- 程序或脚本：C:\path\to\frankenphp.exe（绝对路径，不能用相对路径或环境变量）
- 添加参数：php-server --workers=2（推荐显式加 --workers，避免默认行为在无终端时静默降级）
- 起始于：C:\your\project\root（必须填项目根目录，FrankenPHP 默认从当前目录找 public/）
“条件”选项卡中，取消勾选“只有在计算机使用交流电源时才启动此任务”（笔记本用户易踩坑）

为什么不能用 NSSM 或 sc create 封装 FrankenPHP

NSSM 和 sc create 本质是把可执行文件包装成 Windows Service，但 FrankenPHP 的运行模型与传统守护进程不同：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

它内部依赖 Go 的 net/http.Server 和 Caddy 的事件循环，对标准输入/输出、信号处理（如 SIGTERM）有定制逻辑；Windows 服务管理器发送的停止信号可能被忽略或导致 panic
服务账户（如 LocalSystem）默认无权访问用户目录下的 C:\Users\xxx\... 路径，而 FrankenPHP 的证书缓存、日志、public/ 都常放在这里
若强制注册，常见错误是服务状态显示“已启动”但端口未监听，查日志会看到 open /data: access is denied 或 listen tcp :443: bind: permission denied

Linux/macOS 上用 systemd 或 launchd 管理 FrankenPHP

类 Unix 系统更自然，但仍有细节要调准：

systemd 单元文件中，WorkingDirectory= 必须明确指向项目根目录，不能省略；否则 frankenphp php-server 会找不到 public/
需要设置 Environment=SERVER_NAME=example.com，否则 Caddy 自动 HTTPS 会失败（Let’s Encrypt 不接受 IP 或空域名）
若启用 worker 模式，建议加 Restart=on-failure 和 RestartSec=5，因为 PHP worker 崩溃时 FrankenPHP 主进程不一定退出，得靠健康检查兜底
macOS 使用 launchd 时，必须在 ProgramArguments 数组里把命令和参数拆开写，不能合并成单个字符串，否则 --workers=2 会被忽略