Linux 进程守护神：Supervisor 从入门到精通

一、Supervisor 是什么？#

Supervisor 是一个用 Python 编写的 Linux 进程管理与守护工具，主要用于：

• 启动、停止、重启进程

• 监控进程运行状态

• 进程异常退出后自动拉起

• 统一管理多个后台服务

Supervisor 本身不是服务框架，而是服务的“看门狗”。

二、为什么要用 Supervisor？#

相比于直接 nohup、 & 或 screen / tmux，Supervisor 的优势非常明显：

适合场景：

• 多个自写服务（爬虫、API、Bot）

• Python / Node / Go / Java 应用

• Docker 容器内部进程管理

可以参考用 Proxmox VE 管理多台 Docker 主机。

三、Supervisor 的核心组成#

Supervisor 主要由三部分组成：

1. supervisord后台运行的守护进程，负责真正管理子进程

2. supervisorctl命令行管理工具，用于控制进程

3. 配置文件定义要守护的程序及其行为规则

四、Supervisor 安装#

1
sudo apt update
2
sudo apt install supervisor

1
sudo dnf install supervisor

1
supervisord --version

1
pip install supervisor

1
supervisord

五、Supervisor 配置文件结构#

主配置文件通常在：

1
/etc/supervisor/supervisord.conf

常见子配置目录：

1
/etc/supervisor/conf.d/

**推荐做法：**一个服务一个 .conf 文件

六、最基础的进程守护示例#

以一个 Python 脚本为例：

1
/home/app/test.py

1
import time
2

3
while True:
4
    print("running...")
5
    time.sleep(5)

1
/etc/supervisor/conf.d/test.conf

1
[program:test_app]
2
command=python3 /home/app/test.py
3
directory=/home/app
4
autostart=true
5
autorestart=true
6
startsecs=3
7
stderr_logfile=/var/log/test_app.err.log
8
stdout_logfile=/var/log/test_app.out.log

1
sudo supervisorctl reread
2
sudo supervisorctl update
3
sudo supervisorctl start test_app

七、常用配置项说明（重点）#

八、supervisorctl 常用命令#

1
supervisorctl status        # 查看所有进程状态
2
supervisorctl start xxx     # 启动进程
3
supervisorctl stop xxx      # 停止进程
4
supervisorctl restart xxx   # 重启进程
5
supervisorctl reload        # 重载全部配置

九、在 Docker 中使用 Supervisor#

Supervisor 非常适合 容器内管理多个进程。

Dockerfile 示例：

1
RUN apt install -y supervisor
2
COPY supervisord.conf /etc/supervisor/supervisord.conf
3

4
CMD ["supervisord", "-n"]

注意：

• -n 表示前台运行（Docker 必须）

• 不要再额外 service start

十、Supervisor vs systemd#

结论：

• 服务器应用管理 → Supervisor

• 系统服务 / 守护进程 → systemd

十一、常见坑与注意事项#

1
sudo chown -R appuser /var/log/

1
supervisorctl reread
2
supervisorctl update

结语#

Supervisor 是一个简单、稳定、低心智负担的 Linux 进程守护方案，

非常适合：

• 个人服务器

• 自托管服务

• Docker 容器

• 小型后端项目

如果你已经用腻了 nohup，那 Supervisor 基本就是必学工具。

延伸阅读#

• Docker 换源避坑指南 — 部署前的必备准备
• Nginx Proxy Manager 反代面板 — 统一管理所有服务的访问入口
• Uptime Kuma 自建服务监控 — 所有服务状态一目了然