原文链接: http://jartto.wang/2023/03/12/30-seconds-of-nginx/
作为一枚程序员,日常研发少不了上线部署工作。一旦走上“基建”的道路,你就会发现 Nginx
是你绕不开的一个坎。毫不夸张的说:Nginx
能顶半边天!
也许你会反驳,我们有专业的运维( OP
)团队,不用操心。然而实际情况却是 OP
每天被繁重的工单占据着,你无时无刻不在排队。大公司如此,小公司更甚。因此,储备一些 Nginx
知识,一定会让你事半功倍。
本文总结了日常开发中高频出现的 15 个 Nginx 配置片段,因为短小,所以你只需 30 秒就可以掌握。
一、跨域配置
由于浏览器的安全策略,前端处理跨域请求的概率极高,如下是开启跨域请求常规手段。
1 |
if ($request_method = OPTIONS ) { |
二、开启 GZip 压缩
如果你希望压缩常规的文件类型,可以参考如下代码:
1 |
http |
GZip 涉及参数较多,还有 gzip_comp_level
、gzip_proxied
等,详情可以参考:Nginx配置 – Gzip压缩
三、跨域传递 Cookie
Chrome 80
以后的版本,Cookie
默认不可跨域,除非服务器在响应头里再设置 same-site
属性(strict
,lax
,none
)。
Strict
最为严格,完全禁止第三方Cookie
,跨站点时,任何情况下都不会发送Cookie
。换言之,只有当前网页的URL
与请求目标一致,才会带上Cookie
。这个规则过于严格,可能造成非常不好的用户体验。比如,当前网页有一个GitHub
链接,用户点击跳转就不会带有GitHub
的Cookie
,跳转过去总是未登陆状态。-
None
,Cookie
只能通过HTTPS
协议发送。必须同时设置Secure
属性(Cookie
只能通过HTTPS
协议发送),否则无效。1
Set-Cookie: widget_session=abc123; SameSite=None; Secure
-
Lax
规则稍稍放宽,大多数情况也是不发送第三方Cookie
,但是导航到目标网址的Get
请求除外。
还有一种方式是使用proxy_pass
反向代理。如果只是Host
、端口转换,则Cookie
不会丢失。再次访问时,浏览器会发送当前的Cookie
。当然,路径变化了,则需要设置Cookie
的路径转换。
1 |
location /foo { |
四、健康检查
Nginx
服务端会按照设定的间隔时间主动向后端的 upstream_server
发出检查请求来验证后端的各个 upstream_server
的状态。
如果得到某个服务器失败的返回超过一定次数,比如 3 次就会标记该服务器为异常,就不会将请求转发至该服务器。一般情况下后端服务器需要为这种健康检查专门提供一个低消耗的接口。
1 |
http { |
五、泛域名解析
要在 Nginx
中配置域名泛解析,可以使用通配符 *
来实现次级域名指向同一 IP
地址。如下是一个简单的 Nginx
配置示例:
1 |
server { |
上面的配置将所有以 .jartto.com
结尾的域名都指向 /var/www/jartto.com
目录下的网站。如果要配置二级域名,可以使用以下的 Nginx
配置:
1 |
server { |
上面的配置将所有以 .sub.example.com
结尾的二级域名都指向 /var/www/sub.example.com
目录下的网站。需要注意的是,在使用泛解析时,可能会导致一些安全问题。因此,建议仅在必要时使用泛解析,并且要对网站进行充分保护。
六、使用 $request_id 实现链路追踪
Nginx
在1.11.0
版本中就提供了内置变量$request_id
,其原理就是生成 32 位的随机字符串,虽不能比拟 UUID
的概率,但 32 位的随机字符串的重复概率也是微不足道了,所以一般可视为 UUID
来使用。
1 |
location ^~ /habo/gid { |
七、限流配置
Nginx
提供了两种限流方式:控制速率和控制并发连接数。
其中,控制速率是指限制单位时间内的请求次数,而控制并发连接数是指限制同时处理的请求数量。
下面是一个简单的Nginx
限流配置示例,使用leaky bucket
算法进行限流:
1 |
http { |
在上述配置中,limit_req_zone
用于定义一个名为one
的共享内存区域,并将其与客户端IP
地址相关联。这个共享内存区域最大占用10MB
空间,并且允许每秒钟通过 1 个请求。然后,在location
块中使用了limit_req
指令来启用限流功能。这里设置burst
为 5,表示当客户端在短时间内发送超过 1 个请求时,可以暂时容忍一定数量的请求超出限制。
需要注意的是,在实际应用中需要根据具体情况调整参数值以达到最佳效果。如下:
1 |
map $http_baggage_flow $plimit { |
八、History 二级路由刷新问题
vue-router+webpack
项目线上部署时单页项目路由,刷新页面出现 404
问题,一般需要配置如下:
1 |
location / { |
九、Cookie 路由识别
最常见的场景就是灰度发布,Nginx
来识别来自前端的流量,从而进行转发。
1 |
map $http_cookie $m_upstream { |
十、服务端开启图片转换
这里主要是设置 WebP
格式图片,如果你还不了解,请查看:WebP
方案分析与实践。
1 |
map $http_accept $webp_suffix { |
1 |
location ~* ^/_nuxt/img/(.+\.png|jpe?g)$ { |
十一、负载均衡
负载均衡通常有四种算法:
- 轮询,默认方式,每个请求按时间顺序逐一分配到不同的后端服务器,如果后端服务挂了,能自动剔除;
weight
,权重分配,指定轮询几率,权重越高,在被访问的概率越大,用于后端服务器性能不均的情况;ip_hash
,每个请求按访问IP
的hash
结果分配,这样每个访客固定访问一个后端服务器,可以解决动态网页session
共享问题。负载均衡每次请求都会重新定位到服务器集群中的某一个,那么已经登录某一个服务器的用户再重新定位到另一个服务器,其登录信息将会丢失,这样显然是不妥的;fair
(第三方),按后端服务器的响应时间分配,响应时间短的优先分配,依赖第三方插件nginx-upstream-fair
,使用前请先安装;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16http {
upstream jartto-server {
# ip_hash; # ip_hash 方式
# fair; # fair 方式
server 127.0.0.1:8081; # 负载均衡目的服务地址
server 127.0.0.1:8080;
server 127.0.0.1:8082 weight=10; # weight 方式,不写默认为 1
}
server {
location / {
proxy_pass http://jartto-server;
proxy_connect_timeout 10;
}
}
}
十二、配置 HTTPS
要在 Nginx
上配置 HTTPS
,可以按照以下步骤操作:
- 为
Nginx
安装SSL
模块。 这可以通过使用--with-http_ssl_module
选项编译Nginx
或安装包含SSL
模块的预构建包来完成。 - 从受信任的证书颁发机构
CA
为您的域获取SSL
证书。 这可以通过购买证书或从Let's Encrypt
获得免费证书来完成。 -
配置
Nginx
以使用SSL
证书和密钥文件。这涉及将以下行添加到您的Nginx
配置文件中:1
2ssl_certificate /path/to/jartto.crt;
ssl_certificate_key /path/to/jartto.key; -
如果需要,配置
Nginx
将HTTP
请求重定向到HTTPS
。 这可以使用服务器块来完成,该服务器块监听端口80
并将所有请求重定向到端口443
(默认HTTPS
端口)。 - 重新启动
Nginx
以应用更改。
下面是启用HTTPS
并将HTTP
请求重定向到HTTPS
的Nginx
配置文件示例:
1 |
server { |
如上配置文件同时监听端口80
和443
,但仅在端口443
上通过HTTPS
提供内容。所有HTTP
请求都使用第一个服务器块中的返回语句重定向到它们等效的HTTPS URL
。
十三、图片防盗链
如果你不想图片被外网随便引用,那么可以配置图片防盗链能力,配置如下:
1 |
server { |
十四、配置多 Server
要在Nginx
中配置多个服务器,可以在Nginx
配置文件中定义多个服务器块。每个服务器块代表一个单独的虚拟服务器,可以监听不同的端口或IP
地址,并提供不同的内容。下面是如何在Nginx
中配置两个虚拟服务器的示例:
1 |
http { |
上述示例中,我们定义了两个监听端口80
的虚拟服务器。第一个虚拟服务器配置为从目录/var/www/jartto.com
为域www.jartto.com
提供内容。第二个虚拟服务器配置为从目录/var/www/another-jartto.com
为域www.another-jartto.com
提供内容。每个服务器块都可以有自己的一组配置指令,例如SSL
证书、访问日志、错误页面等等。
通过在Nginx
配置文件中定义多个服务器块,我们就可以在单个Nginx
实例上托管多个网站或应用程序。
十五、动态修改配置模块
ngx_dynamic_upstream
是用于使用 HTTP API
动态操作上游的模块,例如 ngx_http_upstream_conf
。如果你想动态修改Nginx
配置信息,那么不妨试试如下代码:
1 |
upstream backends { |
使用方式如下:
1 |
$ curl "http://127.0.0.1:6000/dynamic?upstream=zone_for_backends&verbose=" |
本文转自: http://jartto.wang/2023/03/12/30-seconds-of-nginx/
本站仅做收录,版权归原作者所有。