序

本文主要解析一下nginx http模块配置参数。主要分socket相关参数，对clinet请求的buffer参数以及对response的buffer参数。

socket

client buffer

proxy buffer

实例

http {
    include       mime.types;
    default_type  application/octet-stream;

    access_log  /dev/stdout main;

    ##------socket配置----------##
    sendfile        on;
    tcp_nodelay     on;
    #tcp_nopush     on;
    #server_names_hash_max_size 1024; ##设置servers hash表的大小,默认512;如果配置了多个虚拟server，比如24个域名对应一个地址,则需要考虑改此参数


    ##------client端请求设置----------##
    keepalive_timeout  65;
    client_header_timeout  60; ##读取整个header的超时时间
    client_body_timeout    60; ##连续两次读取body的超时时间
    send_timeout           10; ##这个超时时间是发送响应的超时时间，即Nginx服务器向客户端发送了数据包，但客户端一直没有去接收这个数据包。如果某个连接超过send_timeout定义的超时时间，那么Nginx将会关闭这个连接。timeout between two successive write operations for a client receiving a response.

    client_header_buffer_size    128k; ##太小了会报400,Request Header Or Cookie Too Large,默认1kb. 定义了正常情况下Nginx接收用户请求中HTTP header部分（包括HTTP行和HTTP头部）时分配的内存buffer大小。有时，请求中的HTTP header部分可能会超过这个大小，这时large_client_header_buffers定义的buffer将会生效。
    large_client_header_buffers  4 128k; ##定义了Nginx接收一个超大HTTP头部请求的buffer个数和每个buffer的大小。如果HTTP请求行（如GET/index HTTP/1.1）的大小超过单个buffer，则返回\"Request URI too large\"(414)。请求中一般会有许多header，每一个header的大小也不能超过单个buffer的大小，否则会返回\"Bad request\"(400)。当然，请求行和请求头部的总和也不可以超过buffer个数*buffer大小。
    client_max_body_size           20m; ## 客户端请求body的最大大小,超过则报413 Request Entity Too Large,通常用来设置文件上传大小
    ## client_body_temp_path      client_body_temp; ##默认是/usr/local/openresty/nginx/client_body_temp,可以自定义支持多级目录,client_body_temp_path  client_body_temp 1 2;
    client_body_buffer_size      128k;  ##在接收HTTP包体时，如果包体的大小大于client_body_buffer_size，则会以一个递增的整数命名并存放到client_body_temp_path指定的目录中


    ##-------proxy后端的设置---------##
    proxy_buffering on; #默认是on
    proxy_connect_timeout    10; ##控制连接超时,如果连接不上,直接502,Connection refused
    proxy_read_timeout       60; ##控制连续两次读取后端响应的超时,如果后端长时间未响应则504,Connection timed out
    proxy_send_timeout       10; ##控制连续两次向后端发送请求的超时,一般比较少发生
    proxy_buffer_size        128k; ##缓存response的第一部分,通常是header,默认proxy_buffer_size 被设置成 proxy_buffers 里一个buffer 的大小，当然可以设置更小些。
    proxy_buffers 128 128k; ##前面一个是num,后面一个是一个buffer的size,因此总共的buffers大小为=128*128k.Nginx将会尽可能的读取后端服务器的数据到buffer，直到proxy_buffers设置的所有buffer们被写满或者数据被读取完(EOF)，此时Nginx开始向客户端传输数据，会同时传输这一整串buffer们。如果数据很大的话，Nginx会接收并把他们写入到temp_file里去，大小由proxy_max_temp_file_size 控制。
    proxy_max_temp_file_size 1024m; ##默认情况下proxy_max_temp_file_size值为1024MB,也就是说后端服务器的文件不大于1G都可以缓存到nginx代理硬盘中，如果超过1G，那么文件不缓存，而是直接中转发送给客户端.如果proxy_max_temp_file_size设置为0，表示不使用临时缓存。
    proxy_busy_buffers_size 128k; ##一旦proxy_buffers设置的buffer被写入，直到buffer里面的数据被完整的传输完（传输到客户端），这个buffer将会一直处 在busy状态，我们不能对这个buffer进行任何别的操作。所有处在busy状态的buffer size加起来不能超过proxy_busy_buffers_size，所以proxy_busy_buffers_size是用来控制同时传输到客户端的buffer数量的。
    proxy_temp_file_write_size 128k; ##指定每次写temp file的大小
    proxy_temp_path proxy_temp; ##默认值为/usr/local/openresty/nginx/proxy_temp

    //......
}

doc

• ngx_http_core_module
• ngx_http_proxy_module
• 内存及磁盘资源的分配
• nginx proxy_buffers相关配置解释