重温 Nginx 的匹配规则

location 的末尾是否带 “/”（斜杠）

带了斜杠 ：如：/aa/ 。严格路径匹配 /aa/* 之后的一些路径。

不带斜杠 ：如：/aa。匹配：/aa* （/aabb、/aa/bb、/aaccdd/dd）只要是前缀是以"location“开头的，而不是严格路径匹配

proxy_pass 的末尾是否带 “/”（斜杠）

带了斜杠 ：转发后的路径 = proxy_pass 的路径 + ( 客户端请求的完整路径 - location 匹配到的路径 )

不带斜杠 ：转发后的路径 = proxy_pass 的路径 + ( 客户端请求的完整路径 )

结论

替换路径，"location" 和 "proxy_pass" 两端必须带上斜杠 “/”（斜杠）

yaml
# 🌟 最标准的替换写法（规范对齐）
location /api/ {
    proxy_pass http://127.0.0.1:8080/v1/; 
}

nginx 如何配置主应用与子应用

主应用配置

sh
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;

events {
    worker_connections 1024;
}

http {
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile            on;
    tcp_nopush          on;
    tcp_nodelay         on;
    keepalive_timeout   65;
    types_hash_max_size 4096;

    include             /etc/nginx/mime.types;
    default_type        application/octet-stream;

    ## 这里加载的conf 将会是单独的 server 。
    include /etc/nginx/conf.d/*.conf;

    server {
        listen       80;
        listen       [::]:80;
        server_name  _;
        root         /usr/share/nginx/html;
        include /etc/nginx/default.d/*.conf;

        error_page 404 /404.html;
        location = /404.html {
        }

        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
        }
    }

    server {
        listen       8080;
        listen       [::]:8080;
        server_name  fs_h5_server;

        ## 开启 gzip压缩
        gzip on;  
        gzip_min_length 1k; ## 大于或等于这个值，则就会压缩 
        gzip_comp_level 5; ## 压缩等级 5 是最平衡的
        gzip_types text/plain text/css application/json application/javascript text/javascript image/svg+xml; ## gzip压缩的类型
        gzip_vary on;

        ## 会直接将这个目录下的所有文件内容加载到 8080这个端口配置下，在这里可以做子应用的配置。
        include /etc/nginx/fs.conf.d/*.conf;

        error_page 404 /404.html;
        location = /404.html {
        }

        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
        }


        // 所有子应用公用代理端口
        location /api/v1 {
           proxy_pass http://192.168.18.151:8082;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }

        location /public/api/ {
            rewrite ^/fs-api/(.*)$ /$1 break;
            proxy_pass https://open.feishu.cn;  

            proxy_set_header Host open.feishu.cn; ## 转发https时，Nginx 去找后端时需要进行 SSL 握手。需要手动指定固定域名。
            proxy_ssl_server_name on;
            proxy_ssl_protocols TLSv1.2 TLSv1.3;

            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
}

子应用配置

子应用配置1

bash
## 严格匹配
location /child1/ {   
    alias /usr/local/nginx/html/child1/; ## 末尾斜杠，会去掉 location 的前缀匹配, 刚好对应上
    index index.html;
    try_files $uri $uri/ /child1/index.html;

    ## 配置强缓存
    expires 30d;
    add_header Cache-Control "public, no-transform";

    ## 不缓存 html。虽然真实的地址不会这样去访问，但是上面的 try_files 在访问 /xxx的时候会默认去找。也会匹配到这 
    if ($request_filename ~* \.(html|htm)$) {
        expires -1;
        add_header Cache-Control "no-cache, no-store, must-revalidate";
    }
}

子应用配置2

sh
location /child2/ {
    alias /usr/local/nginx/html/child2/;
    index index.html;
    try_files $uri $uri/ /child2/index.html;

    ## 配置强缓存
    expires 30d;
    add_header Cache-Control "public, no-transform";

    ## 如果是html，则不缓存
    ## 原因：如果是SPA应用，index.html 默认是没有文件名hash的，因此配了缓存，可能会引发问题。css 和 js 是存在文件名hash的。可以放心的使用强缓存
    if ($request_filename ~* \.(html|htm)$) {
        expires -1; ## -1 表示已经过期
        add_header Cache-Control "no-cache, no-store, must-revalidate";
    }
}

location /api/v1/xxx {
    proxy_pass https://aaa.cn;

    ## 在代理 https 的请求时，后端服务器默认会开启证书的校验。
    ## 如果不设置 proxy_ssl_name 那么会默认把请求源（客户端地址）发送给后端，这可能会导致在协议握手时，域名不一致引发证书不匹配报错导致握手失败。
    ## 因此 可以开启 proxy_ssl_server_name 并设置 proxy_ssl_name 解决这个问题。
    proxy_ssl_server_name on;   // 开启 ssl server 
    proxy_ssl_name aaa.cn; ## 与上面的 proxy_pass 对应上

    ## 配置 host 头，如果上面指定了 proxy_ssl_name，这里也要指定。这里不会引起握手失败（取决于后端逻辑如何处理）
    ## 默认是  proxy_pass 的域名。
    proxy_set_header Host aaa.cn 
    
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}