百度360必应搜狗淘宝本站头条
linux 远程nginx配置 解析linux 文件命令linux 是什么查看文件 linux
当前位置：网站首页 > 技术文章 > 正文

30s 就可以掌握的 Nginx 片段（nginx视频教程）

ahcoder 2025-07-03 11:48 2 浏览

作为一枚程序员，日常研发少不了上线部署工作。一旦走上“基建”的道路，你就会发现 Nginx 是你绕不开的一个坎。毫不夸张的说：Nginx 能顶半边天！

也许你会反驳，我们有专业的运维（ OP ）团队，不用操心。然而实际情况却是 OP 每天被繁重的工单占据着，你无时无刻不在排队。大公司如此，小公司更甚。因此，储备一些 Nginx 知识，一定会让你事半功倍。

本文总结了日常开发中高频出现的 15 个 Nginx 配置片段，因为短小，所以你只需 30 秒就可以掌握。

一、跨域配置

由于浏览器的安全策略，前端处理跨域请求的概率极高，如下是开启跨域请求常规手段。

1
2
3
4
5
6
7

if ($request_method = OPTIONS ) {
    add_header "Access-Control-Allow-Origin"  *;
    add_header "Access-Control-Allow-Methods" "GET, POST, OPTIONS, HEAD";
    add_header "Access-Control-Allow-Headers" "Authorization, Origin, X-Requested-With, Content-Type, Accept";
    add_header 'Access-Control-Max-Age' 600;
    return 200;
}

二、开启 GZip 压缩

如果你希望压缩常规的文件类型，可以参考如下代码：

1
2
3
4
5
6
7
8
9

http 
{
  include       conf/mime.types;
  gzip on;
  gzip_min_length  1000;
  gzip_buffers     4 8k;   
  gzip_http_version 1.1; 
  gzip_types       text/plain application/x-javascript text/css application/xml application/javascript application/json;
}

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协议发送），否则无效。
  • Set-Cookie: widget_session=abc123; SameSite=None; Secure
  • Lax规则稍稍放宽，大多数情况也是不发送第三方Cookie，但是导航到目标网址的Get请求除外。

还有一种方式是使用proxy_pass反向代理。如果只是Host、端口转换，则Cookie不会丢失。再次访问时，浏览器会发送当前的Cookie。当然，路径变化了，则需要设置Cookie的路径转换。

1
2
3
4

location /foo {
    proxy_pass http://localhost:4000;
    proxy_cookie_path /foo "/; SameSite=None; HTTPOnly; Secure";
}

四、健康检查

Nginx 服务端会按照设定的间隔时间主动向后端的 upstream_server 发出检查请求来验证后端的各个 upstream_server 的状态。
如果得到某个服务器失败的返回超过一定次数，比如 3 次就会标记该服务器为异常，就不会将请求转发至该服务器。一般情况下后端服务器需要为这种健康检查专门提供一个低消耗的接口。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

http {
  # 指定一个 upstream 负载均衡组，名称为 evalue
  upstream evalue {
    # 定义组内的节点服务，如果不加 weight 参数，默认就是 Round Robin ，加上了 weight 参数就是加权轮询
    server 192.168.90.100:9999 weight=100;
    server 192.168.90.101:9999 weight=100;
    
    # interval=3000 检查间隔 3 秒 ， rise=3 连续成功3次认为服务健康 ， fall=5 连续失败 5 次认为服务不健康 ， timeout=3000 健康检查的超时时间为 3 秒 ， type=http  检查类型 http
    check interval=3000 rise=3 fall=5 timeout=3000 type=http;
    
    # check_http_send 设定检查的行为：请求类型 url 请求协议 -> HEAD /api/v1/health HTTP/1.0         
    check_http_send "HEAD /api/v1/health HTTP/1.0\r\n\r\n";
    
    # 设定认为返回正常的响应状态       
    check_http_expect_alive http_2xx http_3xx;
  }
}

五、泛域名解析

要在 Nginx 中配置域名泛解析，可以使用通配符 * 来实现次级域名指向同一 IP 地址。如下是一个简单的 Nginx 配置示例：

1
2
3
4
5

server {
    listen 80;
    server_name *.jartto.com;
    root /var/www/jartto.com;
}

