Nginx安装与部署

下载Nginx

Nginx官网：http://nginx.org/en/download.html。网页提供了Nginx三种版本下载：开发版（Mainline Version）、稳定版（Stable Version）和过期版（Legacy Version）。Nignx提供Linux和Windows版本，这里使用的是Linux版本。此外，http://nginx.org/download/提供了所有版本的Nginx下载。

Nginx源码的编译需要GCC编译器：

# gcc --version
gcc (Ubuntu 5.4.0-6ubuntu1~16.04.4) 5.4.0 20160609
Copyright (C) 2015 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

 

 

截止2017年10月15日，Nginx最新稳定版为1.12.2，下载并解压：

# mkdir nginx-download
# cd nginx-download/
# wget http://nginx.org/download/nginx-1.12.2.tar.gz
# tar -zxvf nginx-1.12.2.tar.gz 
# cd nginx-1.12.2
# ll
total 732
drwxr-xr-x 8 1001 1001   4096 Oct 17 21:16 ./
drwxr-xr-x 3 root root   4096 Oct 26 14:05 ../
-rw-r--r-- 1 1001 1001 278202 Oct 17 21:16 CHANGES
-rw-r--r-- 1 1001 1001 423948 Oct 17 21:16 CHANGES.ru
-rw-r--r-- 1 1001 1001   1397 Oct 17 21:16 LICENSE
-rw-r--r-- 1 1001 1001     49 Oct 17 21:16 README
drwxr-xr-x 6 1001 1001   4096 Oct 26 14:05 auto/
drwxr-xr-x 2 1001 1001   4096 Oct 26 14:05 conf/
-rwxr-xr-x 1 1001 1001   2481 Oct 17 21:16 configure*
drwxr-xr-x 4 1001 1001   4096 Oct 26 14:05 contrib/
drwxr-xr-x 2 1001 1001   4096 Oct 26 14:05 html/
drwxr-xr-x 2 1001 1001   4096 Oct 26 14:05 man/
drwxr-xr-x 9 1001 1001   4096 Oct 26 14:05 src/

 

• src目录下存放了Nginx的源代码；

• man目录下存放了Nginx的帮助文档；

• html目录存放了两个HTML文件，分别为Nginx欢迎页和异常页面；

• logs目录用于存放Nginx运行日志；

• auto目录存放了大量的脚本文件，和configure脚本有关；

• configure文件为Nginx的自动脚本程序。

Nginx编译与安装

在解压路径下，运行命令./configure --prefix=/nginx（configure脚本支持的选项可参考附录）配置Nginx的安装目录并生成Makefile文件：

# ./configure --prefix=/nginx
...
Configuration summary
  + using system PCRE library
  + OpenSSL library is not used
  + using system zlib library
​
  nginx path prefix: "/nginx"
  nginx binary file: "/nginx/sbin/nginx"
  nginx modules path: "/nginx/modules"
  nginx configuration prefix: "/nginx/conf"
  nginx configuration file: "/nginx/conf/nginx.conf"
  nginx pid file: "/nginx/logs/nginx.pid"
  nginx error log file: "/nginx/logs/error.log"
  nginx http access log file: "/nginx/logs/access.log"
  nginx http client request body temporary files: "client_body_temp"
  nginx http proxy temporary files: "proxy_temp"
  nginx http fastcgi temporary files: "fastcgi_temp"
  nginx http uwsgi temporary files: "uwsgi_temp"
  nginx http scgi temporary files: "scgi_temp"

 

过程中可能出现一些依赖库缺失问题，可参考下面的常见问题。生成了Makefile文件后，使用make命令进行编译：

# make
make -f objs/Makefile
make[1]: Entering directory '/temp/nginx-download/nginx-1.12.2'
cc -c -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g  -I src/core -I src/event -I src/event/modules -I src/os/unix -I objs 
    -o objs/src/core/nginx.o 
    src/core/nginx.c
