nginx学习（二）：初识配置文件

nginx的配置文件默认在nginx安装目录中的conf子目录中，主配置文件为nginx.conf，

root@mgmserver conf]# pwd
/usr/local/nginx/conf
一、配置文件

[root@mgmserver conf]# vi nginx.conf 

       1
      2 #user  nobody;         #指定运行的用户和组；
      3 worker_processes  1;               #工作进程数，一般与CPU核数相同或是2倍；
      4#指定全局错误日志的路径，错误日志可选项 有[debug|info|notice|warn|error|crit]
      5 #error_log  logs/error.log;
      6 #error_log  logs/error.log  notice;
      7 #error_log  logs/error.log  info;
      8
      9 #pid        logs/nginx.pid;    #指定pid文件存放的路径
     10
     11
     12 events {

              use epoll;使用的网络I/O模式，LINUX下使用epoll模型；freebsd使用kqueue模型；在events 这里，默认的是不是没有设置使用的模型；如果要使用epoll 模型要在安装时带上--with-poll_module=epoll；
     13     worker_connections  1024;   #允许的连接数；
     14 }
     15
     16#设定http服务器，利用它的反向代理功能提供负载均衡支持；
     17 http {       
     18     include       mime.types;      #设定mime类型；
     19     default_type  application/octet-stream;
     20#设置日志格式
     21     #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
     22     #                  '$status $body_bytes_sent "$http_referer" '
     23     #                  '"$http_user_agent" "$http_x_forwarded_for"';
     24
     25     #access_log  logs/access.log  main;
     26
     27     sendfile        on;   #默认开启sendfile，sendfile能有效提高web传输文件的效率，nginx会自动使用
     28     #tcp_nopush     on;      #允许或禁止使用socket的tcp_nopush（on freebsd)或tcp_cork(on linux)选项，这个选项仅仅使用sendfile的时候可以用。

           tcp_nodelay     on;

转帖自：http://blog.phpwap.net/?p=14对TCP_NODELAY 和 TCP_CORK的解释，
这两个选项都对网络连接的行为具有重要的作用。许多UNIX系统都实现了 TCP_NODELAY选项，但是，TCP_CORK则是Linux系统所独有的 而且相对较新；它首先在内核版本2.4上得以实现。此外，其他UNIX系统版本也有功能类似的选项，值得注意的是，在某种由BSD派生的系统上的 TCP_NOPUSH选项其实就是TCP_CORK的一部分具体实现。
TCP_NODELAY和TCP_CORK基本上控制了包的“Nagle 化”，Nagle化在这里的含义是采用Nagle算法把较小的包组装为更大的帧。 John Nagle是Nagle算法的发明人，后者就是用他的名字来命名的，他在1984年首次用这种方法来尝试解决福特汽车公司的网络拥塞问题（欲了解详情请参 看IETF RFC 896）。他解决的问题就是所谓的silly window syndrome ，中文称“愚蠢窗口症候群”，具体含义是，因为普遍终端应用程序每产生一次击键操作就会发送一个包，而典型情况下一个包会拥有一个字节的数据载荷以及40 个字节长的包头，于是产生4000%的过载，很轻易地就能令网络发生拥塞,。 Nagle化后来成了一种标准并且立即在因特网上得以实现。它现在已经成为缺省配置了，但在我们看来，有些场合下把这一选项关掉也是合乎需要的。
现在让我们假设某个应用程序发出了一个请求，希望发送小块数据。我们可以选择立即发送数据或者等待产生更多的数据然后再一次发送两种策略。如果我们马上发 送数据，那么交互性的以及客户/服务器型的应用程序将极大地受益。例如，当我们正在发送一个较短的请求并且等候较大的响应时，相关过载与传输的数据总量相 比就会比较低，而且，如果请求立即发出那么响应时间也会快一些。以上操作可以通过设置套接字的TCP_NODELAY选项来完成，这样就禁用了Nagle 算法。
另外一种情况则需要我们等到数据量达到最大时才通过网络一次发送全部数据，这种数据传输方式有益于大量数据的通信性能，典型的应用就是文件服务器。应用 Nagle算法在这种情况下就会产生问题。但是，如果你正在发送大量数据，你可以设置TCP_CORK选项禁用Nagle化，其方式正好同 TCP_NODELAY相反（TCP_CORK 和 TCP_NODELAY 是互相排斥的）。下面就让我们仔细分析下其工作原理。
假设应用程序使用sendfile()函数来转移大量数据。应用协议通常要求发送某些信息来预先解释数据，这些信息其实就是报头内容。典型情况下报头很 小，而且套接字上设置了TCP_NODELAY。有报头的包将被立即传输，在某些情况下（取决于内部的包计数器），因为这个包成功地被对方收到后需要请求 对方确认。这样，大量数据的传输就会被推迟而且产生了不必要的网络流量交换。
但是，如果我们在套接字上设置了TCP_CORK（可以比喻为在管道上插入“塞子”）选项，具有报头的包就会填补大量的数据，所有的数据都根据大小自动地 通过包传输出去。当数据传输完成时，最好取消TCP_CORK 选项设置给连接“拔去塞子”以便任一部分的帧都能发送出去。这同“塞住”网络连接同等重要。
总而言之，如果你肯定能一起发送多个数据集合（例如HTTP响应的头和正文），那么我们建议你设置TCP_CORK选项，这样在这些数据之间不存在延迟。能极大地有益于WWW、FTP以及文件服务器的性能，同时也简化了你的工作。示例代码如下：

intfd, on = 1;
…
/* 此处是创建套接字等操作，出于篇幅的考虑省略*/
…
setsockopt (fd, SOL_TCP, TCP_CORK, &on, sizeof (on)); /* cork */
write (fd, …);
fprintf (fd, …);
sendfile (fd, …);
write (fd, …);
sendfile (fd, …);
…
on = 0;
setsockopt (fd, SOL_TCP, TCP_CORK, &on, sizeof (on)); /* 拔去塞子 */

不幸的是，许多常用的程序并没有考虑到以上问题。例如，Eric Allman编写的sendmail就没有对其套接字设置任何选项。
Apache HTTPD是因特网上最流行的Web服务器，它的所有套接字就都设置了TCP_NODELAY选项，而且其性能也深受大多数用户的满意。这是为什么呢？答 案就在于实现的差别之上。由BSD衍生的TCP/IP协议栈（值得注意的是FreeBSD）在这种状况下的操作就不同。当在TCP_NODELAY 模式下提交大量小数据块传输时，大量信息将按照一次write()函数调用发送一块数据的方式发送出去。然而，因为负责请求交付确认的记数器是面向字节而 非面向包（在Linux上）的，所以引入延迟的概率就降低了很多。结果仅仅和全部数据的大小有关系。而 Linux 在第一包到达之后就要求确认，FreeBSD则在进行如此操作之前会等待好几百个包。

在Linux系统上，TCP_NODELAY的效果同习惯于BSD TCP/IP协议栈的开发者所期望的效果有很大不同，而且在Linux上的Apache性能表现也会更差些。其他在Linux上频繁采用TCP_NODELAY的应用程序也有同样的问题。

   #设定请求缓冲；

       client_header_buffer_size      1k;

    large_client_header_size       50k；

   #设定客户端能够上传文件的大小

    client_max_body_size            8m;

     29
     30     #keepalive_timeout  0;
     31     keepalive_timeout  65;
     32
     33     #gzip  on;    #是否开启gzip压缩模块
     34#设定虚拟主机
     35     server {
     36         listen       80;   #监听端口
     37         server_name  localhost;#主机名称

    38
     39         #charset koi8-r;#设置使用字符集
     40
     41         #access_log  logs/host.access.log  main;#访问日志文件存放路径
     42
     43         location / {
     44             root   html;#网页存放的目录，也可是绝对路径
     45             index  index.html index.htm;#默认首页顺序
     46         }
     47
     48         error_page  404              /404.html;
     49
     50         # redirect server error pages to the static page /50x.html
     51         #
     52         error_page   500 502 503 504  /50x.html;
     53         location = /50x.html {
     54             root   html;
     55         }
     56
     57         # proxy the PHP scripts to Apache listening on 127.0.0.1:80
     58         #
     59         #location ~ .php$ {
     60         #    proxy_pass   http://127.0.0.1;
     61         #}
     62
     63         # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
     64         #
     65         #location ~ .php$ {
     66         #    root           html;
     67         #    fastcgi_pass   127.0.0.1:9000;
     68         #    fastcgi_index  index.php;
     69         #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
     70         #    include        fastcgi_params;
     71         #}
     72
     73         # deny access to .htaccess files, if Apache's document root
     74         # concurs with nginx's one
    75         #
     76         #location ~ /.ht {
     77         #    deny  all;
     78         #}
     79     }
     80
     81
     82     # another virtual host using mix of IP-, name-, and port-based configuration
     83     #
     84     #server {
     85     #    listen       8000;
     86     #    listen       somename:8080;
     87     #    server_name  somename  alias  another.alias;
     88
     89     #    location / {
     90     #        root   html;
     91     #        index  index.html index.htm;
     92     #    }
     93     #}
     94
     95
     96     # HTTPS server
     97     #
     98     #server {
     99     #    listen       443;
    100     #    server_name  localhost;
    101
    102     #    ssl                  on;
    103     #    ssl_certificate      cert.pem;
    104     #    ssl_certificate_key  cert.key;
    105
    106     #    ssl_session_timeout  5m;
    107
    108     #    ssl_protocols  SSLv2 SSLv3 TLSv1;
    109     #    ssl_ciphers  ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
    110     #    ssl_prefer_server_ciphers   on;
     111
    112     #    location / {
    113     #        root   html;
    114     #        index  index.html index.htm;
    115     #    }
    116     #}
    117
    118 }
  =========================================================

