前端修炼小册

Nginx 设置开机自启

# Nginx 设置开机自启

在生产环境中，如果我们的服务器意外重启，此时要是 Nginx 没有随服务器启动起来，我们的 Web 站点就会是无应答的状态，这会给我们带来不同程度损失。

因此我们需要设置 Nginx 开机自启。

# Ubuntu 设置开机自启

以下所有命令，如果你是 root 账户，直接执行即可，不是的话前面加 sudo 获取权限。

在 Ubuntu 和 Debian 下，我们通过 update-rc.d 设置 Nginx 的开机启动。

经实验，以下步骤适用于 Ubuntu 16.04、18.04、20.04 版本的系统。

# 创建启动脚本

在 Linux 系统的 /etc/init.d/ 目录下创建 nginx 文件：

vim /etc/init.d/nginx
1

往该文件内写入以下脚本内容（该脚本内容来自网络）：

#! /bin/sh
# chkconfig: 2345 55 25
# Description: Startup script for nginx webserver on Debian. Place in /etc/init.d and
# run 'update-rc.d -f nginx defaults', or use the appropriate command on your
# distro. For CentOS/Redhat run: 'chkconfig --add nginx'

### BEGIN INIT INFO
# Provides:          nginx
# Required-Start:    $all
# Required-Stop:     $all
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: starts the nginx web server
# Description:       starts nginx using start-stop-daemon
### END INIT INFO

# Author:   licess
# website:  http://lnmp.org

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
NAME=nginx
NGINX_BIN=/usr/local/nginx/sbin/$NAME
CONFIGFILE=/usr/local/nginx/conf/$NAME.conf
PIDFILE=/usr/local/nginx/logs/$NAME.pid

case "$1" in
    start)
        echo -n "Starting $NAME... "

        if netstat -tnpl | grep -q nginx;then
            echo "$NAME (pid `pidof $NAME`) already running."
            exit 1
        fi

        $NGINX_BIN -c $CONFIGFILE

        if [ "$?" != 0 ] ; then
            echo " failed"
            exit 1
        else
            echo " done"
        fi
        ;;

    stop)
        echo -n "Stoping $NAME... "

        if ! netstat -tnpl | grep -q nginx; then
            echo "$NAME is not running."
            exit 1
        fi

        $NGINX_BIN -s stop

        if [ "$?" != 0 ] ; then
            echo " failed. Use force-quit"
            exit 1
        else
            echo " done"
        fi
        ;;

    status)
        if netstat -tnpl | grep -q nginx; then
            PID=`pidof nginx`
            echo "$NAME (pid $PID) is running..."
        else
            echo "$NAME is stopped"
            exit 0
        fi
        ;;

    force-quit)
        echo -n "Terminating $NAME... "

        if ! netstat -tnpl | grep -q nginx; then
            echo "$NAME is not running."
            exit 1
        fi

        kill `pidof $NAME`

        if [ "$?" != 0 ] ; then
            echo " failed"
            exit 1
        else
            echo " done"
        fi
        ;;

    restart)
        $0 stop
        sleep 1
        $0 start
        ;;

    reload)
        echo -n "Reload service $NAME... "

        if netstat -tnpl | grep -q nginx; then
            $NGINX_BIN -s reload
            echo " done"
        else
            echo "$NAME is not running, can't reload."
            exit 1
        fi
        ;;

    configtest)
        echo -n "Test $NAME configure files... "

        $NGINX_BIN -t
        ;;

    *)
        echo "Usage: $0 {start|stop|force-quit|restart|reload|status|configtest}"
        exit 1
        ;;

esac
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

# 修改部分参数

如果你的 Nginx 是通过编译安装的，则需要根据实际安装时的设置，修改启动脚本中的几个参数：

# 如果是按照我方式编译安装的，则不用修改，默认参数值就是我的实际安装位置
NGINX_BIN=/usr/local/nginx/sbin/$NAME
CONFIGFILE=/usr/local/nginx/conf/$NAME.conf
PIDFILE=/usr/local/nginx/logs/$NAME.pid
1
2
3
4

# 添加执行权限

上述脚本保存为 /etc/init.d/nginx，然后设置文件的执行权限：

# 给所有用户给予可执行权限
chmod a+x /etc/init.d/nginx
1
2

至此就可以通过下面指令控制 Nginx 的启动、停止和重新加载了：

# 启动
/etc/init.d/nginx start

# 停止
/etc/init.d/nginx stop

# 重新加载配置
/etc/init.d/nginx reload
1
2
3
4
5
6
7
8

# 添加至开机自启动

现在将 Nginx 服务加入开机自启动：

# 设置开机启动
sudo update-rc.d nginx defaults

# 启动 Nginx
sudo /etc/init.d/nginx start
1
2
3
4
5

当然了，如果需要关闭开机启动的功能：

# 取消开机启动
sudo update-rc.d -f nginx remove
1
2

# CentOS 6.x 设置开机自启

以下所有命令，如果你是 root 账户，直接执行即可，不是的话前面加 sudo 获取权限。

# 创建启动脚本

