Nginx配置文件功能注释

最新推荐文章于 2024-05-23 16:42:11 发布

weixin_34235135

最新推荐文章于 2024-05-23 16:42:11 发布

阅读量603

点赞数

文章标签：运维 axure epoll

本文详细介绍Nginx配置文件的各个部分及其功能，重点介绍如何配置Nginx实现负载均衡，包括设置用户、进程数、错误日志、工作模式等。

最近在学配置Nginx做均衡负载，首先最重要的是Nginx的配置文件，参考网上查到的资料，并结合实践，

将该配置文件的详细功能注释在这里做下笔记，方便今后查阅。

官方的Nginx Wiki(英文) http://wiki.nginx.org/Configuration

环境：FreeBSD8.0+Nginx1.0.10_1

配置文件位置： /usr/local/etc/nginx（所有配置文件都在此文件夹）

可执行文件位置： /usr/local/sbin/nginx

服务所在位置： /usr/local/etc/rc.d/nginx

启动： /usr/local/etc/rc.d/nginx start

停止： /usr/local/etc/rc.d/nginx stop

重启： /usr/local/etc/rc.d/nginx restart

测试配置： /usr/local/etc/rc.d/nginx configtest

重载配置： /usr/local/etc/rc.d/nginx reload

服务状态： /usr/local/etc/rc.d/nginx status

主配置文件nginx.conf注释：

#运行服务的用户及用户组

user www www;

#服务开启的进程数

worker_processes 5;

#全局错误日志及PID 文件

error_log logs/error.log notice;

pid logs/nginx.pid;

#限定允许打开的文件的文件描述符长度，包括配置文件、日志文件等，如不指定，则使用操作系统默认值worker_rlimit_nofile 8192;

#工作模式及连接数上限

events {

#工作模式有：

select(标准模式),

poll(标准模式),

kqueue(高效模式，适用FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 and MacOS X),
epoll(高效模式，适用Linux 2.6+,SuSE 8.2,),

/dev/poll(高效模式,适用Solaris 7 11/99+,HP/UX 11.22+)

eventport(IRIX 6.5.15+ 和 Tru64 UNIX 5.1A+)

use epoll;

#单个进程允许的最大连接数，总连接数为：worker_processes*worker_connections

worker_connections 1024;
}

#设定http服务器，利用它的反向代理功能提供负载均衡支持

http {

#设定配置文件位置，这里的conf是指nginx.conf所在的目录，也可以用绝对路径指定其他地方的配置文件

include conf/mime.types;

include conf/fastcgi.conf;

#默认类型-8进制文件流

default_type application/octet-stream;

#全局首页类型

index index.html index.htm index.php

#设定日志格式

log_format main '$remote_addr - $remote_user [$time_local] '

'"$request" $status $bytes_sent '

'"$http_referer" "$http_user_agent" '

'"$gzip_ratio"';

log_format download '$remote_addr - $remote_user [$time_local] '

'"$request" $status $bytes_sent '

'"$http_referer" "$http_user_agent" '

'"$http_range" "$sent_http_content_range"';

#是否激活sendfile()函数，比默认模式更有效率

sendfile on;

#将HTTP响应头压缩到一个包中发送，仅在sendfile开启时才能配合使用

tcp_nopush on;

#指定保存服务器名称的hash表的大小，存在多个域名或虚拟主机时指定

server_names_hash_bucket_size 128;

#设定用户请求header缓冲区大小

client_header_buffer_size 10k;

large_client_header_buffers 4 4k;

#开启gzip模块，要求安装gzip 在运行./config时要指定

gzip on;

gzip_min_length 1100;

gzip_buffers 4 8k;

gzip_types text/plain;

output_buffers 1 32k;

postpone_output 1460;

#设定访问日志

access_log logs/access.log main;

client_header_timeout 3m;

client_body_timeout 3m;

send_timeout 3m;

sendfile on;

tcp_nopush on;

tcp_nodelay on;

keepalive_timeout 65;

#设定负载均衡的服务器列表

upstream backserver {

#weigth参数表示权值，权值越高被分配到的几率越大

#本例是指在同一台服务器，多台服务器改变ip即可

server 127.0.0.1:8081 weight=5;

server 127.0.0.1:8082;

server 127.0.0.1:8083;

}

#设定虚拟主机，默认为监听80端口

server {

listen 80;

server_name test.com www.test.com;

charset utf8;

#设定本虚拟主机的访问日志

access_log logs/test.com.log main;

#如果访问 /images/*, /js/*, /css/* 资源，则直接取本地文件，不用转发。

#但如果文件较多效果不是太好。

location ~ ^/(images|js|css)/ {

root /usr/local/testweb;

expires 30m;

}

#对 "/" 启用负载均衡

location / {

proxy_pass http://backserver;

proxy_redirect off;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; client_max_body_size 10m;

client_body_buffer_size 128k;

proxy_connect_timeout 90;

proxy_send_timeout 90;

proxy_read_timeout 90;

proxy_buffer_size 4k;

proxy_buffers 4 32k;

proxy_busy_buffers_size 64k;

proxy_temp_file_write_size 64k;

}

#设定查看Nginx状态的地址,在运行./config 要指定，默认是不安装的。

location /NginxStatus {

stub_status on;

access_log on;

auth_basic "NginxStatus";

#是否要通过用户名和密码访问，测试时可以不加上。

#conf/htpasswd 文件的内容用apache提供的htpasswd工具来产生即可

#auth_basic_user_file conf/htpasswd;

}