如何在Linux中安装并配置Supervisor守护进程 Linux保持后台任务不死的方法

小伟吖_7142

小伟吖_7142

2026-06-01

1063人浏览

原创

supervisor能解决进程断ssh即挂、崩溃不自启问题,但需确保路径、权限、用户三者对齐:systemctl启动服务、修正socket路径为/var/run/supervisor.sock、配置中command用绝对路径、user存在且有权限、startsecs设为5-10、environment显式声明、配置文件按发行版放对应目录并以.conf或.ini结尾、reread后update生效。

如何在linux中安装并配置supervisor守护进程 linux保持后台任务不死的方法

Supervisor 能直接解决“进程后台运行但一断 SSH 就挂”“脚本崩溃后不自启”这类问题,但安装和配置稍有偏差就会卡在 supervisorctl 连不上、日志空白、或进程启动即退出——核心在于路径、权限、用户三处必须对齐。

用 apt/yum 安装后为什么 supervisorctl status 报 “Failed to connect”

这是最常见卡点:服务没真正跑起来,或 socket 文件路径/权限不匹配配置。

  • 先确认服务状态:sudo systemctl status supervisord,若显示 inactive (dead),说明没启动
  • systemd 系统(Ubuntu 16.04+/CentOS 7+)必须手动启动:sudo systemctl start supervisord,再 enable 开机自启
  • 检查主配置中 [unix_http_server] 的 file 路径,默认是 /tmp/supervisor.sock,但 /tmp 下的文件可能被系统清理;务必改成 /var/run/supervisor.sock 并确保目录存在且可写:sudo mkdir -p /var/run && sudo chmod 755 /var/run
  • 改完配置要重启服务:sudo systemctl restart supervisord,不能只 reload

[program:xxx] 配置里哪些参数最容易导致进程启动即退出

进程“闪退”不是程序本身问题,而是 Supervisor 启动时校验失败或环境缺失。

Linux Ai Server
Linux Ai Server

Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI,零 GUI 开销。

下载
  • command 必须是绝对路径,比如 python3 /home/user/app.py,不能写 python3 app.py(directory 不影响 command 解析)
  • user 指定的用户必须真实存在,且对该 command 路径、日志路径、工作目录有读/执行/写权限;用 root 虽快但不安全,建议建专用用户如 bot
  • startsecs 默认是 1 秒,如果程序冷启动慢(比如 Django 或某些 Python Web 框架),设太小会导致 Supervisor 认为“启动失败”而反复拉起;建议设为 5 或 10
  • 缺 environment 可能导致依赖环境变量的脚本失败,例如 PATH、PYTHONPATH 或项目专属变量,可显式加一行:environment=PATH="/usr/local/bin:/usr/bin:/bin"

配置文件放哪、怎么让 Supervisor 读到它

路径错或格式错,supervisorctl reread 就不会识别新配置。

  • Debian/Ubuntu 默认读 /etc/supervisor/conf.d/*.conf;CentOS/RHEL 默认读 /etc/supervisord.d/*.ini —— 注意后缀和目录名,不同发行版不互通
  • 文件名必须以 .conf 或 .ini 结尾,且不能有空格或特殊字符;内容开头不能有 BOM 或 UTF-8 签名
  • 写完配置后,分两步生效:sudo supervisorctl reread(扫描新文件)→ sudo supervisorctl update(载入并尝试启动)
  • 如果 update 后状态仍是 STARTING 或 FATAL,立刻查日志:sudo tail -20 /var/log/supervisor/supervisord.log,里面会明确报出是权限拒绝、命令找不到,还是用户不存在

为什么开了 web 界面却连不上,或登录后看不到进程

web 界面只是个前端代理,底层仍依赖 supervisord 正常运行和配置加载成功。

  • 启用 web 前,先确保 [inet_http_server] 段落已取消注释,并修改 port(别用 9001,避免冲突),username 和 password 必须设置
  • 防火墙要放行对应端口:sudo ufw allow 9111(假设你设的是 9111)
  • web 界面不显示进程,大概率是 supervisorctl update 没成功,或配置文件语法错误(比如漏了 =、多写了空格);可用 sudo supervisorctl status 在终端确认是否已识别
  • 浏览器访问时,URL 是 http://:9111,不是 localhost;如果用宝塔等面板,注意它可能屏蔽了非 80/443 端口的外网访问

真正麻烦的从来不是装不上,而是 supervisord 进程起来了,supervisorctl 也能连上,但你写的那个 [program] 就是起不来——这时候得盯死 supervisord.log 和你配的 stdout_logfile,90% 的问题藏在那两行报错里。

相关文章

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

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

下载

相关标签:

linux

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

相关专题

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

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

2023.06.21

4070

4

如何安装LINUX
如何安装LINUX

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

2023.06.29

3473

10

linux find
linux find

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

2023.06.30

2673

5

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

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

2023.07.05

6490

7

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

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

2023.07.06

6142

7

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

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

2023.07.20

3573

8

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

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

2023.07.20

3065

4

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

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

2023.07.25

3299

6

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

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

2023.07.31

297

3

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

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

共0课时 | 0人学习