Supervisor使用手册：进程管理实战指南

一、Supervisor概述与核心价值

Supervisor是一个基于Python开发的进程控制系统，专为Linux/Unix环境设计，通过守护进程的方式管理应用程序的生命周期。其核心价值体现在三个方面：

1. 进程守护：自动重启崩溃的进程，确保服务持续可用
2. 资源隔离：通过配置文件精确控制每个进程的CPU/内存使用
3. 统一管理：支持批量启动/停止/重启多个服务

典型应用场景包括：Web服务器集群管理、定时任务守护、微服务架构中的进程编排。相较于systemd等系统级工具，Supervisor的优势在于轻量级架构和跨平台兼容性，特别适合容器化部署前的进程管理需求。

二、安装与基础配置

2.1 安装方式

推荐使用pip安装最新稳定版：

pip install supervisor
# 或通过系统包管理器
# Ubuntu/Debian
sudo apt-get install supervisor
# CentOS/RHEL
sudo yum install supervisor

安装完成后验证版本：

echo_supervisord_conf --version
# 应输出类似：4.2.4

2.2 配置文件结构

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

[unix_http_server]
file=/tmp/supervisor.sock   ; 通信套接字
chmod=0700                  ; 权限控制
[supervisord]
logfile=/var/log/supervisor/supervisord.log ; 主日志
pidfile=/var/run/supervisord.pid             ; PID文件
[include]
files = /etc/supervisor/conf.d/*.conf        ; 子配置目录

建议将应用配置拆分到/etc/supervisor/conf.d/目录下，每个服务一个.conf文件。

三、核心功能详解

3.1 进程组管理

通过[program:x]定义单个进程，[group:x]实现分组控制：

[program:nginx]
command=/usr/sbin/nginx -c /etc/nginx/nginx.conf
autostart=true
autorestart=unexpected
startsecs=5
user=nginx
redirect_stderr=true
stdout_logfile=/var/log/nginx/supervisor.log
[group:webservers]
programs=nginx,php-fpm
priority=999

关键参数说明：

• autorestart：unexpected（异常退出时重启）/true（总是重启）/false
• startsecs：进程启动后持续运行秒数才视为成功
• priority：进程启动顺序（数值越小优先级越高）

3.2 事件通知机制

配置事件监听器实现自定义处理：

[eventlistener:my_listener]
command=/path/to/listener.py
events=PROCESS_STATE_EXITED,PROCESS_STATE_RUNNING
buffer_size=10

示例Python监听器：

import sys
def run():
    while True:
        line = sys.stdin.readline()
        if line.startswith('EVENT'):
            event_data = eval(line[6:])
            if event_data['eventname'] == 'PROCESS_STATE_EXITED':
                print(f"Process {event_data['processname']} exited")
        sys.stdout.flush()

3.3 日志管理策略

推荐使用rotating日志模式防止日志文件过大：

[program:app]
command=/path/to/app
stdout_logfile=/var/log/app.log
stdout_logfile_maxbytes=10MB
stdout_logfile_backups=10

对于高并发服务，建议配置异步日志写入：

[program:high_io]
command=/path/to/service
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0  ; 禁用文件轮转
redirect_stderr=true

四、高级运维技巧

4.1 进程依赖管理

通过priority参数和startsecs实现依赖控制：

[program:db]
command=/usr/bin/mysqld
priority=10
[program:app]
command=/path/to/app
priority=20
startsecs=10  ; 等待db启动10秒后再启动

4.2 资源限制配置

结合ulimit和environment控制进程资源：

[program:resource_intensive]
command=/path/to/app
environment=HOME=/var/app,USER=appuser
umask=022
startsecs=30

4.3 安全加固方案

1. 禁用HTTP服务器（如不需要Web界面）：

   [unix_http_server]
   file=/tmp/supervisor.sock

2. 配置最小权限运行：

   sudo useradd -r -s /bin/false supervisor
   sudo chown supervisor:supervisor /var/log/supervisor/

3. 使用SELinux/AppArmor限制权限

五、故障排查指南

5.1 常见问题处理

现象	可能原因	解决方案
进程无法启动	路径错误	检查command绝对路径
频繁重启	内存不足	调整startsecs或优化应用
配置不生效	语法错误	使用supervisord check验证

5.2 调试技巧

1. 前台运行模式：

   supervisord -n -c /etc/supervisord.conf

2. 详细日志模式：

   [supervisord]
   logfile_maxbytes=0  ; 禁用轮转
   loglevel=debug

3. 进程状态检查：

   supervisorctl status
   # 输出示例：
   # nginx                          RUNNING   pid 1234, uptime 023

六、最佳实践建议

1. 配置版本控制：将配置文件纳入Git管理
2. 监控集成：通过Prometheus的Node Exporter采集Supervisor指标

3. 容器化适配：在Docker中运行时挂载配置卷：

   VOLUME ["/etc/supervisor/conf.d"]
   CMD ["/usr/bin/supervisord", "-c", "/etc/supervisord.conf"]

4. 灾难恢复：配置nodaemon=true用于调试环境

5. 性能优化：对于大量进程，调整minfds和minprocs参数

通过系统化的配置管理和实时监控，Supervisor能够有效提升服务可用性。建议结合Ansible等工具实现配置的自动化部署，构建标准化的进程管理平台。