cc -c -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g  -I src/core -I src/event -I src/event/modules -I src/os/unix -I objs 
...
objs/src/http/modules/ngx_http_upstream_keepalive_module.o 
objs/src/http/modules/ngx_http_upstream_zone_module.o 
objs/ngx_modules.o 
-ldl -lpthread -lcrypt -lpcre -lz 
-Wl,-E
sed -e "s|%%PREFIX%%|/nginx|" 
    -e "s|%%PID_PATH%%|/nginx/logs/nginx.pid|" 
    -e "s|%%CONF_PATH%%|/nginx/conf/nginx.conf|" 
    -e "s|%%ERROR_LOG_PATH%%|/nginx/logs/error.log|" 
    < man/nginx.8 > objs/nginx.8
make[1]: Leaving directory '/temp/nginx-download/nginx-1.12.2'

 

编译顺利完成后，接着使用make install命令进行安装：

# make install
make -f objs/Makefile install
make[1]: Entering directory '/temp/nginx-download/nginx-1.12.2'
test -d '/nginx' || mkdir -p '/nginx'
test -d '/nginx/sbin' 
    || mkdir -p '/nginx/sbin'
...
test -d '/nginx/logs' 
    || mkdir -p '/nginx/logs'
make[1]: Leaving directory '/temp/nginx-download/nginx-1.12.2'

 

将目录切换到/nginx下，并查看：

# cd /nginx/
# ll
total 24
drwxr-xr-x  6 root root 4096 Oct 26 14:30 ./
drwxr-xr-x 26 root root 4096 Oct 26 14:30 ../
drwxr-xr-x  2 root root 4096 Oct 26 14:30 conf/
drwxr-xr-x  2 root root 4096 Oct 26 14:30 html/
drwxr-xr-x  2 root root 4096 Oct 26 14:30 logs/
drwxr-xr-x  2 root root 4096 Oct 26 14:30 sbin/
# ls *
conf:
fastcgi.conf            koi-win             scgi_params
fastcgi.conf.default    mime.types          scgi_params.default
fastcgi_params          mime.types.default  uwsgi_params
fastcgi_params.default  nginx.conf          uwsgi_params.default
koi-utf                 nginx.conf.default  win-utf
​
html:
50x.html  index.html
​
logs:
​
sbin:
nginx

 

Nginx的启停

Nginx常用命令

nginx命令所支持的选项有：

# ./sbin/nginx -h
nginx version: nginx/1.12.2
Usage: nginx [-?hvVtTq] [-s signal] [-c filename] [-p prefix] [-g directives]
​
Options:
  -?,-h         : this help
  -v            : show version and exit
  -V            : show version and configure options then exit
  -t            : test configuration and exit
  -T            : test configuration, dump it and exit
  -q            : suppress non-error messages during configuration testing
  -s signal     : send signal to a master process: stop, quit, reopen, reload
  -p prefix     : set prefix path (default: /nginx/)
  -c filename   : set configuration file (default: conf/nginx.conf)
  -g directives : set global directives out of configuration file

 

-v选项用来显示Nginx服务器的版本号，-V选项除了显示版本号，还显示其编译情况：

# ./sbin/nginx -v
nginx version: nginx/1.12.2
# ./sbin/nginx -V
nginx version: nginx/1.12.2
built by gcc 5.4.0 20160609 (Ubuntu 5.4.0-6ubuntu1~16.04.4) 
configure arguments: --prefix=/nginx

 

-t选项用于检查Nginx服务器配置文件是否有语法错误：

# ./sbin/nginx -t
nginx: the configuration file /nginx/conf/nginx.conf syntax is ok
nginx: configuration file /nginx/conf/nginx.conf test is successful

 

等。

Nginx启动

启动Nginx服务器很简单，只需要运行sbin下的nginx脚本就行了：

# ./sbin/nginx 
# ps -ef|grep nginx
root      74808   1308  0 14:47 ?        00:00:00 nginx: master process ./sbin/nginx
nobody    74809  74808  0 14:47 ?        00:00:00 nginx: worker process
root      74811  71675  0 14:47 pts/4    00:00:00 grep --color=auto nginx

 