在 Linux 系统的 /etc/init.d/ 目录下创建 nginx 文件：

vim /etc/init.d/nginx
1

往该文件内写入以下脚本内容（该脚本内容来自官方网站 - Red Hat NGINX Init Script (opens new window)）：

#!/bin/sh
#
# nginx - this script starts and stops the nginx daemon
#
# chkconfig:   - 85 15
# description:  NGINX is an HTTP(S) server, HTTP(S) reverse \
#               proxy and IMAP/POP3 proxy server
# processname: nginx
# config:      /etc/nginx/nginx.conf
# config:      /etc/sysconfig/nginx
# pidfile:     /var/run/nginx.pid

# Source function library.
. /etc/rc.d/init.d/functions

# Source networking configuration.
. /etc/sysconfig/network

# Check that networking is up.
[ "$NETWORKING" = "no" ] && exit 0

nginx="/usr/sbin/nginx"
prog=$(basename $nginx)

NGINX_CONF_FILE="/etc/nginx/nginx.conf"

[ -f /etc/sysconfig/nginx ] && . /etc/sysconfig/nginx

lockfile=/var/lock/subsys/nginx

make_dirs() {
   # make required directories
   user=`$nginx -V 2>&1 | grep "configure arguments:.*--user=" | sed 's/[^*]*--user=\([^ ]*\).*/\1/g' -`
   if [ -n "$user" ]; then
      if [ -z "`grep $user /etc/passwd`" ]; then
         useradd -M -s /bin/nologin $user
      fi
      options=`$nginx -V 2>&1 | grep 'configure arguments:'`
      for opt in $options; do
          if [ `echo $opt | grep '.*-temp-path'` ]; then
              value=`echo $opt | cut -d "=" -f 2`
              if [ ! -d "$value" ]; then
                  # echo "creating" $value
                  mkdir -p $value && chown -R $user $value
              fi
          fi
       done
    fi
}

start() {
    [ -x $nginx ] || exit 5
    [ -f $NGINX_CONF_FILE ] || exit 6
    make_dirs
    echo -n $"Starting $prog: "
    daemon $nginx -c $NGINX_CONF_FILE
    retval=$?
    echo
    [ $retval -eq 0 ] && touch $lockfile
    return $retval
}

stop() {
    echo -n $"Stopping $prog: "
    killproc $prog -QUIT
    retval=$?
    echo
    [ $retval -eq 0 ] && rm -f $lockfile
    return $retval
}

restart() {
    configtest || return $?
    stop
    sleep 1
    start
}

reload() {
    configtest || return $?
    echo -n $"Reloading $prog: "
    killproc $prog -HUP
    retval=$?
    echo
}

force_reload() {
    restart
}

configtest() {
  $nginx -t -c $NGINX_CONF_FILE
}

rh_status() {
    status $prog
}

rh_status_q() {
    rh_status >/dev/null 2>&1
}

case "$1" in
    start)
        rh_status_q && exit 0
        $1
        ;;
    stop)
        rh_status_q || exit 0
        $1
        ;;
    restart|configtest)
        $1
        ;;
    reload)
        rh_status_q || exit 7
        $1
        ;;
    force-reload)
        force_reload
        ;;
    status)
        rh_status
        ;;
    condrestart|try-restart)
        rh_status_q || exit 0
            ;;
    *)
        echo $"Usage: $0 {start|stop|status|restart|condrestart|try-restart|reload|force-reload|configtest}"
        exit 2
esac
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

# 修改部分参数

如果你的 Nginx 是通过编译安装的，则需要根据实际安装时的设置，修改启动脚本中的两个参数（大约在第 22 行和第 25 行）：

# 修改成 Nginx 执行程序的路径，例如我的一般是：/usr/local/nginx/sbin/nginx
nginx="/usr/sbin/nginx"

# 修改成配置文件的路径，例如我的一般是：/usr/local/nginx/conf/nginx.conf
NGINX_CONF_FILE="/etc/nginx/nginx.conf"
1
2
3
4
5

还需要修改 PID 文件路径，大约在启动脚本中的第 11 行可以看到被注释的默认路径，在下面加一行，手动指定成和 nginx.conf 文件中的 PID 路径一致即可：

设置成和 nginx.conf 中一致。例如我的一般是：/usr/local/nginx/logs/nginx.pid
# pidfile:     /var/run/nginx.pid
pidfile:     /usr/local/nginx/logs/nginx.pid
1
2
3

# 添加执行权限

上述脚本保存为 /etc/init.d/nginx，然后设置文件的执行权限：

# 给所有用户给予可执行权限
chmod a+x /etc/init.d/nginx
1
2

至此就可以通过下面指令控制 Nginx 的启动、停止和重新加载了：

# 启动
/etc/init.d/nginx start

# 停止
/etc/init.d/nginx stop

# 重新加载配置
/etc/init.d/nginx reload
1
2
3
4
5
6
7
8

# 添加至开机自启动

现在将 Nginx 服务加入 chkconfig 管理列表：

