Github 8.8K star，一款了不起的 Python 库--supervisor!

itomcoil 2025-08-05 18:53 5 浏览

大家好，今天为大家分享一个了不起的 Python 库 - supervisor。

Github地址：https://github.com/Supervisor/supervisor

Supervisor是一个功能强大的Python第三方库，专门用于在类Unix系统中管理和监控进程。该库采用客户端-服务器架构设计，提供了完整的进程生命周期管理功能，包括进程启动、停止、重启以及状态监控等核心能力。Supervisor的设计理念源于企业级应用对系统稳定性和可靠性的严格要求，能够确保关键业务进程在异常退出后自动重启，从而保障系统的持续运行。

安装

1、基础安装

Supervisor的安装过程需要考虑目标操作系统的特定要求。该库主要支持Linux和其他类Unix系统，不支持Windows平台。

# 通过pip安装Supervisor
pip install supervisor

# 在Ubuntu/Debian系统中通过apt安装
sudo apt-get install supervisor

# 在CentOS/RHEL系统中通过yum安装
sudo yum install supervisor

2、安装验证

安装完成后需要验证Supervisor的功能完整性和系统配置状态。验证过程包括检查主要组件的可用性、测试基本命令功能以及确认配置文件的正确性。

# 检查Supervisor版本信息
supervisord --version

# 生成默认配置文件
echo_supervisord_conf > /etc/supervisord.conf

# 启动Supervisor守护进程
sudo supervisord -c /etc/supervisord.conf

# 检查Supervisor状态
sudo supervisorctl status

主要特性

自动重启机制：监控进程状态并在异常退出时自动重启，确保服务连续性
Web管理界面：提供直观的Web控制台进行进程管理和状态监控
XML-RPC接口：支持远程管理和第三方系统集成
日志轮转管理：自动管理进程日志文件，防止磁盘空间溢出
进程组管理：支持将相关进程组织为逻辑组进行批量操作
资源限制控制：可设置进程的内存、CPU等资源使用限制
事件通知系统：支持进程状态变化事件的监听和处理

基本功能

1、配置文件管理

Supervisor的配置管理是其核心功能之一，通过标准的INI格式配置文件定义进程管理规则。配置文件采用分段结构，每个段落定义特定的功能模块或进程配置。合理的配置管理不仅能够确保进程的正确启动和运行，还能够提供灵活的管理策略和监控机制。

# 创建基础配置文件 /etc/supervisord.conf
[unix_http_server]
file=/var/run/supervisor.sock
chmod=0700

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

[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]
serverurl=unix:///var/run/supervisor.sock

# 示例应用程序配置
[program:webapp]
command=/usr/bin/python3 /opt/webapp/app.py
directory=/opt/webapp
user=webapp
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/supervisor/webapp.log

2、进程启动和管理

Supervisor提供了完整的进程生命周期管理功能，包括进程的启动、停止、重启以及状态查询等操作。

# 创建示例Web应用程序 /opt/webapp/app.py
import time
import logging
from http.server import HTTPServer, BaseHTTPRequestHandler

logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')


class RequestHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.send_header('Content-type', 'text/html')
        self.end_headers()

        response_content = f"""
        <html>
        <body>
            <h1>Supervisor管理的应用</h1>
            <p>当前时间: {time.strftime('%Y-%m-%d %H:%M:%S')}</p>
        </body>
        </html>
        """
        self.wfile.write(response_content.encode('utf-8'))
        logging.info(f"处理请求来自: {self.client_address[0]}")


def main():
    server = HTTPServer(('', 8090), RequestHandler)
    logging.info("Web服务器启动在端口 8090")
    server.serve_forever()


if __name__ == '__main__':
    main()

# 重新加载配置并启动进程
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start webapp
sudo supervisorctl status webapp

3、日志监控和管理

Supervisor内置了完善的日志管理系统，能够自动收集和管理被监控进程的输出日志。日志管理功能包括日志轮转、大小限制、备份保留等机制，确保系统在长期运行过程中不会因为日志文件过大而影响性能。

# 详细的日志配置示例
[program:data_processor]
command=/usr/bin/python3 /opt/tasks/processor.py
directory=/opt/tasks
user=tasks
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/supervisor/processor.log
stdout_logfile_maxbytes=50MB
stdout_logfile_backups=10
stderr_logfile=/var/log/supervisor/processor_error.log
stderr_logfile_maxbytes=10MB
stderr_logfile_backups=5

高级功能

1、进程组管理

Supervisor的进程组功能允许将相关的进程组织成逻辑单元进行统一管理。

# 微服务架构进程组配置示例
[program:api_gateway]
command=/usr/bin/python3 /opt/services/gateway/main.py
directory=/opt/services/gateway
user=services
autostart=true
autorestart=true
priority=100

[program:user_service]
command=/usr/bin/python3 /opt/services/user/main.py
directory=/opt/services/user
user=services
autostart=true
autorestart=true
priority=200

[group:microservices]
programs=api_gateway,user_service
priority=100

2、事件监听和通知

Supervisor提供了强大的事件系统，允许开发者编写自定义的事件监听器来响应进程状态变化。

# 事件监听器示例
import sys
import logging
from supervisor.childutils import listener

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger('ProcessMonitor')


def handle_event(headers, payload):
    process_name = headers['processname']
    from_state = headers['from_state']

    if headers.get('expected') == 'FATAL':
        logger.error(f"进程 {process_name} 启动失败: {from_state}")
        # 发送告警通知
    elif from_state == 'RUNNING':
        logger.warning(f"进程 {process_name} 异常退出")


def main():
    while True:  
        headers, payload = listener.wait(sys.stdin, sys.stdout)
        if headers['eventname'].startswith('PROCESS_STATE'):
            handle_event(headers, payload)
        listener.ok(sys.stdout)


if __name__ == '__main__':
    main()

总结

Supervisor作为Python生态系统中的企业级进程管理解决方案，通过其完善的功能特性和稳定的架构设计，为现代软件系统的运维管理提供了坚实的基础支撑。该库的核心价值体现在其对系统稳定性和可管理性的双重保障，使运维团队能够构建可靠的服务运行环境。通过统一的配置管理、灵活的进程控制和完善的监控机制，Supervisor有效降低了复杂系统的运维复杂度，提升了服务的可用性和可靠性。

python第三方库下载官网

上一篇：Github 1.2k star，一个好用的 Python 库-pyexcel!
下一篇：returns，一个超实用的 Python 库!

Github 8.8K star，一款了不起的 Python 库--supervisor!

安装

主要特性

基本功能

高级功能

总结

相关推荐

我用 1 个 2 手计算器换了 3 台 MacBook(上)

零基础也能搞定!DeepSeek大模型本地安装全攻略

Win7中同时安装python2和python3的方法

Python三目运算符(三元运算符)用法详解

PS零基础入门教程:Photoshop 2024工具详解—标尺工具

按颜色计数、求和、算平均值或最大值?学这个函数就够啦!

SpringBoot中使用LocalDateTime踩坑记录

中药古今研究:人参

「mysql第二次安装不了」mysql安装失败怎么清理干净?

最全的linux安装软件方法 linux安装软件流程