二、配置文件格式：上面的是nginx.conf的配置示例，有些是添加上去的，主要构成可以简化为：

 

......

events

{

......

}

http{

......

server{

 

 

......

       }

server{

.......      

       }

.......

}

 

实际上这么分开我们就能一目了然的看到nginx.conf配置文件的结构，不是很难；

 

三、nginx的代理文件注释

 

proxy_redirect                                  off;

#proxy_set_header 指令用于在反向代理的后端web服务器发起请求时添加指定的header头信息；
proxy_set_header           Host   $host;
proxy_set_header           X-Real-IP $remote_addr;

 

#允许客户端请求的最大单个文件字节数；
client-max_body_size      10m;
#缓冲区代理缓冲用户端请求的最大字节数，可以理解为先保存到本地再传给用户；
client_body_buffer_size   128;
#跟后端服务器连接超时时间，发起握手等候响应超时时间；
poxy_connect_timeout      5;
#连接成功后，等候后端服务器响应时间，其实已经进入后端的排队之中等候处理；
proxy_read_timeout        60;
#后端服务器数据回传时间，就是规定时间内后端服务器必须传完所有的数据；
proxy_send_timeout         5;
#代理请求缓存区，这个缓存区见会保护用户的头信息以提供nginx进行校对规则，一般只要能保存下头
#信息即可
proxy_buffer_size        16k;
#同上 ，告诉nginx保存单个用的几个buffer最大用多大空间
proxy_buffers         4   64k;
#如果系统很忙的时候可以申请更大的proxy_buffers官方推荐×2
proxy_busy_buffers_size 128k;
#proxy缓存临时文件的大小；
proxy_temp_file_write_size 128k;