上面的配置将所有以 .jartto.com 结尾的域名都指向 /var/www/jartto.com 目录下的网站。如果要配置二级域名，可以使用以下的 Nginx 配置：

1
2
3
4
5

server {
    listen 80;
    server_name *.sub.jartto.com;
    root /var/www/sub.jartto.com;
}

上面的配置将所有以 .sub.jartto.com 结尾的二级域名都指向 /var/www/sub.jartto.com 目录下的网站。需要注意的是，在使用泛解析时，可能会导致一些安全问题。因此，建议仅在必要时使用泛解析，并且要对网站进行充分保护。

六、使用 $request_id 实现链路追踪

Nginx在1.11.0版本中就提供了内置变量$request_id，其原理就是生成 32 位的随机字符串，虽不能比拟 UUID 的概率，但 32 位的随机字符串的重复概率也是微不足道了，所以一般可视为 UUID 来使用。

1
2
3
4
5
6
7
8
9
10

location ^~ /habo/gid {
        add_header Cache-Control no-store;
        default_type application/javascript;
        set $unionId $cookie_GID;
        if ($unionId = "") {
                set $unionId $request_id;
                add_header Set-Cookie "GID=${unionId};path=/habo/;max-age=${GID_MAX_AGE}";
        }
        return 200 "document.cookie='GID=${unionId};path=/;max-age=${GID_MAX_AGE}'";
    }

七、限流配置

Nginx提供了两种限流方式：控制速率和控制并发连接数。

其中，控制速率是指限制单位时间内的请求次数，而控制并发连接数是指限制同时处理的请求数量。

下面是一个简单的Nginx限流配置示例，使用leaky bucket算法进行限流：

1
2
3
4
5
6
7
8
9
10

http {
    limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

    server {
        location / {
            limit_req zone=one burst=5;
            proxy_pass http://backend;
        }
    }
}

在上述配置中，limit_req_zone用于定义一个名为one的共享内存区域，并将其与客户端IP地址相关联。这个共享内存区域最大占用10MB空间，并且允许每秒钟通过 1 个请求。然后，在location块中使用了limit_req指令来启用限流功能。这里设置burst为 5，表示当客户端在短时间内发送超过 1 个请求时，可以暂时容忍一定数量的请求超出限制。
需要注意的是，在实际应用中需要根据具体情况调整参数值以达到最佳效果。如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

map $http_baggage_flow  $plimit {
 "ptest" $server_name;
 default "";
}


limit_req_zone $plimit zone=prelimit:10m rate=600r/s;
 server {
  listen       443 ssl;
  server_name   www.jartto.com;
  limit_req zone=prelimit  nodelay;
  limit_req_status 530;

  location = /530.html {
      default_type application/json;
      return 200 '{"status" : 530}';
  }
  ...
}

八、History 二级路由刷新问题

vue-router+webpack项目线上部署时单页项目路由，刷新页面出现 404 问题，一般需要配置如下：

1
2
3
4
5
6
7
8
9

location / {
　　root html;
　　try_files $uri $uri/ @router;
　　index index.html index.htm;

}
location @router {
　　rewrite ^.*$ /index.html last;
}

九、Cookie 路由识别

最常见的场景就是灰度发布，Nginx 来识别来自前端的流量，从而进行转发。

map $http_cookie $m_upstream {
    ~*baggage-version=isolute-feat-.*$ al-bj-sre-k8s-test-istio-gateway;
    default test.jartto.com;
}

upstream al-bj-sre-k8s-test-istio-gateway {
    server 47.95.128.11:80;
}

十、服务端开启图片转换

这里主要是设置 WebP 格式图片，如果你还不了解，请查看：WebP 方案分析与实践。

map $http_accept $webp_suffix {
    default   "";
    "~*webp"  ".webp";
}

location  ~* ^/_nuxt/img/(.+\.png|jpe?g)$ {
    rewrite ^/_nuxt/img/(.+\.png|jpe?g)$ /$1 break;
    root /apps/srv/instance/test-webp.jartto.com/.nuxt/dist/client/img/;
    add_header Vary Accept;
    try_files $uri$webp_suffix $uri =404;
    expires 30d;
}

十一、负载均衡

