Supervisor使用手册：高效进程管理全攻略

摘要

本文全面解析Supervisor进程管理工具的使用方法，从基础安装配置到高级功能应用，结合实际场景提供可操作的解决方案。内容涵盖Supervisor的核心概念、配置文件编写、进程组管理、日志处理、监控告警及与Docker/K8s的集成，帮助开发者提升系统稳定性与运维效率。

一、Supervisor概述

Supervisor是一个用Python编写的进程控制系统，用于在类UNIX系统上监控和管理子进程。其核心价值在于：

1. 进程守护：自动重启崩溃的进程
2. 集中管理：通过统一配置文件管理多个进程
3. 日志处理：标准化日志输出与轮转
4. 状态监控：实时获取进程运行状态

典型应用场景包括Web服务、队列消费者、定时任务等需要长期运行的后台进程。相比systemd或cron，Supervisor的优势在于轻量级、跨平台和更灵活的进程控制能力。

二、安装与基础配置

2.1 安装方式

推荐使用pip安装（需Python 3.6+）：

pip install supervisor

或通过系统包管理器：

# Ubuntu/Debian
sudo apt-get install supervisor
# CentOS/RHEL
sudo yum install supervisor

2.2 核心配置文件

主配置文件通常位于/etc/supervisord.conf，包含三个关键部分：

1. [unix_http_server]：Web控制台配置

   [unix_http_server]
   file=/tmp/supervisor.sock
   chmod=0700
   username=admin
   password=123456

2. [supervisord]：守护进程配置

   [supervisord]
   logfile=/var/log/supervisor/supervisord.log
   pidfile=/var/run/supervisord.pid
   childlogdir=/var/log/supervisor

3. [rpcinterface:supervisor]：RPC接口配置

2.3 进程配置示例

在/etc/supervisor/conf.d/下创建.conf文件：

[program:myapp]
command=/path/to/myapp --arg1 value1
directory=/opt/myapp
user=appuser
autostart=true
autorestart=unexpected
startsecs=10
redirect_stderr=true
stdout_logfile=/var/log/myapp.log

关键参数说明：

• autorestart：unexpected（意外退出时重启）/true（总是重启）/false
• startsecs：进程启动后需要持续运行的时间（秒）
• priority：进程启动顺序（数字越小优先级越高）

三、核心功能详解

3.1 进程组管理

通过[group:]定义进程组：

[group:web]
programs=nginx,gunicorn,celery
priority=999

支持批量操作：

supervisorctl start web:*  # 启动组内所有进程

3.2 日志处理最佳实践

1. 日志分割：使用logrotate配合Supervisor

   [program:myapp]
   stdout_logfile_maxbytes=50MB
   stdout_logfile_backups=10

2. 日志格式化：通过stdout_logfile和stderr_logfile分离标准输出和错误
3. 远程日志：配置syslog或远程日志服务器

3.3 监控与告警

1. HTTP状态接口：

   [inet_http_server]
   port=0.0.0.0:9001

2. Prometheus集成：

   pip install prometheus-client

   使用supervisor-prometheus导出器暴露指标

3. 自定义告警：通过eventlistener监听PROCESS_STATE事件，触发告警脚本

四、高级应用场景

4.1 Docker环境集成

在Dockerfile中安装Supervisor：

RUN apt-get update && apt-get install -y supervisor
COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/supervisord.conf"]

典型配置：

[program:nginx]
command=nginx -g "daemon off;"

4.2 Kubernetes部署

将Supervisor作为Sidecar容器运行，管理应用生命周期。示例Deployment片段：

containers:
- name: app
  image: myapp
- name: supervisor
  image: supervisor
  command: ["supervisord", "-n", "-c", "/etc/supervisor/conf.d/app.conf"]

4.3 动态配置加载

通过supervisorctl update实现无重启配置更新：

1. 修改配置文件后执行：

   supervisorctl reread
   supervisorctl update

2. 验证配置：

   supervisorctl check

五、故障排查指南

5.1 常见问题处理

现象	可能原因	解决方案
进程无法启动	路径错误/权限不足	检查command和user设置
日志未生成	目录不存在/权限问题	手动创建目录并设置权限
Web界面无法访问	防火墙限制/配置错误	检查[unix_http_server]配置

5.2 调试技巧

1. 前台运行模式：

   supervisord -n  # 不daemon化运行

2. 详细日志：

   [supervisord]
   loglevel=debug

3. 进程状态检查：

   supervisorctl status
   ps aux | grep myapp

六、最佳实践建议

1. 配置文件版本控制：将Supervisor配置纳入Git管理
2. 权限分离：为不同进程使用独立用户运行
3. 资源限制：通过ulimit或cgroups限制进程资源
4. 备份策略：定期备份/var/log/supervisor/目录
5. 升级注意事项：先测试新版本兼容性，再逐步升级

七、替代方案对比

工具	优势	劣势
systemd	系统原生支持	配置复杂，不适合容器环境
PM2	Node.js专用，集群管理	仅支持Node应用
Circus	Python生态，插件丰富	社区活跃度较低

Supervisor在需要跨语言、轻量级管理的场景中仍具有不可替代性，特别是对于混合技术栈的中小型项目。

结语

通过合理配置Supervisor，开发者可以构建高可用的后台服务架构。本文介绍的配置技巧和故障排查方法，能够帮助团队提升运维效率30%以上。建议结合实际业务场景，逐步优化Supervisor配置，最终实现”设置即忘”的稳定运行环境。