Nginx服务器搭建和基本配置详解

nginx(engine x) 是一个高性能的 http 服务器和反向代理服务器，这款软件开发的目的是为了解决 c10k 问题。

nginx 的架构利用了许多现代操作系统的特性，以实现一个高性能的 http 服务器。例如在 linux 系统上，nginx 使用了 epoll，sendfile，file aio，directio 等机制，使得 nginx 不仅性能高效，而且资源占用率非常低，官方宣称 nginx 维持 10000 个非活动的 http keep-alive 连接仅需要 2.5m 内存。

nginx会按需同时运行多个进程：一个主进程（master）和几个工作进程（worker），配置了缓存时还会有缓存加载器进程（cache loader）和缓存管理器进程（cache manager）等。所有进程均是仅含有一个线程，并主要通过“共享内存”的机制实现进程间通信。主进程以 root 用户身份运行，而worker、cache loader 和 cache manager 均应以非特权用户身份运行。

1. 安装 nginx
在 centos6 版本的 epel 源中，已经加入了 nginx 的 rpm 包，不过此 rpm 包版本较低。如果需要更新版本，可以使用官方制作的 rpm 包，或者使用源码包编译安装。

还可以使用一些二次开发功能增强的 nginx 版本，例如淘宝的 tengine 和 openresty 都是不错的选择。

1.1 常用编译参数

--prefix=path：指定 nginx 的安装目录
--conf-path=path：指定 nginx.conf 配置文件路径
--user=name：nginx 工作进程的用户
--with-pcre：开启 pcre 正则表达式的支持
--with-http_ssl_module：启动 ssl 的支持
--with-http_stub_status_module：用于监控 nginx 的状态
--with-http-realip_module：允许改变客户端请求头中客户端 ip 地址
--with-file-aio：启用 file aio
--add-module=path：添加第三方外部模块
这里提供一个完整的编译方案：

--prefix=/usr/local/nginx \
--conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log \
--http-log-path=/var/log/nginx/access.log \
--http-client-body-temp-path=/var/tmp/nginx/client_body \
--http-proxy-temp-path=/var/tmp/nginx/proxy \
--http-fastcgi-temp-path=/var/tmp/nginx/fastcgi \
--http-uwsgi-temp-path=/var/tmp/nginx/uwsgi \
--pid-path=/var/run/nginx.pid \
--lock-path=/var/lock/nginx \
--user=nginx \
--group=nginx \
--with-file-aio \
--with-http_ssl_module \
--with-http_realip_module \
--with-http_sub_module \
--with-http_gzip_static_module \
--with-http_stub_status_module \
--with-pcre
1.2 nginx 的启动和关闭

启动 nginx：

# nginx -c /etc/nginx/nginx.conf 

关闭 nginx

# nginx -s stop

重读配置文件

# nginx -s reload
# pkill -hup nginx

重新打开日志文件

# nginx -s reopen
# pkill -usr1 nginx

还可以下载 nginx rpm 包中的 /etc/init.d/nginx 文件，修改路径后即可使用：

# service nginx {start|stop|status|restart|reload|configtest|}

2. nginx.conf 配置文件

nginx 配置文件主要分成四部分：main（全局设置）、http（http 的通用设置）、server（虚拟主机设置）、location（匹配 url 路径）。还有一些其他的配置段，如 event，upstream 等。

2.1 通用设置

user nginx
指定运行 nginx workre 进程的用户和组

worker_rlimit_nofile #
指定所有 worker 进程能够打开的最大文件数

worker_cpu_affinity
设置 worker 进程的 cpu 粘性，以避免进程在 cpu 间切换带来的性能消耗。如 worker_cpu_affinity 0001 0010 0100 1000;（四核）

worker_processes 4
worker 工作进程的个数，这个值可以设置为与 cpu 数量相同，如果开启了 ssl 和 gzip，那么可以适当增加此数值