负载均衡通常有四种算法：

  • 轮询，默认方式，每个请求按时间顺序逐一分配到不同的后端服务器，如果后端服务挂了，能自动剔除；
  • weight，权重分配，指定轮询几率，权重越高，在被访问的概率越大，用于后端服务器性能不均的情况；
  • ip_hash，每个请求按访问 IP 的 hash 结果分配，这样每个访客固定访问一个后端服务器，可以解决动态网页 session 共享问题。负载均衡每次请求都会重新定位到服务器集群中的某一个，那么已经登录某一个服务器的用户再重新定位到另一个服务器，其登录信息将会丢失，这样显然是不妥的；
  • fair（第三方），按后端服务器的响应时间分配，响应时间短的优先分配，依赖第三方插件 nginx-upstream-fair，使用前请先安装；http {
    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，可以按照以下步骤操作：

  1. 为 Nginx 安装 SSL 模块。 这可以通过使用 --with-http_ssl_module 选项编译 Nginx 或安装包含 SSL 模块的预构建包来完成。
  2. 从受信任的证书颁发机构CA为您的域获取SSL证书。 这可以通过购买证书或从Let's Encrypt获得免费证书来完成。
  3. 配置Nginx以使用SSL证书和密钥文件。这涉及将以下行添加到您的Nginx配置文件中：
  4. 1
    2
    ssl_certificate /path/to/jartto.crt;
    ssl_certificate_key /path/to/jartto.key;
  5. 如果需要，配置Nginx将HTTP请求重定向到HTTPS。 这可以使用服务器块来完成，该服务器块监听端口80并将所有请求重定向到端口443（默认 HTTPS 端口）。
  6. 重新启动Nginx以应用更改。

下面是启用HTTPS并将HTTP请求重定向到HTTPS的Nginx配置文件示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

server {
    listen 80;
    server_name jartto.com www.jartto.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name jartto.com www.jartto.com;

    ssl_certificate /path/to/jartto.crt;
    ssl_certificate_key /path/to/jartto.key;
    # Other SSL-related settings go here
    # Other server block settings go here
}

如上配置文件同时监听端口80和443，但仅在端口443上通过HTTPS提供内容。所有HTTP请求都使用第一个服务器块中的返回语句重定向到它们等效的HTTPS URL。

十三、图片防盗链

如果你不想图片被外网随便引用，那么可以配置图片防盗链能力，配置如下：

1
2
3
4
5
6
7
8
9
10
11
12

server {
  listen       80;        
  server_name  *.jartto.com;
  
  # 图片防盗链
  location ~* \.(gif|jpg|jpeg|png|bmp|swf)$ {
    valid_referers none blocked server_names ~\.google\. ~\.baidu\. *.qq.com;  # 只允许本机 IP 外链引用
    if ($invalid_referer){
      return 403;
    }
  }
}

十四、配置多 Server

要在Nginx中配置多个服务器，可以在Nginx配置文件中定义多个服务器块。每个服务器块代表一个单独的虚拟服务器，可以监听不同的端口或IP地址，并提供不同的内容。下面是如何在Nginx中配置两个虚拟服务器的示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

http {
  server {
    listen 80;
    server_name www.jartto.com;
    root /var/www/jartto.com;

    # other server configuration directives
  }

  server {
    listen 80;
    server_name www.another-jartto.com;
    root /var/www/another-jartto.com;

    # other server configuration directives
  }
}

上述示例中，我们定义了两个监听端口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配置信息，那么不妨试试如下代码：

upstream backends {
    zone zone_for_backends 1m;
    server 127.0.0.1:6001;
    server 127.0.0.1:6002;
    server 127.0.0.1:6003;
}


server {
    listen 6000;

    location /dynamic {
      allow 127.0.0.1;
      deny all;
      dynamic_upstream;
    }


    location / {
      proxy_pass http://backends;
    }
}

使用方式如下：

$ curl "http://127.0.0.1:6000/dynamic?upstream=zone_for_backends&verbose="
server 127.0.0.1:6001 weight=1 max_fails=1 fail_timeout=10;
server 127.0.0.1:6002 weight=1 max_fails=1 fail_timeout=10;
server 127.0.0.1:6003

原文链接：
http://jartto.wang/2023/03/12/30-seconds-of-nginx/?hmsr=toutiao.io&utm_campaign=toutiao.io&utm_medium=toutiao.io&utm_source=toutiao.io

相关推荐

ClickHouse日志平台这样建，分分钟秒掉ELK

目前业界的日志生态，最常用的是ELK，其次就是ClickHouse，本文会演示如何使用Vector+ClickHouse来采集Nginx日志并做清洗，最终写入ClickHouse。至...

nginx打印请求头日志方法-openresty

一、前言之前想用nginx打印收到的请求的请求头，但是只找到打印请求体的，没有打印请求头的，感觉原版nginx不支持。建议如果想打印请求头，先换成openresty(本人安装的是openresty-1...

文心快码帮你解大厂面试题:如何使用shell找到access log?

【大厂面试真题】系列，带你攻克大厂面试真题，秒变offer收割机！今日问题：在8g内存的机器，能否启动一个7G堆大小的java进程？一起看看文心快码BaiduComate给出的答案吧！如果这个问题你...

Nginx奇技淫巧之:按日期自动生成日志文件

时光闹钟app开发者，请关注我，后续分享更精彩！坚持原创，共同进步！前言之前文章：Nginx奇技淫巧之：用户行为埋点数据采集实现，介绍了Nginx获取post请求body参数生成日志文件的方法。当业务...

Nginx 日志文件详解:监控与诊断利器

随着互联网技术的快速发展，Nginx已成为最受欢迎的Web服务器之一，其稳定性、高性能和灵活性备受推崇。Nginx日志文件是Nginx服务器中非常重要的组成部分，对于监控和诊断Web应...

Nginx从入门到放弃05-访问日志与日志切割

设置访问日志当我们访问nginx服务时，nginx会记录日志，nginx日志分两种，一种是访问日志，一种是错误日志，访问日志记录在”access.log”文件中，错误日志记录在”error.log”文...

nginx系列:常用利用shell统计日志

0x01：根据访问IP统计UVUV（UniqueVisitor）独立访客，统计访问某站点的用户数；IP（InternetProtocol）独立IP数，是指独立的浏览了页面的不同IP，即统计不同的I...

Linux 必须重点监控的 17 个日志文件:运维与安全必备指南

在Linux系统的日常运维与安全管理中，日志文件的重要性不言而喻。日志不仅记录着系统运行的点点滴滴，更是排查故障、发现异常、提前预警的第一手证据。作为一名系统管理员、安全工程师，甚至普通开发者，了...

nginx 常用日志参数（nginx日志详解）

Nginx提供了多种日志参数（变量），可以用来记录请求的不同方面。常用日志参数$remote_addr:客户端的IP地址。$remote_user:客户端用户名。$time_local:局部时...

GoAccess轻量nginx日志分析工具（nginx日志收集方案）

什么是GoAccessGoAccess是一款开源、实时，运行在命令行终端下的Web日志分析工具。该工具提供快速、多样的HTTP状态统计。分析结果，可以通过XShell等客户端工具查看，并...

后端实践:Nginx日志配置(超详细)（nginx日志配置文件）

作者：antwang来源：https://juejin.im/post/5aa09bb3f265da238f121b6c前言Nginx日志对于统计、系统服务排错很有用。Nginx日志主要分为两种：...

Nginx access_log 运行日志查询和配置

1.介绍当我们学会Nginx的基本配置之后，可以通过Nginx配置Service代理。管理服务器所有的http和https请求。那么接下来就需要了解Nginx的日志控制，以及相关的文档查看了。你通过...

Nginx记录用户请求Header到access log

为了统计和其它用途，经常有人需要自定义Nginx日志，把http请求中的某个字段记录到日志中，刚好在看lua+nginx的文章，第一想到的是用lua赋值来做，但是想想有点小恶心，于是Google了一番...

介绍五款Web服务器日志分析软件（web服务器日志是什么）

　　每个站长必须要看的数据统计表，都是由日志分析软件统计和分析网站情况所得出的。日志分析软件是一种解析Nginx/Apache/IIS/Lighttpd和任何其他Web服务器日志文件的软件...

Nginx系列:Nginx自带后端健康检查

严格说Nginx并没有自带针对负载均衡后端节点的健康检查功能，但是可以通过默认自带的ngx_http_proxy_module模块和ngx_http_upstream_module模块中的相关指令...

一周热门
最近发表
标签列表