Workerman怎么实现开机自启?Linux配置Systemd教程

阿宇君_9026

阿宇君_9026

2026-05-22

672人浏览

原创

workerman必须用systemd实现可靠开机自启,因nohup和-d守护模式无法管理进程生命周期,systemd要求主进程前台运行(需--daemon=0)、type=simple、user非root、服务文件置于/etc/systemd/system/并执行daemon-reload。

workerman怎么实现开机自启?linux配置systemd教程

Workerman 必须用 systemd 实现可靠开机自启,nohup 或 crontab @reboot 都不行——它们不管理进程生命周期,崩溃不重启、重启后不拉起、无法联动依赖服务(比如 Redis 未就绪时 Workerman 就抢着启动)。

为什么不能用 nohup 或 -d 守护模式?

systemd 要求主进程前台运行,否则会立刻判定为“启动失败”并杀掉。Workerman 默认加 -d 或用 --daemon=1 启动时,主进程 fork 出子进程后自己就 exit 了,systemd 看不到有效进程,状态永远是 inactive (dead)。

  • 必须去掉 -d,改用 --daemon=0(新版)或 start -d=false(旧版)
  • Type=simple 是硬性要求,别写成 forking——后者是给传统 daemon(如 nginx、redis)用的,Workerman 不符合其 fork+父进程退出模型
  • 如果误配成 Type=forking,systemctl status 会显示 failed,且 journalctl 里看不到 PHP 错误,因为 systemd 根本没等子进程起来就放弃了

workerman.service 文件必须放对位置且重载

服务文件必须放在 /etc/systemd/system/ 下,不是 /lib/systemd/system/(那是包管理器专用路径,手动放这里 systemd 会忽略)。

Alpine Linux
Alpine Linux

获取最新发布版本;聚合最新版本架构

下载
  • 文件名必须以 .service 结尾,例如 workerman.service
  • 写完后必须执行 sudo systemctl daemon-reload,否则 systemctl start 会报 Unit workerman.service not found
  • 权限建议设为 644(sudo chmod 644 /etc/systemd/system/workerman.service),非可执行权限

关键配置项怎么填才不踩坑?

一个能跑通的最小可用配置核心就三处:用户、路径、启动命令。

  • User 必须是非 root 用户(如 www-data、nginx 或项目专属用户),否则 bind() 会因权限被拒,报 Permission denied
  • WorkingDirectory 设成项目根目录(如 /var/www/myapp),否则相对路径加载配置或日志会失败
  • ExecStart 的 PHP 路径必须用绝对路径(which php 查),脚本路径也必须绝对(如 /var/www/myapp/start.php),且末尾不能带 -d
  • Restart=always 必须加,但注意:它只在进程退出后触发;如果 start.php 因语法错误直接 fatal error 退出,systemd 不认为这是“崩溃”,不会重启,得靠 journalctl 查日志定位

启动失败时第一反应不是改配置,而是看日志

别反复 enable、start、stop,先盯住真实输出:

  • 实时日志:sudo journalctl -u workerman -f,按 Ctrl+C 退出
  • 最后一次启动的完整上下文:sudo journalctl -u workerman -n 50 --no-pager
  • 常见错误信号:code=exited, status=255 多半是 PHP 解析失败或扩展缺失;code=killed, signal=KILL 往往是 OOM 被系统干掉;Failed to start 且无后续日志,大概率是 ExecStart 命令路径写错或权限不足

最易被忽略的是 WorkingDirectory 权限和 User 的 home 目录可访问性——哪怕脚本本身没读写操作,PHP 启动时也会尝试访问用户 home 下的 .phpenv 或扩展配置,若不可达可能静默失败。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

linux workerman linux配置

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

3910

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3353

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2493

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

6050

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

5682

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

3333

8

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2023.07.20

2845

4

linux查看cpu使用率
linux查看cpu使用率

在linux的系统维护中,可能需要经常查看cpu使用率,分析系统整体的运行情况。本专题为大家带来了linux查看cpu使用率的相关文章,感兴趣的朋友千万不要错过了。

2023.07.25

3059

6

linux查找文件命令
linux查找文件命令

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.31

297

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习