Nginx学习笔记：配置

本文更新于2024-11-29，使用nginx 1.16。

官方文档：http://nginx.org/en/docs/。

配置文件为安装目录下的conf/nginx.conf。

变量

配置中可使用以下变量（使用了变量可能会导致不能直接解析localhost）：

$N：正则表达式匹配时与第N个分组（以()引起）匹配的内容，从0开始。
$http_upgrade：Upgrade首部的值。
$request_uri：从路径开始的请求URI。

运算符

=：等于。
~：匹配正则表达式，区分大小写。
~*：匹配正则表达式，不区分大小写。
!~：不匹配正则表达式，区分大小写。
!~*：不匹配正则表达式，不区分大小写。

配置

[]引起表示可选，大写字母需使用实际的配置值（值可使用''引起）。

http

HTTP配置。

 http {
}

http.client_max_body_size

最大的请求实体大小。可使用k、m、g等表示大小。

 http {
	client_max_body_size SIZE;
}

http.server

HTTP服务。可指定多个。

 http {
	server {
	}
}

http.server.client_max_body_size

HTTP服务最大的实体大小。可使用k、m、g等表示大小。

 http {
	server {
		client_max_body_size SIZE;
	}
}

http.server.listen

HTTP服务监听的端口。可指定使用HTTPS（SSL）。多个http.server的listen端口可以相同，但需使用不同的http.server.server_name进行区分。

 http {
	server {
		listen PORT [ssl];
	}
}

http.server.location

URL路径前缀匹配规则。可指定多个。

 http {
	server {
		location PATH_REGEXP {
		}
	}
}

http.server.location.alias

静态文件虚拟目录别名。

 http {
	server {
		location PATH_REGEXP {
			alias DIR/;
		}
	}
}

假设原始请求的路径为/PATH/SUB_PATH，PATH_REGEXP匹配/PATH或/PATH/，则使用DIR/SUB_PATH文件内容作为响应。

http.server.location.client_max_body_size

匹配此URL路径的最大的请求实体大小。可使用k、m、g等表示大小。

 http {
	server {
		location PATH_REGEXP {
			client_max_body_size SIZE;
		}
	}
}

http.server.location.default_type

默认的响应Content-Type的MIME值。

 http {
	server {
		location PATH_REGEXP {
			default_type MIME;
		}
	}
}

http.server.location.proxy_pass

反向代理请求的后端地址。

 http {
	server {
		location PATH_REGEXP {
			proxy_pass PROXY_URL;
		}
	}
}

PROXY_URL中可使用$request_uri。

假设原始请求的路径为/PATH/SUB_PATH，PATH_REGEXP匹配/PATH或/PATH/。若PROXY_URL以/结尾，则代理请求的路径为PROXY_URL/SUB_PATH；若PROXY_URL不以/结尾，则代理请求的路径为PROXY_URL/PATH/SUB_PATH。

http.server.location.proxy_read_timeout

反向代理从后端的读超时。可使用h、m、s等表示时长。

 http {
	server {
		location PATH_REGEXP {
			proxy_read_timeout TIMEOUT;
		}
	}
}

http.server.location.proxy_set_header

反向代理请求后端时的首部设置。可指定多个。

 http {
	server {
		location PATH_REGEXP {
			proxy_set_header HEADER VALUE;
		}
	}
}

VALUE可使用$http_upgrade。

http.server.location.rewrite

重定向的地址。

 http {
	server {
		location PATH_REGEXP {
			rewrite REQUEST_PATH_REGEXP REDIRECT_URL [last|break|redirect|permanent];
		}
	}
}

REDIRECT_URL可使用以下变量：

$N
$request_uri

http.server.location.root

静态文件根目录。

 http {
	server {
		location PATH_REGEXP {
			root DIR;
		}
	}
}

假设原始请求的路径为/PATH，则使用DIR/PATH文件内容作为响应。如DIR不以/开头，则为安装目录下的相对路径。

http.server.rewrite

重定向的地址。

 http {
	server {
		rewrite REQUEST_PATH_REGEXP REDIRECT_URL [last|break|redirect|permanent];
	}
}