worker_connections 1000
单个 worker 进程能接受的最大并发连接数，放在 event 段中

error_log logs/error.log info
错误日志的存放路径和记录级别

use epoll
使用 epoll 事件模型，放在 event 段中

2.2 http 服务器

server {}：
定义一个虚拟主机

listen 80;
定义监听的地址和端口，默认监听在本机所有地址上

server_name name [...];
定义虚拟主机名，可以使用多个名称，还可以使用正则表达式或通配符。

sendfile on
开启 sendfile 调用来快速的响应客户端

keepalive_timeout 65
长连接超时时间，单位是秒。

send_timeout
指定响应客户端的超时时间

client_max_body_size 10m
允许客户端请求的实体最大大小

root path
设置请求 url 所对应资源所在文件系统上的根目录

location [ = | ~ | ~* | ^~ ] uri { ... }
设置一个 uri 匹配路径
=：精确匹配
~：正则表达式匹配，区分字符大小写
~*：正则表达式匹配，不区分字符大小写
^~：uri 的前半部分匹配，且不实用正则表达式
优先级：
= > location 完整路径 > ^~ > ~ > ~* > location 起始路径 > location /

allow 和 deny
基于 ip 访问控制，如：

仅允许 192.168.0.0/24 网段客户端访问

allow 192.168.0.0/24;
deny all;
stub_status on
开启状态显式，仅能用于 location 中：
开启状态显式页面

location /status {
stub_status on;
allow 172.16.0.0/16;
deny all;
}

rewrite <regex> <repl> <flag>
url 重写，可以使用多种标记
例如：

rewrite ^/images/(.*\.jpg)$ /imgs/$1 break;
可用的 flag：
- last：重写完成后，继续匹配其他 rewrite 规则
- break：重写完成后不再继续匹配
- redirect：返回 302 重定向（临时重定向），客户端对重定向的 url 发起新的请求
- permanent：返回 301 重定向（永久重定向），客户端对重定向的 url 发起新的请求

一个 server 配置示例：

