Nginx 设置开机自启

keyL-liucong2022年11月16日大约 8 分钟

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

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

#! /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

修改部分参数

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

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

添加执行权限

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

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

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

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

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

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

添加至开机自启动

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

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

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

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

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

CentOS 6.x 设置开机自启

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

创建启动脚本

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

vim /etc/init.d/nginx

往该文件内写入以下脚本内容（该脚本内容来自官方网站 - Red Hat NGINX Init Scriptopen in 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

修改部分参数

如果你的 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"

还需要修改 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

添加执行权限

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

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

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

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

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

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

添加至开机自启动

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

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

# 将 Nginx 加入开机自启
chkconfig /etc/init.d/nginx on

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

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

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

# 删除 chkconfig 管理的的 Nginx 启动服务（如果确实不需要了）
chkconfig --del /etc/init.d/nginx

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

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

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

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

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

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

CentOS 7.x 设置开机自启

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

在 CentOS 7.x 版本的系统开始，就不太好通过 chkconfig + Red Hat NGINX Init Scriptopen in 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

往该文件内写入以下内容（内容模版参考官网 NGINX systemd service fileopen in 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

文件内容解释：

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

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

[Install]服务安装的相关设置，可设置为多用户

修改部分参数

如果你的 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

添加执行权限

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

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

添加至开机自启动

设置开机自启动：

systemctl enable nginx.service

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

Nginx 启动日志查看：

journalctl -f -u nginx.service

systemd 提供的一些命令

查看所有已启动的服务：

systemctl list-units --type=service

命令集合：

# 查看所有开机启动项
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

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

参考文档

Systemd 入门教程：命令篇open in new window

Nginx 设置开机自启

# Nginx 设置开机自启

# Ubuntu 设置开机自启

# 创建启动脚本

# 修改部分参数

# 添加执行权限

# 添加至开机自启动

# CentOS 6.x 设置开机自启

# 创建启动脚本

# 修改部分参数

# 添加执行权限

# 添加至开机自启动

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

# CentOS 7.x 设置开机自启

# 建立服务文件

# 修改部分参数

# 添加执行权限

# 添加至开机自启动

# Nginx 服务管理

# systemd 提供的一些命令

# 参考文档

Nginx 设置开机自启

Ubuntu 设置开机自启

创建启动脚本

修改部分参数

添加执行权限

添加至开机自启动

CentOS 6.x 设置开机自启

创建启动脚本

修改部分参数

添加执行权限

添加至开机自启动

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

CentOS 7.x 设置开机自启

建立服务文件

修改部分参数

添加执行权限

添加至开机自启动

Nginx 服务管理

systemd 提供的一些命令

参考文档