Nginx 配置文件详解

2023-01-30 09:19:57 阅读:1431 评论:0 点赞:0
所属分类: Nginx

温馨提示

所有 nginx 的配置都必须用 ; 结尾。

一、nginx.conf 中的配置详解

# 指定 Nginx 运行的用户和用户组(不指定)
user www www;

# 设置 nginx 工作进程数量(建议该值等于CPU的核数)
worker_processes 8;

# 全局错误日志保存文件,即记录日志等级[debug | info | notice | warn | error | crit]
error_log /usr/local/nginx/logs/error.log info;

# 指定记录 nginx 进程PID的文件
pid /usr/local/nginx/logs/nginx.pid;

# 指定工作进程可以打开的最大文件描述符数量
# 这个指令是指当一个nginx进程打开的最多文件描述符数目,理论值应该是最多打开文件数(ulimit -n)与nginx进程数相除,但是nginx分配请求并不是那么均匀,所以最好与ulimit -n 的值保持一致。
# 现在在linux 2.6内核下开启文件打开数为65535,worker_rlimit_nofile就相应应该填写65535。
# 这是因为nginx调度时分配请求到进程并不是那么的均衡,所以假如填写10240,总并发量达到3-4万时就有进程可能超过10240了,这时会返回502错误。
worker_rlimit_nofile 65535;

events {
	# 参考事件模型,use [ kqueue | rtsig | epoll | /dev/poll | select | poll ];
	# 与apache相类,nginx针对不同的操作系统,有不同的事件模型
	# 1、标准事件模型
	# Select、poll属于标准事件模型,如果当前系统不存在更有效的方法,nginx会选择select或poll
	# 2、高效事件模型
	# Kqueue:使用于FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 和 MacOS X.使用双处理器的MacOS X系统使用kqueue可能会造成内核崩溃。
	# epoll:是Linux 2.6以上版本内核中的高性能网络I/O模型,linux建议epoll,如果跑在FreeBSD上面,就用kqueue模型。
	# /dev/poll:使用于Solaris 7 11/99+,HP/UX 11.22+ (eventport),IRIX 6.5.15+ 和 Tru64 UNIX 5.1A+。
	# Eventport:使用于Solaris 10。 为了防止出现内核崩溃的问题, 有必要安装安全补丁。
	use epoll;

	# 单个进程最大连接数(最大连接数=连接数*进程数)
	# 根据硬件调整,和前面工作进程配合起来用,尽量大,但是别把cpu跑到100%就行。每个进程允许的最多连接数,理论上每台nginx服务器的最大连接数为。
	worker_connections 65535;

	# 是否开启惊群效应
	# 设置为 off 表示,当进入一个连接时,开启多个进程响应;优点:处理并发效率高,缺点:占用CPU和内存。
	# 设置为 on  表示,当进入一个连接时,只开启一个进程响应;优点:节省系统资源,缺点:并发量大时影响效率。
	accept_mutex off;

	# keepalive 超时时间
	keepalive_timeout 60;

	# 设置客户端请求头部的缓冲区大小
	# 可以根据系统分页大小来设置,一般请求头大小都小于1k,不过一般系统的分页大小都大于1k,所以这里就设置为系统分页大小
	# getconf PAGESIZE 命令可以获取系统分页大小
	# 若请求头有超过4k的,我们则需要将其设置为系统分页大小的整数倍。
	client_header_buffer_size 4k;

	# 指定打开文件缓存数量和缓存超时时长
	# max指定缓存数量(建议和打开文件数一致),inactive指定缓存时长(文件多久没被访问将被删除缓存)。
	open_file_cache max=65535 inactive=60s;

	# 多久检查一次缓存的有效性(默认:60s)
	open_file_cache_valid 80s;

	# 访问次数低于该值的文件缓存将本移除(inactive 根据该值进行判断)
	open_file_cache_min_uses 1;

	# 是否记录 cache 错误
	open_file_cache_errors on;
}