# 添加 Nginx 启动脚本为 chkconfig 管理的一个服务
chkconfig --add /etc/init.d/nginx

# 将 Nginx 加入开机自启
chkconfig /etc/init.d/nginx on
1
2
3
4
5

当然了，如果需要关闭开机启动的功能：

# 查看该服务进程状态
chkconfig --list nginx

# 关闭 Nginx 开机自启
chkconfig /etc/init.d/nginx off

# 删除 chkconfig 管理的的 Nginx 启动服务（如果确实不需要了）
chkconfig --del /etc/init.d/nginx
1
2
3
4
5
6
7
8

# 开机自启脚本提供的快捷命令

通过 Nginx 开机自启脚本本身提供了一些 Nginx 常用操作的快捷命令，一旦我们通过这个脚本实现开机自启后，就可以通过这些快捷命令来操作 Nginx 了：

# 启动 Nginx
/etc/init.d/nginx start

# 重新加载 Nginx 配置
/etc/init.d/nginx reload

# 停止 Nginx
/etc/init.d/nginx stop
1
2
3
4
5
6
7
8

这些命令通过看脚本代码就能找到。

# CentOS 7.x 设置开机自启

以下所有命令，如果你是 root 账户，直接执行即可，不是的话前面加 sudo 获取权限。

在 CentOS 7.x 版本的系统开始，就不太好通过 chkconfig + Red Hat NGINX Init Script (opens new window) 的方式来设置 Nginx 的开机启动了。

因为会留下了一个 bug：通过 /etc/init.d/nginx 脚本方式来控制 Nginx 的启动、停止时，start 一直卡着（实际端口是开启了，必须通过 Ctrl + C 强制关闭），stop 不生效（提示成功，但是端口没关闭）。

那么对于 CentOS 7.x 系统，可以通过 systemd 来管理 Nginx。

# 建立服务文件

新建文件：

vim /usr/lib/systemd/system/nginx.service
1

往该文件内写入以下内容（内容模版参考官网 NGINX systemd service file (opens new window)）：

[Unit]
Description=The NGINX HTTP and reverse proxy server
After=syslog.target network-online.target remote-fs.target nss-lookup.target
Wants=network-online.target

[Service]
Type=forking
PIDFile=/run/nginx.pid
ExecStartPre=/usr/sbin/nginx -t
ExecStart=/usr/sbin/nginx
ExecReload=/usr/sbin/nginx -s reload
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

文件内容解释：

[Unit]:服务的说明
Description:描述服务
After:描述服务类别

[Service]服务运行参数的设置
Type=forking是后台运行的形式
ExecStart为服务的具体运行命令
ExecReload为重启命令
ExecStop为停止命令
PrivateTmp=True表示给服务分配独立的临时空间
注意：启动、重启、停止命令全部要求使用绝对路径

[Install]服务安装的相关设置，可设置为多用户
1
2
3
4
5
6
7
8
9
10
11
12
13

# 修改部分参数

如果你的 Nginx 是通过编译安装的，则需要根据实际安装时的设置，修改文件中的部分参数，修改后的示例如下：

[Unit]
Description=The NGINX HTTP and reverse proxy server
After=syslog.target network-online.target remote-fs.target nss-lookup.target
Wants=network-online.target

[Service]
Type=forking
PIDFile=/usr/local/nginx/logs/nginx.pid
ExecStartPre=/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf
ExecStart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
ExecReload=/usr/local/nginx/sbin/nginx -s reload
ExecStop=/usr/local/nginx/sbin/nginx -s quit
PrivateTmp=true

[Install]
WantedBy=multi-user.target
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 添加执行权限

给上述文件添加执行权限：

chmod +x /usr/lib/systemd/system/nginx.service
1

# 添加至开机自启动

设置开机自启动：

systemctl enable nginx.service
1

# Nginx 服务管理

此时可以使用一些快捷命令进行 Nginx 服务管理：

# Nginx 启动
systemctl start nginx.service

# 查看 Nginx 服务当前状态
systemctl status nginx.service

# Nginx 重载
systemctl reload nginx.service

# Nginx 停止
systemctl stop nginx.service

# 重新启动 Nginx 服务
systemctl restart nginx.service

# 停止 Nginx 的开机自启动
systemctl disable nginx.service
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

Nginx 启动日志查看：

journalctl -f -u nginx.service
1

# systemd 提供的一些命令

查看所有已启动的服务：

systemctl list-units --type=service
1

命令集合：

# 查看所有开机启动项
systemctl list-unit-files --type=service | grep enabled

# 查询服务是否开机启动
systemctl is-enabled servicename.service

# 开机运行服务
systemctl enable *.service

# 取消开机运行
systemctl disable *.service

# 启动服务
systemctl start *.service

# 停止服务
systemctl stop *.service

# 重启服务
systemctl restart *.service

# 重新加载服务配置文件
systemctl reload *.service

# 查询服务运行状态
systemctl status *.service

# 显示启动失败的服务
systemctl --failed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

注：* 代表某个服务的名字，如 http 的服务名为 httpd。

# 参考资料

（完）

Nginx 配置文件详解