可看到Nginx已经启动，包含了一个主进程（master process）和一个工作进程（worker process），主进程号为74808。启动Nginx服务后，也可以通过查看logs目录下的nginx.pid来查看主进程号：

# cat logs/nginx.pid 
74808

 

Nginx的默认端口号为80，在浏览器中输入localhost/index.html查看是否启动成功：

Nginx停止

停止Nginx服务可分为两种类型：

1.快速停止：立即停止当前Nginx服务正在处理的所有网络请求，马上丢弃连接，停止工作。相关命令为：kill -TERM 进程号或者kill -INT 进程号；

2.平缓停止：允许Nginx服务将当前的网络请求处理完毕，但不再接受新请求，之后关闭连接，停止工作。相关的命令为：kill -QUIT 进程号；

停止Nginx服务，采用快速停止方式：

# kill -TERM 74808
# ps -ef|grep nginx
root      74998  71675  0 15:03 pts/4    00:00:00 grep --color=auto nginx

 

Nginx重启

Nginx重启采用平滑重启的方式。Nginx服务进程号接收到重启信号后，先读取新的Nginx配置文件，如果配置语法正确，则启动新的Nginx服务，然后平缓的关闭旧的服务。如果配置语法错误，则继续采用旧的Nginx进程提供服务。

有两种方式进行平滑重启：

1.检查配置文件是否正确，如果正确进行重启：

# ./sbin/nginx -t
nginx: the configuration file /nginx/conf/nginx.conf syntax is ok
nginx: configuration file /nginx/conf/nginx.conf test is successful
# ./sbin/nginx -s reload

 

2.kill -HUP 主进程号:

# cat logs/nginx.pid 
75011
# kill -HUP 75011

 

常见问题

缺少依赖库

缺少PCRE依赖库

./configure: error: the HTTP rewrite module requires the PCRE library. You can either disable the module by using –without-http_rewrite_module option, or install the PCRE library into the system, or build the PCRE library statically from the source with nginx by using –with-pcre=option.

解决办法：

sudo apt-get install libpcre3 libpcre3-dev

 

缺少zlib依赖库

./configure: error: the HTTP gzip module requires the zlib library. You can either disable the module by using –without-http_gzip_module option, or install the zlib library into the system, or build the zlib library statically from the source with nginx by using –with-zlib=option.

解决办法：

sudo apt-get install zlib1g-dev

 

其他问题

apt-get命令被占用

E: Could not get lock /var/lib/dpkg/lock - open (11: Resource temporarily unavailable) E: Unable to lock the administration directory (/var/lib/dpkg/), is another process using it?

解决办法：找到占用进程，然后kill：

ps -A|grep apt
 61213 ?        00:00:02 aptd
kill -9 61213

 

附录

注：由于渲染原因–实际为 --，如–prefix=…实际为 --prefix=...

configure开关选项

	用法	默认值