# 设置HTTP服务
http {
	# 引入文件拓展名与文件类型映射表
	include mime.types;

	# 指定HTTP默认文件类型(将决定浏览器如何处理响应的内容)
	default_type application/octet-stream;

	# 默认编码
	charset utf-8;

	# 指定服务器名字 hash 表大小
	server_names_hash_bucket_size 128;

	# 客户端请求头部的缓冲区大小。这个可以根据你的系统分页大小来设置
	# 一般一个请求的头部大小不会超过1k,不过由于一般系统分页都要大于1k,所以这里设置为分页大小。
	# 分页大小可以用命令getconf PAGESIZE取得。
	client_header_buffer_size 32k;

	# 客户请求头缓冲大小。
	# nginx默认会用client_header_buffer_size这个buffer来读取header值
	# 如果header过大,它会使用large_client_header_buffers来读取。
	large_client_header_buffers 4 64k;

	# 设定通过 nginx 上传文件的大小
	client_max_body_size 8m;

	# 是否开启数据零拷贝;未开启的情况下,nginx 程序会先去读取访问的资源内容,然后缓存起来再转发给网络接口;
	# 如果开启,网络接口访问资源时会将资源的文件描述符返回给网络接口,这样就直接去读取对应资源的内容,
	# 从而程序少了一个读取和缓存的步骤,访问更加快速和节省系统资源。
	sendfile on;

	# 1.需要sendfile开启时才生效
	# 2.tcp_nopush 与 tcp_nodelay 是互斥的。
	# 3.tcp_nopush on; 此选项允许使用socker的TCP_CORK的选项。控制包的Nagle化。
	# TCP_CORK:是Linux下tcp/ip传输标准,再tcp交互过程中,当程序接收到数据包不会马上传出去,等到数据包最大时一次性传输出去,这样有助于解决网络堵塞(默认)。
	# TCP_CORK:更适合文件服务器,需要传输大量数据的服务器等。
	tcp_nopush on;

	# 1.需要sendfile开启时才生效
	# 2.tcp_nopush 与 tcp_nodelay 是互斥的。
	# 3.tcp_nodelay on; 此选项禁用socker的TCP_NODELAY的选项。
	# TCP_NODELAY:是Linux下tcp/ip传输标准,再tcp交互过程中,当程序接收到数据包时会马上传出去,省去0.2秒交互,速度快。
	# TCP_NODELAY:适合交互性多以及客户端/服务器形应用程序。
	tcp_nodelay on;

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

	# 限制请求体的大小,若超过所设定的大小,返回413错误。
	client_max_body_size 2048;

	# 长连接超时时间,单位是秒
	keepalive_timeout 120;

	# FastCGI相关参数是为了改善网站的性能:减少资源占用,提高访问速度。下面参数看字面意思都能理解。
	fastcgi_connect_timeout 300;
	fastcgi_send_timeout 300;
	fastcgi_read_timeout 300;
	fastcgi_buffer_size 64k;
	fastcgi_buffers 4 64k;
	fastcgi_busy_buffers_size 128k;
	fastcgi_temp_file_write_size 128k;

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

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

	# 配置负载均衡
	upstream www.test.com {
		# weight 表示权重,值越大表示分配到的机率越大。
		server 192.168.0.1 weight=8;
		server 192.168.0.2 weight=2;
		server 192.168.0.3 weight=6;

		# 4种分配方式:
		# 1、轮询(表示依次分配请求)
		# 2、ip_hash(根据用户IP地址,hash到相同服务器)
		# 3、url_hash(第三方,根据URI哈希到服务器)
		# 4、fair(第三方,根据服务端响应时间来分配)

		# 注意:需要在 server 中增加(proxy_pass http://bakend/;)
		# 每个设备的状态设置为:
		# 1.down表示单前的server暂时不参与负载
		# 2.weight为weight越大,负载的权重就越大。
		# 3.max_fails:允许请求失败的次数默认为1.当超过最大次数时,返回proxy_next_upstream模块定义的错误
		# 4.fail_timeout:max_fails次失败后,暂停的时间。
		# 5.backup: 其它所有的非backup机器down或者忙的时候,请求backup机器。所以这台机器压力会最轻。
		# nginx支持同时设置多组的负载均衡,用来给不用的server来使用。
		# client_body_in_file_only设置为On 可以讲client post过来的数据记录到文件中用来做debug
		# client_body_temp_path设置记录文件的目录 可以设置最多3层目录
		# location对URL进行匹配.可以进行重定向或者进行新的代理 负载均衡
	}

	# 虚拟主机配置(可以多个,通过端口号+服务名区分)
	server {
		# 监听端口
		listen 80;

		# 域名(可指定多个)
		server_name www.test.com test.com;

		# 默认页
		index index.html index.htm index.php;

		# 主目录
		root /data/www/blog;

		# 定义匹配规则
		location ~ .*.(php|php5)?$ {
			fastcgi_pass 127.0.0.1:9000;
			fastcgi_index index.php;
			include fastcgi.conf;
		}

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

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

		# 日志格式设定
		# $remote_addr与$http_x_forwarded_for用以记录客户端的ip地址;
		# $remote_user:用来记录客户端用户名称;
		# $time_local: 用来记录访问时间与时区;
		# $request: 用来记录请求的url与http协议;
		# $status: 用来记录请求状态;成功是200,
		# $body_bytes_sent :记录发送给客户端文件主体内容大小;
		# $http_referer:用来记录从那个页面链接访问过来的;
		# $http_user_agent:记录客户浏览器的相关信息;
		# 通常web服务器放在反向代理的后面,这样就不能获取到客户的IP地址了,通过$remote_add拿到的IP地址是反向代理服务器的iP地址。
		# 反向代理服务器在转发请求的http头信息中,可以增加x_forwarded_for信息,用以记录原有客户端的IP地址和原来客户端的请求的服务器地址。
		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 /usr/local/nginx/logs/host.access.log main;
		access_log /usr/local/nginx/logs/host.access.404.log log404;


		# 对 "/" 启用反向代理
		location / {
			proxy_pass http://127.0.0.1:88;
			proxy_redirect off;
			proxy_set_header X-Real-IP $remote_addr;

			# 后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
			proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

			# 以下是一些反向代理的配置,可选。
			proxy_set_header Host $host;

			# 允许客户端请求的最大单文件字节数
			client_max_body_size 10m;

			# 缓冲区代理缓冲用户端请求的最大字节数,
			# 如果把它设置为比较大的数值,例如256k,那么,无论使用firefox还是IE浏览器,来提交任意小于256k的图片,都很正常。如果注释该指令,使用默认的client_body_buffer_size设置,也就是操作系统页面大小的两倍,8k或者16k,问题就出现了。
			# 无论使用firefox4.0还是IE8.0,提交一个比较大,200k左右的图片,都返回500 Internal Server Error错误
			client_body_buffer_size 128k;

			# 表示使nginx阻止HTTP应答代码为400或者更高的应答。
			proxy_intercept_errors on;

			# 后端服务器连接的超时时间_发起握手等候响应超时时间
			# nginx跟后端服务器连接超时时间(代理连接超时)
			proxy_connect_timeout 90;

			# 后端服务器数据回传时间(代理发送超时)
			# 后端服务器数据回传时间_就是在规定时间之内后端服务器必须传完所有的数据
			proxy_send_timeout 90;

			# 连接成功后,后端服务器响应时间(代理接收超时)
			# 连接成功后_等候后端服务器响应时间_其实已经进入后端的排队之中等候处理(也可以说是后端服务器处理请求的时间)
			proxy_read_timeout 90;

			# 设置代理服务器(nginx)保存用户头信息的缓冲区大小
			# 设置从被代理服务器读取的第一部分应答的缓冲区大小,通常情况下这部分应答中包含一个小的应答头,默认情况下这个值的大小为指令proxy_buffers中指定的一个缓冲区的大小,不过可以将其设置为更小
			proxy_buffer_size 4k;

			# proxy_buffers缓冲区,网页平均在32k以下的设置
			# 设置用于读取应答(来自被代理服务器)的缓冲区数目和大小,默认情况也为分页大小,根据操作系统的不同可能是4k或者8k
			proxy_buffers 4 32k;

			# 高负荷下缓冲大小(proxy_buffers*2)
			proxy_busy_buffers_size 64k;

			# 设置在写入proxy_temp_path时数据的大小,预防一个工作进程在传递文件时阻塞太长
			# 设定缓存文件夹大小,大于这个值,将从upstream服务器传
			proxy_temp_file_write_size 64k;
		}

		# 设定查看Nginx状态的地址
		location /NginxStatus {
			stub_status on;
			access_log on;
			auth_basic "NginxStatus";
			auth_basic_user_file confpasswd;
			#htpasswd文件的内容可以用apache提供的htpasswd工具来产生。
		}

		# 本地动静分离反向代理配置
		# 所有jsp的页面均交由tomcat或resin处理
		location ~ .(jsp|jspx|do)?$ {
			proxy_set_header Host $host;
			proxy_set_header X-Real-IP $remote_addr;
			proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
			proxy_pass http://127.0.0.1:8080;
		}

		# 所有静态文件由nginx直接读取不经过tomcat或resin
		location ~ .*.(htm|html|gif|jpg|jpeg|png|bmp|swf|ioc|rar|zip|txt|flv|mid|doc|ppt|
		pdf|xls|mp3|wma)$ {
			expires 15d;
		}

		location ~ .*.(js|css)?$ {
			expires 1h;
		}
	}
}
标签: nginx 配置

永不言弃

职业:后端开发工程师
学校:重庆师范大学
城市:重庆
文章:169
好吧,不知道说点什么...

登录逐梦笔记

注册逐梦笔记

已有账号?