Nginx安装与部署

Posted 7788it

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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=/nginxconfigure脚本支持的选项可参考附录)配置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 开启记录额外的调试信息

以上是关于Nginx安装与部署的主要内容,如果未能解决你的问题,请参考以下文章

Nginx安装与部署

nginx安装与调优部署文档(Linux)

Nginx的安装与部署

centos6 Nginx的安装部署与负载均衡配置

LNMP架构之nginx的安装与部署

LNMP架构之nginx的安装与部署