Debian使用Supervisor守护进程

Supervisor 进程管理配置完全指南:从安装到常用命令速查

如果你需要在服务器上托管多个进程(比如 Ss、V2Ray 或者自定义脚本),一个轻量级的进程管理工具是必不可少的。今天博主就来聊聊 Supervisor,它用起来比 Systemd 简单太多,非常适合管理这类常驻应用。本文将详细介绍 Supervisor 的安装、配置方法,并提供可直接套用的配置模板和常用命令速查。


目录


一、安装 Supervisor

Supervisor 的安装非常简单。执行以下命令即可完成安装,建议先更新软件源以避免依赖问题:

apt-get update && apt-get install supervisor -y

二、配置文件的正确姿势

Supervisor 的配置文件结构很清晰,主配置文件在 /etc/supervisor/supervisord.conf,一般情况下我们不需要修改它。

真正需要操作的是 /etc/supervisor/conf.d/ 目录。强烈建议为每个应用单独创建一个配置文件,比如为 Soga 脚本创建一个 soga.conf,这样做的好处是互不干扰,排查问题也更方便。

三、配置模板

下面是一份博主自用的配置模板,各位可以根据自己的实际情况修改路径和名称,直接套用即可:

[program:soga-ss]
command=/usr/local/soga/soga -c /etc/soga/soga-ss.conf
directory=/usr/local/soga/
user = root
stopsignal = INT
autostart = true
autorestart = true
startsecs = 1
stderr_logfile = /var/log/soga-ss.err.log

📌 参数说明:

  • command:你的启动命令,建议写绝对路径,避免环境变量问题。
  • directory:程序运行的工作目录,很多坑都是因为没设置这个导致的。
  • autostart / autorestart:设为 true 实现开机自启和崩溃自动重启,这才是使用 Supervisor 的核心目的。
  • stderr_logfile:错误日志路径,程序运行异常时记得先查看这里。

四、开机启动与启动服务

配置完成后,首先将 Supervisor 本身加入开机自启:

systemctl enable supervisor

然后启动 Supervisord 主进程:

supervisord -c /etc/supervisor/supervisord.conf

最后,把我们刚才配置的应用拉起来:

supervisorctl start all

五、常用命令速查

下面这几个命令是日常运维中使用频率最高的,建议复制保存到笔记里,以备随时查阅:

# 查看所有任务运行状态
supervisorctl status

# 新增或修改配置后,重新加载配置并重启
supervisorctl update
supervisorctl reload

# 单独重启某个程序
supervisorctl restart program_name

# 停止某个程序
supervisorctl stop program_name

# 关闭所有程序并退出Supervisor(慎用!)
supervisorctl shutdown

六、常见问题排查

如果程序启动失败,可以在终端输入 supervisorctl status 查看状态。如果看到 EXITEDFATAL,大概率是以下两个原因:

  • 命令写错了:路径、空格、大小写都要仔细检查,确保与实际文件路径一致。
  • 工作目录不对:检查 directory 参数设置的目录是否存在,且运行用户是否有足够的权限访问。

如果查看日志后仍然无法解决问题,欢迎在评论区留言,看到会第一时间回复。

觉得有用的话,记得收藏转发哦~

暂无评论

发送评论 编辑评论


上一篇
下一篇