Nginx基础篇（2）- Nginx基本配置文件和变量详解

Nginx基本配置文件和变量详解

1. 基本配置文件

/etc/nginx/nginx.conf

```
# nginx运行的用户
user nginx;
# nginx进程数，建议设置为等于CPU总核心数。
worker_processes 1;

全局错误日志文件名称和所在目录，错误日志记录级别[ debug | info | notice | warn | error | crit ]

error_log /var/log/nginx/error.log warn;

进程文件nginx.pid所在目录

pid /var/run/nginx.pid;

一个nginx进程打开的最多文件描述符数目，

理论值应该是最多打开文件数（系统的值ulimit -n）与nginx进程数相除，

但是nginx分配请求并不均匀，所以建议与ulimit -n的值保持一致。

worker_rlimit_nofile 65535;

events {

# 参考事件模型，use [ kqueue | rtsig | epoll | /dev/poll | select | poll ];

# epoll模型是Linux 2.6以上版本内核中的高性能网络I/O模型，如果跑在FreeBSD上面，就用kqueue模型。

# use epoll;

# 单个进程最大连接数（最大连接数 = 连接数 * 进程数）
worker_connections  1024;

# multi_accept on;

}

http服务器配置

http {

# 引入http协议的Content-Type与扩展名对应关系的文件

include /etc/nginx/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"';

# HTTP服务器请求日志文件的名称和所在目录、日志记录级别
access_log  /var/log/nginx/access.log  main;

# 开启高效文件传输模式。
# sendfile指令指定nginx是否调用sendfile函数来输出文件，对于普通应用设为on，
# 如果用来进行下载等应用磁盘IO重负载应用，可设置为off，以平衡磁盘与网络I/O处理速度，降低系统的负载。
# 注意：如果图片显示不正常把这个改成off。
sendfile        on;
# 防止网络阻塞
# tcp_nopush    on;
# tcp_nodelay   on;

# 开启目录列表访问，合适下载服务器，默认关闭。
# autoindex on; 

# 开启限制IP连接数的时候需要使用
# limit_zone crawler $binary_remote_addr 10m; 

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

# gzip模块设置
# 开启gzip压缩输出
# gzip  on;
# 最小压缩文件大小
# gzip_min_length 1k;
# 压缩缓冲区
# gzip_buffers 4 16k;
# 压缩版本（默认1.1，前端如果是squid2.5请使用1.0）
# gzip_http_version 1.0;
# 压缩等级
# gzip_comp_level 2;
# 压缩类型，默认就已经包含text/html，所以下面就不用再写了，写上去也不会有问题，但是会有一个warn。
# gzip_types text/plain application/x-javascript text/css application/xml;
# gzip_vary on;

# FastCGI相关参数是为了改善网站的性能：减少资源占用，提高访问速度。
# fastcgi_connect_timeout 300;
# fastcgi_send_timeout 300;
# fastcgi_read_timeout 300;
# fastcgi_buffer_size 128k;
# fastcgi_buffers 8 128k;
# fastcgi_busy_buffers_size 128k;
# fastcgi_temp_file_write_size 128k;

# 允许客户端请求的最大单文件字节数。
# 如果请求大于指定的大小，则NGINX发回HTTP 413（Request Entity too large）错误。
# 如果服务器处理大文件上传，则该指令非常重要。
# client_max_body_size 20m;
# 用于请求主体的缓冲区大小。
# 如果主体超过缓冲区大小，则完整主体或其一部分将写入临时文件。
# 如果NGINX配置为使用文件而不是内存缓冲区，则该指令会被忽略。
# 默认情况下，该指令为32位系统设置一个8k缓冲区，为64位系统设置一个16k缓冲区。
# 该指令在NGINX配置的http，server和location区块使用。
# client_body_buffer_size 128k;

# upstream abc.com {
    # upstream的负载均衡，weight是权重，可以根据机器配置定义权重。weigth参数表示权值，权值越高被分配到的几率越大。
#     server 192.168.10.121:80 weight=3;
#     server 192.168.10.122:80 weight=2;
#     server 192.168.10.123:80 weight=3;
# }

# 引入 '/etc/nginx/conf.d/' 目录下以 '.conf' 结尾的文件
include /etc/nginx/conf.d/*.conf;

# 虚拟主机的配置
server {
    # 监听端口
    listen       80;
    # 域名，可以有多个，用空格隔开
    server_name  localhost;

    # 默认编码
    # charset utf-8; 

    # 日志格式设定
    # log_format access '$remote_addr - $remote_user [$time_local] "$request" '
    # '$status $body_bytes_sent "$http_referer" '
    # '"$http_user_agent" $http_x_forwarded_for';
    # 当前虚拟主机请求日志文件的名称和所在目录、日志记录级别
    # access_log  /var/log/nginx/host.access.log  main;

    location / {
        root   /usr/share/nginx/html;
        index  index.html index.htm;
    }

    #error_page  404              /404.html;

    # 将服务器错误页面重定向到静态页面 /50x.html
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

    # proxy the PHP scripts to Apache listening on 127.0.0.1:80
    # 将 PHP 脚本反向代理到监听 127.0.0.1:80 端口的Apache
    #location ~ \.php$ {
    #    proxy_pass   http://127.0.0.1;
    #}

    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
    # 将 PHP 脚本反向代理到监听127.0.0.1:9000端口的FastCGI服务器
    #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;
    #}

    # 如果Apache的文档根目录与nginx的相同，拒绝访问.htaccess文件。
    #location ~ /\.ht {
    #    deny  all;
    #}

    # 图片缓存时间设置
    # location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ {
    #     expires 10d;
    # }

    # JS和CSS缓存时间设置
    # location ~ .*\.(js|css)?$ {
    #     expires 1h;
    # }

    # 对 "/" 启用反向代理
    # location / {
    #     proxy_pass http://127.0.0.1:88;
    #     proxy_redirect off;
    #     # 后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
    #     proxy_set_header X-Real-IP $remote_addr;
    #     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    #     # 以下是一些反向代理的配置，可选。
    #     proxy_set_header Host $host;
    #     # nginx跟后端服务器连接超时时间(代理连接超时)
    #     proxy_connect_timeout 90;
    #     # 后端服务器数据回传时间(代理发送超时)
    #     proxy_send_timeout 90;
    #     # 连接成功后，后端服务器响应时间(代理接收超时)
    #     proxy_read_timeout 90;
    #     # 设置代理服务器（nginx）保存用户头信息的缓冲区大小
    #     proxy_buffer_size 4k;
    #     # proxy_buffers缓冲区，网页平均在32k以下的设置
    #     proxy_buffers 4 32k;
    #     # 高负荷下缓冲大小（proxy_buffers*2）
    #     proxy_busy_buffers_size 64k;
    #     # 设定缓存文件夹大小，大于这个值，将从upstream服务器传
    #     proxy_temp_file_write_size 64k;
    # }
}

}

<h3>2. Nginx变量</h3>
<h4><strong>HTTP请求变量</strong></h4>
<ul>
<li>
<code>arg_参数名</code>：例如，$arg_userid，可以引用到请求参数userid的值</li>
<li>
<code>http_请求HEADER名</code>：例如，$http_user_agent，可以引用到请求头信息User-Agent的值</li>
<li>
<code>sent_http_返回HEADER名</code>：在响应客户端可添加header头信息</li>
</ul>
<h4><strong>内置变量</strong></h4>
<blockquote>Nginx内置的变量，参考Nginx文档的<a href="http://nginx.org/en/docs/syslog.html" rel="nofollow noreferrer">Logging to syslog</a>
</blockquote>
<h4><strong>自定义变量</strong></h4>
<p>服务器管理员自己定义的变量</p>

原文地址：https://segmentfault.com/a/1190000015591040