本文更新于2020-04-16。
安装
CentOS下安装
以CentOS 7.5 为例。
yum install supervisor
Debian下安装
以Debian 8.9 (jessie)为例。
apt install supervisor
如使用的apt源找不到相应的包，可参考以下步骤：
通过vi /etc/apt/sources.list修改apt源为：
deb http://mirrors.163.com/debian/ jessie main non-free contrib
deb http://mirrors.163.com/debian/ jessie-updates main non-free contrib
deb http://mirrors.163.com/debian/ jessie-backports main non-free contrib
deb http://mirrors.163.com/debian-security/ jessie/updates main non-free contrib
deb-src http://mirrors.163.com/debian/ jessie main non-free contrib
deb-src http://mirrors.163.com/debian/ jessie-updates main non-free contrib
deb-src http://mirrors.163.com/debian/ jessie-backports main non-free contrib
deb-src http://mirrors.163.com/debian-security/ jessie/updates main non-free contrib
然后执行apt update。如出现"[Waiting for headers]"，则需执行以下命令再重新运行apt update：
cd /var/lib/apt/lists
rm *
rm partial/*
再执行apt install supervisor。
开机启动
systemctl enable supervisord
配置
CentOS中的配置文件为/etc/supervisord.conf，配置文件目录为/etc/supervisord.d/，配置文件目录中的配置文件后缀为.ini。
Debian中的配置文件为/etc/supervisor/supervisord.conf，配置文件目录为/etc/supervisor/conf.d，配置文件目录中的配置文件后缀为.conf。
自定义服务的配置文件最好放于配置文件目录。每个配置文件可包含多个组，使用“;”开头进行注释。
program组
| 字段名 | 说明 | 备注 |
|---|---|---|
| [program:PROGRAM] | 被管理的程序名 | 可指定多个program组 |
| command=CMD | 执行的命令，可带参数 | |
| directory=DIR | 执行命令时的进程运行目录 | |
| autostart=AUTO | 是否自动启动 | 默认为true |
| autorestart=AUTO | 是否自动重启 | 为true、false或unexpected，默认为true。如为unexpected，当进程的退出码不为exitcodes中的值时重启 |
| exitcodes=CODE1,CODE2 | 允许的进程退出码 | 以“,”分隔，默认为0,2 |
| stopsignal=SIGNAL | 停止进程时发送的信号 | 默认为TERM |
| user=USER | 执行命令使用的系统用户 | |
| stdout_logfile=FILENAME | stdout的重定向日志文件 | |
| stderr_logfile=FILENAME | stderr的重定向日志文件 |
配置示例如下（各配置均已被注释）：
;[program:theprogramname]
;command=/bin/cat ; the program (relative uses PATH, can take args)
;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
;numprocs=1 ; number of processes copies to start (def 1)
;directory=/tmp ; directory to cwd to before exec (def no cwd)
;umask=022 ; umask for process (default None)
;priority=999 ; the relative start priority (default 999)
;autostart=true ; start at supervisord start (default: true)
;autorestart=true ; retstart at unexpected quit (default: true)
;startsecs=10 ; number of secs prog must stay running (def. 1)
;startretries=3 ; max # of serial start failures (default 3)
;exitcodes=0,2 ; 'expected' exit codes for process (default 0,2)
;stopsignal=QUIT ; signal used to kill process (default TERM)
;stopwaitsecs=10 ; max num secs to wait b4 SIGKILL (default 10)
;user=chrism ; setuid to this UNIX account to run the program
;redirect_stderr=true ; redirect proc stderr to stdout (default false)
;stdout_logfile=/a/path ; stdout log path, NONE for none; default AUTO
;stdout_logfile_maxbytes=1MB ; max # logfile bytes b4 rotation (default 50MB)
;stdout_logfile_backups=10 ; # of stdout logfile backups (default 10)
;stdout_capture_maxbytes=1MB ; number of bytes in 'capturemode' (default 0)
;stdout_events_enabled=false ; emit events on stdout writes (default false)
;stderr_logfile=/a/path ; stderr log path, NONE for none; default AUTO
;stderr_logfile_maxbytes=1MB ; max # logfile bytes b4 rotation (default 50MB)
;stderr_logfile_backups=10 ; # of stderr logfile backups (default 10)
;stderr_capture_maxbytes=1MB ; number of bytes in 'capturemode' (default 0)
;stderr_events_enabled=false ; emit events on stderr writes (default false)
;environment=A=1,B=2 ; process environment additions (def no adds)
;serverurl=AUTO ; override serverurl computation (childutils)
管理
下述，“|”表示使用左侧或右侧，“<>”表示其括起的内容可选，“{}”表示其括起的内容为一个整体，“...”表示重复之前的内容，“PROGRAM”为program组设置的程序名。
- supervisorctl：进入命令行交互界面，可直接输入子命令进行管理。
- supervisorctl reload：重新加载配置文件，并重启supervisord及所有自动启动的程序。
- supervisorctl restart all|{PROGRAM < ...>}：重启程序，all表示重启所有程序。
- supervisorctl start all|{PROGRAM <...>}：启动程序，all表示启动所有程序。
- supervisorctl status <all|{PROGRAM <...>}>：查看程序状态，如为all或不指定则查看所有程序状态。
- supervisorctl stop all|{PROGRAM <...>}：停止程序，all表示停止所有程序。
- supervisorctl update：重新加载配置文件，并启动新配置指定的程序。