–prefix=…	指定安装Nginx的基础目录	/usr/local/nginx, 注意：如果你在配置时使用了相对路径，则连接到基础目录。示例：指定–conf-path=conf/nginx.conf 则配置文件会在目录：/usr/local/nginx/conf/nginx.conf
–sbin-path=…	Nginx二进制文件安装的路径	<prefix>/sbin/nginx
–conf-path=…	主要配置文件放置目录	<prefix>/conf/nginx.conf
–error-log-path=…	错误日志存放的路径。错误日志在配置文件中须配置得非常正确，该路径只应用于你在配置文件中没有指定任何错误的日志指令时	<prefix>/logs/error.log
–pid-path=…	指定Nginx的pid文件的路径。可以在配置文件中指定pid文件的路径，如果没有具体的指定，则使用在这里对该选项指定的该路径	<prefix>/logs/nginx.pid注意：该pid文件是一个简单的文件文件，它包含进程的标识符。该文件应该放置在一个清晰可见的位置，以便其他应用程序能够很容易找到运行该程序的pid
–lock-path=…	锁文件（lock file）的存放路径。同样，该文件也可以在配置文件中指定，但是，如果在配置文件中没有指定，则使用该值	<prefix>/logs/nginx.lock注意：锁文件允许其他应用程序确定是否一个程序在运行，就Nginx来说，它用于确定该进程没有被启动两次
–with-perl_modules_path=…	定义Perl模块的路径。如果需要包含另外的Perl模块，必须定义该参数
–with-perl=…	Perl二进制文件的路径。用于执行Perl脚本。如果想执行一个Perl脚本，必须设置该路径
–http-log-path=…	定义被访问文件的日志文件存放路径。该路径只用于在配置文件中没有定义访问日志的情况	<prefix>/logs/access.log
–http-client-body-temp-path=…	该目录用于存储客户端请求产生的临时文件	<prefix>/client_body_temp
–http-proxy-temp-path=…	该目录用于代理存储临时文件	<prefix>/proxy_temp
–http-fastcgi-temp-path=…	指定用于HTTP FastCGI模块使用的临时文件的存放路径	<prefix>/fastcgi_temp
–builddir=…	指定创建应用程序的位置

configure先決条件选项

编译选项
–with-cc=…	指定一个备用的C编译器的位置
–with-cpp=…	指定一个备用的C预处理器的位置
–with-cc-opt=…	定义额外的选项，然后在命令行传递给C编译器
–with-ld-opt=…	定义额外的选项，然后在命令行传递给C连接器
–with-cpu-opt=…	指定不同的目标处理器结构，可以是下列值：pentium，pentiumpro，pentium3，pentium4，athlon，opteron，sparc32，sparc64和ppc64
PCRE选项
–without-pcre	不使用PCRE库。这个设置不推荐使用，因为它会移除对正则表达式的支持，从而使Rewrite模块失去作用。
–with-pcre	强制作用PCRE库
–with-pcre=…	允许指定PCRE库的源代码
–with-pcre-opt=…	用于建立PCRE库的另外的选项
MD5选项
–with-md5=…	指定MD5库源代码的路径
–with-md5-opt=…	用于建立MD5库的另外选项
–with-md5-asm	为建MD5库使用汇编语言源代码
SHA1选项
–with-sha1=…	指定SHA1库的源代码
–with-sha1-opt=…	用于建立SHA1库的另外选项
–with-sha1-asm	为建立SHA1库使用汇编语言源代码
zlib选项
–with-zlib=…	指定zlib库的源代码
–with-zlib-opt=…	用于建立zlib库的另外的选项
–with-zlib-asm=…	使用汇编语言最大限度地优化下列目标结构：Pentium, pentiumpro
OpenSSL选项
–with-openssl=…	指定OpenSSL库的源代码路径
–with-openssl-opt=…	为建立OpenSSL库的另外的选项

configure模块选项

以下是Nginx默认开启的模块，可以使用表格中的命令来关闭相应模块：

默认开启的模块	描述
–without-http-charset_module	禁用Charset模块，该模块用于对网页重新编码
–without-http-gzip_module	禁用Gzip压缩模块
–without-http_ssi_module	禁用服务器端包含模块
–without-http_access_module	禁用访问模块，对于指定的IP段，允许访问配置
–without-http_userid_module	禁用用户ID模块。该模块为用户通过cookie验证身份
–without-http_auth_basic_module	禁用基本的认证模块
–without-http_autoindex_module	禁用自动索引模块
–without-http_geo_module	禁用Geo模块，该模块允许你定义依赖于IP地址段的变量
–without-http_map_module	禁用Map模块，该模块允许你声明map区段
–without-http_referer_module	禁用Referer控制模块
–without-http_rewrite_module	禁用Rewrite模块
–without-http_proxy_module	禁用代理模块。该模块用于向其他服务器传输请求
–without-http_fastcgi_module	禁用FastCGI模块。该模块是用于与FastCGI进程配合工作
–without-http_memcached_module	禁用Memcached模块。该模块是用于与memcached守护进程配合工作
–without-http_limit_zone_module	禁用Limit Zone模块。该模块是用于根据定义的zone来限制约束对资源的使用。
–without-http_limit_req_module	禁用Limit Requests模块。该模块允许你限制每个用户请求的总数
–without-http_empty_gif_module	禁用Empty Gif模块。该模块用于在内存中提供一个空白的GIF图像
–without-http_browser_module	禁用Browser模块。该模块用于解释用户代理字符串
–without-http_upstream_ip_hash_module	禁用Upstream模块。该模块用于配置负载均衡结构