server {
 listen  80;
 server_name www.example.com;
 root /web/htdocs;

 location / {
  index index.html index.htm;
 }

 location /status {
  stub_status on;
  allow 10.0.0.0/8;
  deny all;
  access_log off;
}

2.3 ssl 的配置

启用一个 ssl 虚拟主机

server {
  listen 443;
  server_name example.com;

  root /apps/www;
  index index.html index.htm;

  ssl on;
  ssl_certificate /etc/nginx/ssl/nginx.crt;
  ssl_certificate_key /etc/nginx/ssl/nginx.key;

#  ssl_protocols sslv3 tlsv1 tlsv1.1 tlsv1.2;
#  ssl_ciphers all:!adh:!export56:rc4+rsa:+high:+medium:+low:+sslv2:+exp;
#  ssl_prefer_server_ciphers on;

}

其中 ssl_certificate 表示 ca 文件，ssl_certificate_key 表示密钥文件。

如果想把 http 请求强制转到 https，可以这样：

server {
listen  80;
server_name example.me;

return 301 https://$server_name$request_uri;
}

2.4 nginx 做负载均衡反向代理

nginx 做反向代理时，后端主机有多台，可以使用 upstream 定义一个后端主机池，在反向代理时直接使用主机池的名字。在 upstream 中可以定义负载均衡调度算法，权重，健康状态检测等参数。

例如：

upstream backend {
 server 172.16.0.1:80 weight=1 max-fails=3 fail_timeout=10;
 server 172.16.0.2:80 weight=1max-fails=3 fail_timeout=10;;
}

默认请求下，使用 round-robin 调度算法，并有健康状态检查和恢复主机的能力。

ningx 还可以使用这些算法：

ip_hash：基于源地址哈希，主要目的是会话保持
least_conn：基于最少活动连接进行调度
sticky：基于 cookie 进行会话绑定，nginx 会在客户端第一次访问时插入路由信息到 cookie 中，或者选择 cookie 中的某个字段的值作为键，以后每次请求将基于此信息进行调度
基于 cookie 的会话绑定共有 cookie，route 和 learn 三种。

例如，基于 cookie name 的调度：

upstream backend {
 server backend1.example.com;
 server backend2.example.com;

 sticky cookie srv_id expires=1h domain=.example.com path=/;
}

使用此主机组进行反向代理：

location / {
 proxy_pass http://backend;
 proxy_set_header host $host;
 proxy_set_haeder x-forwared-for $proxy_add_x_forwarded_for;
}

proxy_pass url 指定代理的后端主机，可以指定 "http" 或 "https" 协议，域名可以是 ip 地址，也可以是 upstream 池名字

如果代理指定的是一个 uri 地址，如 http://127.0.0.1/remote，那么将直接被代理至指定 uri，无论请求的 uri 是什么
如果代理指定的一个主机而没有 uri，如 http://127.0.0.1，客户端请求的uri将被传递至指定域名
如果 location 中使用模式匹配 url，那么 url 也会被传递至代理 url 的末端
如果 location 中使用了 uri 重写，那么 proxy_pass 会使用重写后的结果进行处理
proxy_set_header header value 对转发的报文首部进行修改

2.5 反向代理时的缓存相关设定

proxy_cache_path path [levels=levels] keys_zone=name:size

定义磁盘缓存路径，nignx 的缓存是以键值方式存放的，keys_zone 用于指定键存放的内存空间名字和大小，对应的值则存放在 path 指定的路径中。levels 可以指定缓存存放路径的级数和名称字符数。此设置只能在 http 段中定义。

如：

proxy_cache_path /var/cache/nginx/proxy levels=1:2 keys_zone=one:10m;

proxy_cache_valid [code ...] time 指定不同响应码的内容的缓存时间

如：

proxy_cache_valid 200 302 10m;
proxy_cache_valid 404  1m;
proxy_cache_valid any  1m;

proxy_cache_method method 定义哪些方法的请求结果可以被缓存，如：

proxy_cache_method get;
proxy_cache_method head;

proxy_cache name 指定使用预先定义的缓存空间用于缓存

2.6 fastcgi 代理的设置

使用 fastcgi 时，设置代理的方法同 porxy_pass 类似，同时还可以使用 fastcgi 缓存，设置的方法也和 proxy_cache 类似。

location ~ \.php$ {
 root   /web/htdocs;
 fastcgi_pass 127.0.0.1:9000;
 fastcgi_index index.php;
 fastcgi_param script_filename $document_root$fastcgi_script_name;
 include  fastcgi_params;
}

3. 一些常用内置变量

$arg_name：请求 uri 中的 name 参数至
$args：请求 uri 的所有参数，和 $query_string 相同
$uri：当前请求的 uri，不带参数
$request_uri：请求的 uri，带完整参数
$host：http 请求报文中 host 首部，如果没有 host 首部，则以处理此请求的虚拟主机的主机名替代
$hostname：nginx 服务运行在主机的主机名
$remote_addr：客户端 ip
$remote_port：客户端 port
$remote_user：使用用户认证时客户端用户输入的用户名
$request_filename：用户请求中的 uri 经过本地 root  或 alias 转换后映射的本地的文件路径
$request_method：请求方法
$server_addr：服务器地址
$server_name：服务器名称
$server_port：服务器端口
$server_protocol：服务器向客户端发送响应时的协议，如 http/1.1，http/1.0
$scheme：在请求中使用的 scheme，如 https://www.magedu.com/ 中的 https
$http_name：匹配请求报文中的指定 header，如 $http_host 匹配请求报文中的 host 首部
$sent_http_name：匹配响应报文中指定的 header，例如 $sent_content_type 匹配响应报文中的 content-type 首部
$status：响应状态