Nginx安装及配置
Nginx是一款速度快,功能强大的http以及反向代理服务器,经过简单的配置之后即可以用来托管页面。
不幸的是,和很多其他系统管理工具一样,相关的原理教程和配置说明文档都很少。虽然官方提供了一个wiki,但是内容多且复杂,却没有真正的介绍那些你可能真正需要的东西。在自己纠结这个wiki一段时间之后,我终于掌握了使用nginx的一些基础知识,并把它们在这里与其他开发者分享出来,希望你们能够更加快速的去掌握这些知识。
下面进入正题。针对本教程,你需要一个VPS(虚拟主机),最好是刚刚建立的,这样可以避免与先前的配置产生冲突。
初始化安装
现在假设你已经拥有一个运行ubuntu的虚拟主机(比如说托管于 digital ocean),配置好登录选项并更新好 apt 之后,运行 apt-get install nginx 安装nginx.在浏览器访问你的IP地址,你会看到页面显示“welcome to ngnix”信息。OK,一切正常。
查找nginx目录
在我们通过 apt 安装完nginx后,它为我们提供了一个基本的结构,帮助我们迅速设置好配置文件。所有的nginx配置文件都在 /etc/nginx下(译者注:Mac OS X环境下使用homebrew路径与linux有区别,文章结尾部分提供mac下解决方案),输入 cd 进入该目录。你需要添加新配置选项的地方位于 sites-enabled 文件夹。如果你打开这个文件夹,你会发现一个名为 default 的txt文档,打开后你就会找到nginx的配置选项以及 “welcome to nginx"欢迎选项的代码。接下来我们开始建立属于我们自己的配置文件用于显示一个页面。在sites-enabled目录下新建一个空白文件并命名为 test,用你自己喜欢的文本编辑器进行编辑。
注意: 在该目录下会发现一个
/etc/nginx/sites-available的文件夹。这个文件夹一般在你需要建立和管理多个站点的时候非常有用,可以帮助你更好的组织不同的项目。你需要在这里添加你的nginx配置文案并将他们链接至sites-enabled目录下。命令如下:
ln -s /etc/nginx/sites-available/dotcom /etc/nginx/sites-enabled/dotcom
只有在 sites-enabled 目录下的配置文件才能够真正被用户访问。但是你同样可以将文件放在 sites-available 目录下用来存档或者生成链接。
配置静态服务器
Nginx配置文件有自己的格式,好消息是文件的格式相当简单,看起来特别像CSS文件,先指定变量名,然后在花括号内编写指令。最顶层是 server ,代码为:
server {
}
在花括号内,我们仍然可以像书写CSS一样,键值对后接分号,或者说更像sass的语法,并添加嵌套代码块。后面两种风格的代码我们都会用到,也很容易理解。
这里可以添加的键值对和代码块(在本教程的后面我们把它称为指令)有很多种,你可以转到官方文档去具体查看。对于基本的服务器设置其实只用掌握一些重要的指令即可。我会给后面的每个指令链接官方的ngnix文档。官方文档是你深入理解nginx的唯一渠道,因此你必须掌握如何更好的去使用它。
声明服务器监听的端口号。如果你了解rails,你一定知道本地服务器的默认端口是3000. Roots运行在1111端口。SSL在443端口。互联网的默认端口是80,因此在url中未定义端口的话一般默认为80。因为你很有可能是去运行一个线上的服务器,因此最好定义成80端口。代码如下:
server {
listen 80;
}
注意默认端口严格来讲不是必要的,但是为了能够保证你对整个流程足够了解最好加上。完成了第一步,我们进入下一步server_name.
server_name主要用来匹配url地址。任意请求通过nginx时,它会查看url并寻找 server_name 片段。如果你的站点地址为 http://xvfeng.me, 那么你的 server_name 应当也为 xvfeng.me . 如果你在域名解析时使用了A记录并通过服务器指向 http://snargles.com , 你可以添加另外一个 server 代码,将 server_name 指向 snargles.com, 这段代码就会匹配来自于这个域名的请求。
这个特性非常强大。这意味着你可以在单个nginx配置文件里托管无数个站点,甚至包括不同域名的网站。你需要做的只是将设置A记录并指向虚拟机所在的IP, 之后设置其他的nginx服务器配置。
针对 server_name 还有两点值得关注。首先是你可以设置子域名。如果你想匹配http://test.example.com ,设置相当简单,甚至还可以指向一个完全不同的应用。第二点,你可以使用通配符, 即 * 或者正则来匹配路由。这个功能绝对强大。下面我们简单的配置一下server_name到example.com .
server {
listen 80;
server_name example.com;
}
Nice.接下来再加一些配置就可以让服务器运转了。
这个是托管静态站点最关键的部分。如果你只是想用它来托管一些html和css文件,root部分要定义的就是这些文件存放的路径。我喜欢把文件放在 /var/www 目录下,因此我们在这里建立一个文件夹。使用 mkdir 创建 /var/www/example 目录,建立一个空白的 index.html 文件,随便添加一些段落输出hello world之类的内容。代码如下:
server {
listen 80;
server_name example.com;
root /var/www/example;
}
基本变量设置完毕,下一步配置路由。
Location接受两个参数,一个字符串或者正则和一段代码。字符串或者正则用于匹配某个特定目录。如果你想让用户在访问 example.com/whaterver 时访问某个特定页面,你需要将 whatever 设置为uri地址。在这里我们只需要访问root目录,因此只需要加上 / 即可,内容暂时为空,后面再做解释。
server {
listen 80;
server_name example.com;
root /var/www/example;
location / {
}
}
第一参数可以有很多种写法,你可以参考上面给出的链接。在以上区块内,我们需要路由指向结果页面。注意 / 会匹配所有的url地址,因为在这里它被解释为一个正则。如果你只想匹配某个准确的字符串,只需要在前面加上一个等号,写法如下:
location = / { ... }
现在我们需要完成之前的代码。我们可以在区块内添加另外一段指令,用于加载名为 try_files 的文件。Try fiels接受了一组文件名或者正则,用于在根目录下查找,并会加载查找到的第一个结果。对于我们的静态服务器来讲,我们希望找到一个在 / 之后紧跟着whatever的文件,例如 whatever.html. 如果在斜线后面没有任何内容,则会寻找 index.html. 在上面给出的文档链接中你可以找到更多的关于如何设置该选项的吸纳关系介绍,这里我们只写一些简单的配置:
server {
listen 80;
server_name example.com;
root /var/www/example;
location / {
try_files $uri $uri/ /index.html;
}
}
你可能会奇怪上面的 $url 是从哪里来的?其实是nginx所提供的。每次有请求时,nginx会生成一系列变量,这些变量存储了请求的相关信息。这里的uri就是我们将要了解的内容之一。
- 来自
http://example.com的请求进入。 - nginx找到server片段代码,其中
server_name为example.com,并使用它来处理请求 - nginx匹配任意请求。因为这里的
/会匹配根域名下的任意内容。 - 在匹配到的location代码中,nginx开始试图加载一个文件。首先寻找一个未命名的文件,因为这里的uri匹配的就是没有名称的文件,所以无法找到。接着开始查找未命名的目录,结果还是找不到。最后开始查找并加载根目录下
/index.html。
接下来想象一下如果你添加一个名为 test.html 的文件到根目录下并访问 http://example.com/test.html.自己试一下你就知道了。
你可以任意的去尝试改变这里的配置环境。例如,在carrot.is这个网站里,但用户访问某个文件并且没有加上 .html 后缀时,try_files同样会查找 $uri.html 并匹配相应结果。因此在你访问http://carrot.is.about 和 http://carrot.is/about.html 时你会得到相同的文件。你可以充分发挥你的想象力去设置你的配置文件。
启动服务
总结一下我们所做的事情。首先添加了 server 选项,在nginx运行时,会查找 /etc/sites-enabled 目录下的所有配置文件用于显示对应内容。但是请等一下,你可能无法马上得到结果-因为nginx并不知道你所作的这些改动。为了让nginx真正读取新配置文件,你需要重启服务器,运行以下命令:
service nginx reload
#安装部署nginx所用到的安装工具和相关库#默认安装的http_rewrite_module(使用正则对请求重写)需pcre库#默认安装的httP_gzip_module(Gzip压缩)需zlib库#安装http_ssl_module(HTTPS/SLL)需openssl库yum -y install gcc pcre pcre-devel zlib zlib-devel openssl openssl-devel#下载nginx源码包,并解压wget http://nginx.org/download/nginx-1.10.3.tar.gztar -zxvf nginx-1.10.3.tar.gzcd nginx-1.10.3#设置参数 参数具体参考《Nginx编译参数》./configure \--prefix=/usr/local/nginx \--with-http_ssl_module#编译并安装- make && make install
#Nginx的worker进程运行用户以及用户组#user nobody nobody;#Nginx开启的进程数worker_processes 1;#worker_processes auto;#以下参数指定了哪个cpu分配给哪个进程,一般来说不用特殊指定。如果一定要设的话,用0和1指定分配方式.#这样设就是给1-4个进程分配单独的核来运行,出现第5个进程是就是随机分配了。eg:#worker_processes 4 #4核CPU#worker_cpu_affinity 0001 0010 0100 1000#定义全局错误日志定义类型,[debug|info|notice|warn|crit]#error_log logs/error.log info;#指定进程ID存储文件位置#pid logs/nginx.pid;#一个nginx进程打开的最多文件描述符数目,理论值应该是最多打开文件数(ulimit -n)与nginx进程数相除,但是nginx分配请求并不是那么均匀,所以最好与ulimit -n的值保持一致。- #vim /etc/security/limits.conf
- # * soft nproc 65535
- # * hard nproc 65535
- # * soft nofile 65535
# * hard nofile 65535worker_rlimit_nofile 65535;
events {#use [ kqueue | rtsig | epoll | /dev/poll | select | poll ]; epoll模型是Linux 2.6以上版本内核中的高性能网络I/O模型,如果跑在FreeBSD上面,就用kqueue模型。use epoll;#每个进程可以处理的最大连接数,理论上每台nginx服务器的最大连接数为worker_processes*worker_connections。理论值:worker_rlimit_nofile/worker_processes#注意:最大客户数也由系统的可用socket连接数限制(~ 64K),所以设置不切实际的高没什么好处worker_connections 65535;#worker工作方式:串行(一定程度降低负载,但服务器吞吐量大时,关闭使用并行方式)#multi_accept on;}
#文件扩展名与文件类型映射表include mime.types;#默认文件类型default_type application/octet-stream;- #日志相关定义
- #log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '# '"$http_user_agent" "$http_x_forwarded_for"';#定义日志的格式。后面定义要输出的内容。#1.$remote_addr 与$http_x_forwarded_for 用以记录客户端的ip地址;#2.$remote_user :用来记录客户端用户名称;#3.$time_local :用来记录访问时间与时区;#4.$request :用来记录请求的url与http协议;#5.$status :用来记录请求状态;#6.$body_bytes_sent :记录发送给客户端文件主体内容大小;#7.$http_referer :用来记录从那个页面链接访问过来的;#8.$http_user_agent :记录客户端浏览器的相关信息#连接日志的路径,指定的日志格式放在最后。#access_log logs/access.log main;#只记录更为严重的错误日志,减少IO压力error_log logs/error.log crit;#关闭日志#access_log off;#默认编码#charset utf-8;#服务器名字的hash表大小server_names_hash_bucket_size 128;#客户端请求单个文件的最大字节数client_max_body_size 8m;#指定来自客户端请求头的hearerbuffer大小client_header_buffer_size 32k;#指定客户端请求中较大的消息头的缓存最大数量和大小。large_client_header_buffers 4 64k;#开启高效传输模式。sendfile on;#防止网络阻塞tcp_nopush on;tcp_nodelay on;#客户端连接超时时间,单位是秒keepalive_timeout 60;#客户端请求头读取超时时间client_header_timeout 10;#设置客户端请求主体读取超时时间client_body_timeout 10;#响应客户端超时时间send_timeout 10;#FastCGI相关参数是为了改善网站的性能:减少资源占用,提高访问速度。fastcgi_connect_timeout 300;fastcgi_send_timeout 300;fastcgi_read_timeout 300;fastcgi_buffer_size 64k;fastcgi_buffers 4 64k;fastcgi_busy_buffers_size 128k;fastcgi_temp_file_write_size 128k;#gzip模块设置#开启gzip压缩输出gzip on;#最小压缩文件大小gzip_min_length 1k;#压缩缓冲区gzip_buffers 4 16k;#压缩版本(默认1.1,前端如果是squid2.5请使用1.0)gzip_http_version 1.0;#压缩等级 1-9 等级越高,压缩效果越好,节约宽带,但CPU消耗大gzip_comp_level 2;#压缩类型,默认就已经包含text/html,所以下面就不用再写了,写上去也不会有问题,但是会有一个warn。gzip_types text/plain application/x-javascript text/css application/xml;#前端缓存服务器缓存经过压缩的页面gzip_vary on;
#虚拟主机定义server {#监听端口listen 80;#访问域名server_name localhost;#编码格式,若网页格式与此不同,将被自动转码#charset koi8-r;#虚拟主机访问日志定义#access_log logs/host.access.log main;#对URL进行匹配location / {#访问路径,可相对也可绝对路径root html;#首页文件。以下按顺序匹配index index.html index.htm;}#错误信息返回页面#error_page 404 /404.html;# redirect server error pages to the static page /50x.html#error_page 500 502 503 504 /50x.html;location = /50x.html {root html;}#访问URL以.php结尾则自动转交给127.0.0.1# proxy the PHP scripts to Apache listening on 127.0.0.1:80##location ~ \.php$ {# proxy_pass http://127.0.0.1;#}#php脚本请求全部转发给FastCGI处理# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000##location ~ \.php$ {# root html;# fastcgi_pass 127.0.0.1:9000;# fastcgi_index index.php;# fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;# include fastcgi_params;#}#禁止访问.ht页面 (需ngx_http_access_module模块)# deny access to .htaccess files, if Apache's document root# concurs with nginx's one##location ~ /\.ht {# deny all;#}}#HTTPS虚拟主机定义# HTTPS server##server {# listen 443 ssl;# server_name localhost;# ssl_certificate cert.pem;# ssl_certificate_key cert.key;# ssl_session_cache shared:SSL:1m;# ssl_session_timeout 5m;# ssl_ciphers HIGH:!aNULL:!MD5;# ssl_prefer_server_ciphers on;# location / {# root html;# index index.html index.htm;# }#}
#Nginx运行状态,StubStatus模块获取Nginx自启动的工作状态(编译时要开启对应功能)#location /NginxStatus {# #启用StubStatus的工作访问状态# stub_status on;# #指定StubStaus模块的访问日志文件- # access_log logs/Nginxstatus.log;
- # #Nginx认证机制(需Apache的htpasswd命令生成)
- # #auth_basic "NginxStatus";
- # #用来认证的密码文件
- # #auth_basic_user_file ../htpasswd;
#}- 访问:http://IP/NginxStatus(测试就不加密码验证相关)
- #以下配置追加在HTTP的全局变量中
- #nginx跟后端服务器连接超时时间(代理连接超时)
proxy_connect_timeout 5;- #后端服务器数据回传时间(代理发送超时)
proxy_send_timeout 5;- #连接成功后,后端服务器响应时间(代理接收超时)
proxy_read_timeout 60;- #设置代理服务器(nginx)保存用户头信息的缓冲区大小
proxy_buffer_size 16k;- #proxy_buffers缓冲区,网页平均在32k以下的话,这样设置
proxy_buffers 4 32k;- #高负荷下缓冲大小(proxy_buffers*2)
proxy_busy_buffers_size 64k;- #设定缓存文件夹大小,大于这个值,将从upstream服务器传
proxy_temp_file_write_size 64k;- #反向代理缓存目录
- proxy_cache_path /data/proxy/cache levels=1:2 keys_zone=cache_one:500m inactive=1d max_size=1g;
#levels=1:2 设置目录深度,第一层目录是1个字符,第2层是2个字符#keys_zone:设置web缓存名称和内存缓存空间大小#inactive:自动清除缓存文件时间。#max_size:硬盘空间最大可使用值。#指定临时缓存文件的存储路径(路径需和上面路径在同一分区)proxy_temp_path/data/proxy/temp#服务配置server {#侦听的80端口listen 80;server_name localhost;location / {#反向代理缓存设置命令(proxy_cache zone|off,默认关闭所以要设置)proxy_cache cache_one;#对不同的状态码缓存不同时间proxy_cache_valid 200 304 12h;#设置以什么样参数获取缓存文件名proxy_cache_key $host$uri$is_args$args;#后7端的Web服务器可以通过X-Forwarded-For获取用户真实IPproxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;#代理设置proxy_pass http://IP;#文件过期时间控制expires 1d;}#配置手动清楚缓存(实现此功能需第三方模块 ngx_cache_purge)#http://www.123.com/2017/0316/17.html访问#http://www.123.com/purge/2017/0316/17.html清楚URL缓存- location ~ /purge(/.*) {
- allow 127.0.0.1;
- deny all;
- proxy_cache_purge cache_one $host$1$is_args$args;
- }
- #设置扩展名以.jsp、.php、.jspx结尾的动态应用程序不做缓存
- location ~.*\.(jsp|php|jspx)?$ {
proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;- proxy_pass http://http://IP;
- }
#负载均衡服务器池upstream my_server_pool {#调度算法#1.轮循(默认)(weight轮循权值)#2.ip_hash:根据每个请求访问IP的hash结果分配。(会话保持)#3.fair:根据后端服务器响应时间最短请求。(upstream_fair模块)#4.url_hash:根据访问的url的hash结果分配。(需hash软件包)#参数:#down:表示不参与负载均衡#backup:备份服务器#max_fails:允许最大请求错误次数#fail_timeout:请求失败后暂停服务时间。- server 192.168.1.109:80 weight=1 max_fails=2 fail_timeout=30;
server 192.168.1.108:80 weight=2 max_fails=2 fail_timeout=30;}#负载均衡调用server {...location / {proxy_pass http://my_server_pool;}}
#根据不同的浏览器URL重写if($http_user_agent ~ Firefox){rewrite ^(.*)$ /firefox/$1 break;}if($http_user_agent ~ MSIE){rewrite ^(.*)$ /msie/$1 break;}#实现域名跳转location / {rewrite ^/(.*)$ https://web8.example.com$1 permanent;}
#限制IP访问location / {deny 192.168.0.2;allow 192.168.0.0/24;allow 192.168.1.1;deny all;}
- #启动nginx
- nginx
- #关闭nginx
- nginx -s stop
- #平滑重启
- kill -HUP `cat /usr/local/nginx/logs/nginx.pid`
#!/bin/bash#chkconfig: 2345 80 90 #description:auto_runPATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:~/binexport PATH# Check if user is rootif [ $(id -u) != "0" ]; thenecho "Error: You must be root to run this script!\n"exit 1fiNGINXDAEMON=/usr/local/nginx/sbin/nginxPIDFILE=/usr/local/nginx/logs/nginx.pidfunction_start(){echo -en "\033[32;49;1mStarting nginx......\n"echo -en "\033[39;49;0m"if [ -f $PIDFILE ]; thenprintf "Nginx is runing!\n"exit 1else$NGINXDAEMONprintf "Nginx is the successful start!\n"fi}function_stop(){echo -en "\033[32;49;1mStoping nginx......\n"echo -en "\033[39;49;0m"if [ -f $PIDFILE ]; thenkill `cat $PIDFILE`printf "Nginx program is stoped\n"elseprintf "Nginx program is not runing!\n"fi}function_reload(){echo -en "\033[32;49;1mReload nginx......\n"echo -en "\033[39;49;0m"- function_stop function_start
}function_restart(){echo -en "\033[32;49;1mRestart nginx......\n"echo -en "\033[39;49;0m"printf "Reload Nginx configure...\n"$NGINXDAEMON -tkill -HUP `cat $PIDFILE`printf "Nginx program is reloding!\n"}function_kill(){killall nginx}function_status(){if ! ps -ef|grep -v grep|grep 'nginx:' > /dev/null 2>&1thenprintf "Nginx is down!!!\n"elseprintf "Nginx is running now!\n"fi}if [ "$1" = "start" ]; thenfunction_startelif [ "$1" = "stop" ]; thenfunction_stopelif [ "$1" = "reload" ]; thenfunction_reloadelif [ "$1" = "restart" ]; thenfunction_restartelif [ "$1" = "kill" ]; thenfunction_killelif [ "$1" = "status" ]; thenfunction_statuselseecho -en "\033[32;49;1m Usage: nginx {start|stop|reload|restart|kill|status}\n"echo -en "\033[39;49;0m"fi
浙公网安备 33010602011771号