以下是Nginx默认关闭的模块，可以使用表格中的命令来开启相应模块：

默认禁用的模块	描述
–with-http_ssl_module	开启SSL模块，支持使用HTTPS协议的网页
–with-http_realip_module	开启Real IP的支持，该模块用于从客户请求的头数据中读取real IP地址
–with-http_addition_module	开启Addition模块，该模块允许你追加或前置数据（prepend data）到响应的主体部分
–with-http_xslt_module	开启XSLT模块的支持，该模块实现XSLT转化为XML文档
–with-http_image_filter_module	开启Image Filter模块，该模块是让你修改图像。注意：如果想编译该模块，需要在系统中安装libgd库
–with-http_geoip_module	开启GeoIP模块，该模块通过使用MaxMind’s GeoI 二进制数据库来获取客户端在地理上的分布。注意：如果希望编译该模块，需要在系统中安装libgeoip库。
–with-http_sub_module	开启Substitution模块，该模块用于在网页中替换文本
–with-http_dav_module	开启WebDAV模块
–with-http_flv_module	开启FLV模块，该模块用于专门处理.flv(flash视频)文件
–with-http_gzip_static_module	开启Gzip静态模块，该模块用于发送预压缩的文件
–with-http_random_index_module	开启Random Index模块。该模块用于挑选一个随机的文件作为该目录的index
–with-http_secure_link_module	开启Secure Link模块，该模块用于在URL中检测关键字的存在
–with-http_stub_status_module	开启Stub Status模块，该模块会产生一个服务器状态和信息页
–with-google_perftools_module	开启google性能工具模块

其它configure选项

邮件服务代理
–with-mail	开启邮件服务代理（mail server proxy）模块，支持POP3，IMAP4和SMTP。该功能默认禁用
–with-mail_ssl_module	开启邮件代理服务对SSL的支持。该功能默认禁用
–without-mail_pop3_module	在邮件代理下禁用POP3功能。在开启邮件代理模块后该功能默认启用
–without-mail_imap_module	对邮件代理服务器禁用IMAP4模块，在开启邮件代理模块后该功能默认启用
–without-mail_smtp_module	对于邮件代理服务器禁用SMTP模块，在开启邮件代理模块后该功能默认启用
事件管理
–with-rtsig_module	开启rtsig模块，使用rtsig作为事件通知机制
–with-select_module	开启select模块，使用select作为事件通知机制。默认情况下，该模块是开启的，除非系统有一种更好的方式发现——kqueue, epoll, rtsig 或 poll
–without-select_module	禁用select模块
–with-poll_module	开启poll模块，该模块使用poll作为事件通知机制。默认情况下，如果有效，该模块是开启的，除非系统上有一种更好的方式发现——kqueue, epoll或rtsig
–without-poll_module	禁用poll模块
用户和组选项
–user=…	指定启动Nginx进程的默认用户。这个设置仅用于在配置文件中省略user指令来指定用户的情况
–group=…	指定启动Nginx进程默认的用户组。这个设置仅用于在配置文件中省略使用group指令来指定用户的情况
其它选项
–with-ipv6	开启对IPv6的支持
–without-http	禁用HTTP服务
–without-http-cache	禁用HTTP缓冲功能
–add-module=PATH	通过指定的路径编译添加第三方模块。如果希望编译多个模块，那么该选项可以无限次使用
–with-debug	开启记录额外的调试信息