REDIRECT_URL可使用以下变量：

$N
$request_uri

http.server.server_name

HTTP服务的主机名。请求的Host首部匹配该值。

 http {
	server {
		server_name HOST;
	}
}

http.server.ssl_certificate

HTTPS证书PEM文件路径。

 http {
	server {
		ssl_certificate CERT.PEM;
	}
}

如CERT.PEM不以/开头，则为安装目录下conf目录的相对路径。

http.server.ssl_certificate_key

HTTPS证书KEY文件路径。

 http {
	server {
		ssl_certificate_key CERT.KEY;
	}
}

如CERT.KEY不以/开头，则为安装目录下conf目录的相对路径。

http.server.ssl_ciphers

 http {
	server {
		ssl_ciphers HIGH:!aNULL:!MD5;
	}
}

http.server.ssl_prefer_server_ciphers

 http {
	server {
		ssl_prefer_server_ciphers on;
	}
}

http.server.ssl_session_cache

 http {
	server {
		ssl_session_cache shared:SSL:1m;
	}
}

http.server.ssl_session_timeout

 http {
	server {
		ssl_session_timeout 5m;
	}
}

http.server_names_hash_bucket_size

出现类似“nginx: [emerg] could not build server_names_hash, you should increase server_names_hash_bucket_size: 32”的错误时，加大该值。

 http {
	server_names_hash_bucket_size N;
}

user

运行工作进程的操作系统用户名。

 user USER;

示例

静态文件服务器

 http {
	# Other configurations...
	server {
		listen      80;
		server_name www.myweb.com;
		location / {
			root /static/dir/;
		}
	}
}

HTTP反向代理

 http {
	# Other configurations...
	server {
		listen      80;
		server_name www.myweb.com;
		location / {
			proxy_pass http://localhost:81;
		}
	}
}

HTTPS反向代理

 http {
	# Other configurations...
	server {
		listen       443 ssl;
		server_name  www.myweb.com;
 
		ssl_certificate      /certificate/dir/cert.pem;
		ssl_certificate_key  /certificate/dir/key.key;
 
		ssl_session_cache    shared:SSL:1m;
		ssl_session_timeout  5m;
 
		ssl_ciphers  HIGH:!aNULL:!MD5;
		ssl_prefer_server_ciphers  on;
 
		location / {
			proxy_pass http://localhost:81;
		}
	}
}

WebSocket反向代理

 http {
	# Other configurations...
	server {
		listen      80;
		server_name www.myweb.com;
		location /websocket {
			proxy_pass http://localhost:81/websocket;
			proxy_read_timeout 1h;
			proxy_set_header Connection Upgrade;
			proxy_set_header Upgrade $http_upgrade;
		}
	}
}

重定向

 http {
	server {
		listen      80;
		server_name www.myweb.com;
		rewrite .* https://www.herweb.com$request_uri;
	}
}

posted @ 2021-04-30 14:00 garvenc 阅读(575) 评论(0) 编辑收藏举报

刷新页面返回顶部

登录后才能查看或发表评论，立即登录或者逛逛博客园首页

相关博文：

· Linux学习笔记：systemd配置文件

· MongoDB学习笔记：配置文件

· Nginx配置文件

· Nginx-高级配置学习

· Nginx基础03：配置文件nginx.conf（Part2）

阅读排行：
· 《HelloGitHub》第 108 期
· Windows桌面应用自动更新解决方案SharpUpdater5发布
· 我的家庭实验室服务器集群硬件清单
· Supergateway：MCP服务器的远程调试与集成工具
· C# 13 中的新增功能实操

	http {
	server {
	location PATH_REGEXP {
	client_max_body_size SIZE;
	}
	}
	}

	http {
	server {
	rewrite REQUEST_PATH_REGEXP REDIRECT_URL [last\|break\|redirect\|permanent];
	}
	}

	http {
	# Other configurations...
	server {
	listen 80;
	server_name www.myweb.com;
	location / {
	root /static/dir/;
	}
	}
	}

garvenc