【随手记】Nginx配置详解

客怎眠qvq

发布于 2024-04-26 10:30:06

1360

发布于 2024-04-26 10:30:06

文章被收录于专栏：某菜鸟の小屋某菜鸟の小屋

前言

老大安排的，被迫营业，去给同事讲Nginx。

基本介绍（可跳过）

Nginx 是一个高性能的 HTTP 服务器和反向代理，它以其稳定性、丰富的功能集、简单的配置和低资源消耗而闻名。Nginx主要用来处理HTTP请求，提供负载均衡、静态内容服务、反向代理等功能。

正向代理：居家办公用过公司的内网VPN吧，你所有的请求在发送前，被代理成了内网的IP去获取内网的数据库、调用内网的接口。

反向代理：业务中经常用到，所有前端的请求被发送到同一个端口(80)，通过Nginx监听转发到相应的前端、后端上。比如前端Vue项目启动在8080上，但它不会被直接访问，只会从80端口被转发到8080，用户浏览器显示的站点还是原站点，只是内容变成了8080的页面。

热备（backup）：当一台服务器发生事故时，才启用第二台服务器提供服务。轮询：多个服务器按顺序处理请求。加权轮询（weight）：根据配置的权重大小而分发给不同服务器不同数量的请求，可根据服务器配置调整对应权重，利于降低负载。 ip_hash：让相同ip的客户端请求相同的服务器。有利于保持会话的一致性。

参数配置

Nginx 的主配置文件通常位于以下位置：

linux系统：/etc/nginx/nginx.conf
Windows系统：随Nginx安装路径而变化，在安装目录下的 conf\nginx.conf 中，如果你安装在 D:/program/nginx-1.22，那么配置文件就在 D:/program/nginx-1.22/conf/nginx.conf

其配置结构如下：

-——全局块
|
|——event块
|
-——http块
  |
  -————server块
      |
      -————location块

Nginx默认配置及说明如下：

#
#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;


events {
    worker_connections  1024;
}


http {
    include       mime.types;
    default_type  application/octet-stream;

    #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  logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    #gzip  on;

    server {
        listen       80;
        server_name  localhost;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location / {
            root   html;
            index  index.html index.htm;
        }

        #error_page  404              /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }

        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #
        #location ~ \.php$ {
        #    proxy_pass   http://127.0.0.1;
        #}

        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        #
        #location ~ \.php$ {
        #    root           html;
        #    fastcgi_pass   127.0.0.1:9000;
        #    fastcgi_index  index.php;
        #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
        #    include        fastcgi_params;
        #}

        # deny access to .htaccess files, if Apache's document root
        # concurs with nginx's one
        #
        #location ~ /\.ht {
        #    deny  all;
        #}
    }


    # another virtual host using mix of IP-, name-, and port-based configuration
    #
    #server {
    #    listen       8000;
    #    listen       somename:8080;
    #    server_name  somename  alias  another.alias;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}


    # HTTPS server
    #
    #server {
    #    listen       443 ssl;
    #    server_name  localhost;

    #    ssl_certificate      cert.pem;
    #    ssl_certificate_key  cert.key;

    #    ssl_session_cache    shared:SSL:1m;
    #    ssl_session_timeout  5m;

    #    ssl_ciphers  HIGH:!aNULL:!MD5;
    #    ssl_prefer_server_ciphers  on;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}
}

案例教学

location 匹配优先级（不讲后缀匹配）

1、精准匹配（优先级最高）

#将所有对根域名的请求都重定向到统一认证的地址
location = / {
  rewrite ^/(.*)$ https://iam.test.com;
}

2、正则前缀匹配（匹配到后，停止搜索）

#所有匹配到 /images/ 请求都会转发到静态资源服务器的images路径下
location ^~ /images/ {
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header Host $proxy_host;
  proxy_pass http://static_server/images;
}

3、不区分大小写、区分大小写的前缀匹配（~* 优先级高于 ~，但仍会向下搜索）

location ~* /upload {
  // 不区分大小写
}

location ~ /Upload {
  // 区分大小写 且优先级低于 ~*
}

location ~* /upload/images {
  // 优先级相同，取规则最准确的（最长的）
}

4、前缀匹配（最常用）

location /api/weekly {
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header Host $proxy_host;
  proxy_pass http://backend_server/weekly;
}

5、通用匹配（任何未匹配到的请求都会走这条配置，由于与1的精准匹配重叠，所以不会生效）

location / {
  # proxy_http_version 1.1;
  proxy_set_header X-Real-IP $remote_addr;
  client_max_body_size 20M;
  client_body_buffer_size 20M;
  proxy_set_header Host test.com;
  proxy_pass http://dev_ui;
}

优先级及匹配字符长度相同的情况下，按location块先后顺序决定优先级

root路径映射

统一查找文件时的根目录，路径映射的规则可以直接参照linux命令行，很简单的。

映射规则：可以相对路径、可以是绝对路径.
位置：可以在http、server、location中定义，可单独使用
作用：定义全局的根目录，可被子模块中的root配置覆盖。
在同一个 location 块中，不能同时使用 root 和 alias。
alias语法和root相似，不能直接使用正则，只能作用于某一location块，且不会影响其他块。

建议在server块中定义全局的根目录，在location块中根据需要配置alias。如果需要正则匹配实现alias的效果，就用到了rewrite。

# 通用匹配只能有一条，多条nginx -t 检查会报错
# 换句话说，配置中只能有一个 location / {} 块
# 下列配置仅针对 精准匹配未影响通用匹配的情况下，且只能有一份
location / {
  # 访问test.com显示/usr/local/html/absolute下的index.htm(l)页面
  root /usr/local/html/absolute;
  index index.html index.htm;
}

location / {
  # 访问test.com显示D:/usr/local/html/test下的index.htm(l)页面
  root   D:/usr/local/html/test;
  index  index.html index.htm;
}

location / {
  # 访问test.com显示 nginx 安装目录下的 html/relative/index.htm(l) 页面
  root   html/relative;
  index  index.html index.htm;
}

root 与 alias 的区别

① 路径 root的处理结果：root路径＋location路径 alias的处理结果：使用alias路径替换location路径 alias是一个目录别名的定义，root则是最上层目录的定义 ② 作用域 alias只能作用在location中，而root可以存在server、http和location中 ③ 语法格式 alias后面必须要用 “/” 结束，不然会被认为是个文件，而找不到对应的目录；而root则对 “/” 可有可无。alias不支持直接使用正则，但可以获取location匹配的参数，且必须使用。

rewrite重写

 rewrite    <regex>    <replacement>    [flag];
关键字      正则        替代内容          flag标记(可为空）

location /testrewrite {
  # 使用rewrite指令重写请求URI
  rewrite ^/(.*)$ https://baidu.com permanent;
  
  # 重写后的请求将被转发到baidu.com
}

location /testrewrite2/ {
    # 使用rewrite指令重写请求URI
    # 捕获 /testrewrite2/ 后面的所有内容作为 $1
    rewrite ^/testrewrite2/(.*)$ https://cn.bing.com/search?q=$1 permanent;
    # 转发到重写后的 URI
    #proxy_pass https://cn.bing.com;
}