NGINX 路由配置与参数详解（https配置、跨域配置、socket配置）

一、概述
二、https 配置
三、nginx 跨域配置
四、nginx socket 配置
五、NGINX 路由配置
六、localhost 加载顺序与默认路由

一、概述

Nginx 是一个高性能的开源Web服务器，也可以用作反向代理服务器、负载均衡器和HTTP缓存。它的设计目标是提供高并发、低内存消耗和高度可伸缩性，使其成为处理大量并发连接的理想选择。

NGINX 基础部分可以参考我这篇文章：NGINX - 高级负载均衡器、Web服务器、反向代理

在这里插入图片描述

二、https 配置

配置 Nginx 支持 HTTPS 通常涉及到以下几个步骤：

1）获取 SSL 证书

你需要从可信任的证书颁发机构（CA）获取 SSL 证书。这可以是免费的证书，比如 Let's Encrypt 提供的证书，也可以是购买的商业证书。

2）安装 SSL 证书

将获取的 SSL 证书文件（通常包括证书文件和私钥文件）上传到服务器。确保证书私钥文件的权限设置为安全。

3）Nginx 配置修改

修改 Nginx 配置文件，通常是 /etc/nginx/nginx.conf 或 /etc/nginx/conf.d/default.conf。以下是一个简单的 HTTPS 配置示例：

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

server {
    listen 443 ssl;
    server_name your_domain.com;

    ssl_certificate /path/to/your_domain.crt;
    ssl_certificate_key /path/to/your_domain.key;

    # 配置 SSL 协议和加密算法
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers 'TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384';

    # 配置其他 SSL 选项
    ssl_prefer_server_ciphers on;
    ssl_session_timeout 1d;
    ssl_session_cache shared:SSL:50m;
    ssl_session_tickets off;

    # 配置 SSL 证书验证和安全性选项
    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 8.8.8.8;

    # 配置其他 Nginx 选项
    # ...

    location / {
        # 配置用于处理 HTTPS 请求的其他指令
        # ...
    }
}

替换 your_domain.com、/path/to/your_domain.crt 和 /path/to/your_domain.key 为你的域名和证书路径。

4）重新加载 Nginx 配置

保存配置文件后，重新加载 Nginx 以应用更改。

# 检查语法
nginx -t
# 重新加载配置
nginx -s reload

确保在配置 SSL 证书时遵循最佳实践和安全性建议，以确保通信的安全性。此外，你还可以使用在线工具来检查你的 SSL 配置，例如 SSL Labs。

三、nginx 跨域配置

要在 Nginx 中配置跨域资源共享（CORS），你可以使用 add_header 指令设置必要的 CORS 头。以下是一个简单的 Nginx 配置示例，用于允许所有来源的跨域请求：

server {
    listen 80;
    server_name your_domain.com;

    location / {
        # 允许跨域的请求，可以自定义变量$http_origin，*表示所有
        add_header 'Access-Control-Allow-Origin' *;
        # 允许携带cookie请求
        add_header 'Access-Control-Allow-Credentials' 'true';
        # 允许跨域请求的方法：GET,POST,OPTIONS,PUT
        add_header 'Access-Control-Allow-Methods' 'GET,POST,OPTIONS,PUT';
        # 允许请求时携带的头部信息，*表示所有
        add_header 'Access-Control-Allow-Headers' *;
        # 允许发送按段获取资源的请求
        add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
        # 一定要有！！！否则Post请求无法进行跨域！
        # 在发送Post跨域请求前，会以Options方式发送预检请求，服务器接受时才会正式请求
        if ($request_method = 'OPTIONS') {
            add_header 'Access-Control-Max-Age' 1728000;
            add_header 'Content-Type' 'text/plain; charset=utf-8';
            add_header 'Content-Length' 0;
            # 对于Options方式的请求返回204，表示接受跨域请求
            return 204;
        }
    }

}

请注意，上述配置中的 Access-Control-Allow-Origin 设置为 '*'，表示允许所有来源的请求。在实际应用中，你可能需要根据你的需求将其设置为具体的域名。此外，如果你的跨域请求包含其他自定义头部，你需要将它们添加到 Access-Control-Allow-Headers 中。

最后，记得保存配置文件并重新加载 Nginx 以使更改生效：

# 检查语法
nginx -t
# 重新加载配置
nginx -s reload

四、nginx socket 配置

在 Nginx 中配置 WebSocket（WebSocket over HTTP）涉及到一些特殊的配置，因为 WebSocket 协议和传统的 HTTP 协议有些不同。

默认 proxy_http_version 1.0，'websocket' 是建立在 '1.1' 的基础
nginx 默认'不会'为客户端'转发'Upgrade、Connection标头

# 指定用于与后端服务器通信的 HTTP 协议版本。WebSocket 需要使用 HTTP/1.1 协议。
proxy_http_version 1.1;
# Upgrade: protocols  #Upgrade 头指定'一项或多项'协议名,按'优先级'排序,以'逗号'分隔
proxy_set_header Upgrade $http_upgrade;
# Connection: Upgrade #设置 Connection 头的值为 "Upgrade" 来指示这是一个'升级'请求
proxy_set_header Connection "upgrade";

以下是一个简单的 Nginx 配置示例，用于支持 WebSocket：

server {
    listen 80;
    server_name your_domain.com;

    location / {
        # 配置其他 Nginx 选项
        # ...

        # 开启 WebSocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # 配置反向代理到 WebSocket 后端
        proxy_pass http://websocket_backend;

        # 配置其他用于处理请求的指令
        # ...
    }

    # 配置与 WebSocket 后端的连接
    upstream websocket_backend {
        # WebSocket 后端的地址和端口
        server backend_server_ip:backend_server_port;

        # 可以添加多个后端服务器
        # server backend_server2_ip:backend_server2_port;
        # ...
    }
}

请替换以下内容：

your_domain.com：你的域名。
backend_server_ip 和 backend_server_port：WebSocket 后端服务器的地址和端口。

上述配置使用了 proxy_http_version、proxy_set_header Upgrade 和 proxy_set_header Connection 指令来支持 WebSocket。proxy_pass 指令用于将请求代理到 WebSocket 后端。

最后，记得保存配置文件并重新加载 Nginx 以使更改生效：

# 检查语法
nginx -t
# 重新加载配置
nginx -s reload

五、NGINX 路由配置

在 Nginx 中进行路由配置通常涉及使用 location 指令，该指令允许你根据请求的 URI（Uniform Resource Identifier）来分发请求到不同的后端服务或处理逻辑。以下是一些基本的 Nginx 路由配置示例：

1）基本的 URI 匹配

server {
    listen 80;
    server_name your_domain.com;

    location / {
        # 处理根路径请求的配置
        # ...
    }

    location /app1 {
        # 处理以 /app1 开头的 URI 请求的配置
        # ...
    }

    location /app2 {
        # 处理以 /app2 开头的 URI 请求的配置
        # ...
    }

    # 其他 location 配置
    # ...
}

2）nginx 中斜杠(/)

在 Nginx 配置中，location 块和 proxy_pass 指令的斜杠使用方式可能涉及四种情况，取决于是否以斜杠结尾，以及是否在 URI 处理中使用正则表达式。以下是这四种情况的示例：

1、location 以斜杠结尾，proxy_pass 不以斜杠结尾

location /app/ {
    # 匹配以 /app/ 开头的路径
    # ...
    proxy_pass http://backend_server;
}

location 解释：

匹配以 /app/ 开头的路径，例如 /app/foo。
如果请求为 /app/foo，$uri 变量的值为 /foo。

proxy_pass 解释：

proxy_pass 后面没有斜杠，表示请求会被直接转发到 http://backend_server。
对于请求 /app/foo，Nginx 会将请求转发到 http://backend_server/foo。

2、location 不以斜杠结尾，proxy_pass 以斜杠结尾

location /app {
    # 匹配以 /app 开头的路径
    # ...
    proxy_pass http://backend_server/;
}

location 解释：

匹配以 /app 开头的路径，例如 /app/foo。
如果请求为 /app/foo，$uri 变量的值为 /foo。

proxy_pass 解释：

proxy_pass 后面有斜杠，表示请求会被转发到 http://backend_server/。
对于请求 /app/foo，Nginx 会将请求转发到 http://backend_server/foo。

3、location 以斜杠结尾，proxy_pass 也以斜杠结尾

location /app/ {
    # 匹配以 /app/ 开头的路径
    # ...
    proxy_pass http://backend_server/;
}

location 解释：

匹配以 /app/ 开头的路径，例如 /app/foo。
如果请求为 /app/foo，$uri 变量的值为 /foo。

proxy_pass 解释：

proxy_pass 后面有斜杠，表示请求会被转发到 http://backend_server/。
对于请求 /app/foo，Nginx 会将请求转发到 http://backend_server/foo。

4、location 不以斜杠结尾，proxy_pass 也不以斜杠结尾

location /app {
    # 匹配以 /app 开头的路径
    # ...
    proxy_pass http://backend_server;
}

location 解释：

匹配以 /app 开头的路径，例如 /app/foo。
如果请求为 /app/foo，$uri 变量的值为 /foo。

proxy_pass 解释：

proxy_pass 后面没有斜杠，表示请求会被直接转发到 http://backend_server。
对于请求 /app/foo，Nginx 会将请求转发到 http://backend_server/foo。

注意事项：如果使用了 alias 或 root 指令，$uri 变量的值可能会受到影响，需要根据实际情况调整。要确保后端服务的路径配置与 Nginx 转发的路径匹配。

3）nginx root 与 alias 字段区别

root 和 alias 是 Nginx 中用于指定服务器块（server）或位置块（location）的文件系统路径的两个指令。它们在配置静态文件服务时经常使用，但有一些区别。

1、root 指令

root 用于指定服务器或位置的文件系统根目录。当 root 指令用于服务器块时，该路径会成为该服务器上所有位置块的基础路径，除非在某个位置块中使用了 alias 指令。

server {
    listen 80;
    server_name example.com;

    root /path/to/website;

    location / {
        # 请求 /foo 会映射到 /path/to/website/foo
        # ...
    }
}

在这个例子中，root 指定了服务器的根目录为 /path/to/website。所有对该服务器的请求将从这个目录开始寻找文件。

2、alias 指令

alias 用于定义服务器或位置的别名，指定服务器或位置的文件系统路径的替代位置。与 root 不同，alias 允许为某个特定的位置块指定不同的根目录。

server {
    listen 80;
    server_name example.com;

    location /images/ {
        alias /path/to/images/;
        # 请求 /images/foo.png 会映射到 /path/to/images/foo.png
        # ...
    }

    location /static/ {
        alias /path/to/static/;
        # 请求 /static/bar.css 会映射到 /path/to/static/bar.css
        # ...
    }
}

在这个例子中，location /images/ 和 location /static/ 分别定义了不同的别名，使得它们可以映射到不同的文件系统路径。

区别总结：

root：

用于指定服务器或位置的文件系统根目录。
在服务器块中使用时，作为全局的根目录。
在位置块中使用时，将路径追加到服务器块中 root 指定的路径后。

alias：

用于定义服务器或位置的别名，指定不同的文件系统路径。
允许为不同的位置块指定不同的根目录，实现更灵活的路径映射。

4）nginx 正则路由

在 Nginx 中，正则路由指的是通过正则表达式匹配 URL 路径的一种路由配置方式。正则路由通常用于灵活地匹配多个 URL 地址，具有强大的模式匹配功能。以下是一些关于 Nginx 正则路由的详解：

1、基本的正则路由配置：

server {
    listen 80;
    server_name example.com;

    location ~ ^/user/(\d+)$ {
        # 匹配形如 /user/123 的路径，并提取其中的数字
        set $user_id $1;
        # ...
    }
}

在这个例子中，location ~ ^/user/(\d+)$ 使用正则表达式 ^/user/(\d+)$ 匹配形如 /user/123 的路径，并提取其中的数字。$1 是正则表达式中括号捕获的内容，可以赋值给变量 $user_id。

2、正则路由中的限定符

正则表达式中的一些常用限定符，例如 *、+、? 和 {}，在 Nginx 的正则路由中也可以使用。例如：

server {
    listen 80;
    server_name example.com;

    location ~ ^/images/.*\.jpg$ {
        # 匹配以 /images/ 开头，以 .jpg 结尾的路径
        # ...
    }
}

在这个例子中，location ~ ^/images/.*\.jpg$ 使用 .* 匹配任意字符（零次或多次），\. 匹配点号，最后 $ 表示以 .jpg 结尾。

3、正则路由中的位置匹配顺序

在 Nginx 中，正则路由的匹配是按照配置文件中出现的顺序进行的。因此，如果有多个正则路由匹配到同一个 URL，将匹配到第一个满足条件的路由。

server {
    listen 80;
    server_name example.com;

    location ~ ^/user/(\d+)$ {
        # 匹配形如 /user/123 的路径
        # ...
    }

    location ~ ^/user/(\w+)$ {
        # 匹配形如 /user/john 的路径
        # ...
    }
}

在这个例子中，如果请求的路径是 /user/123，将匹配到第一个 location，如果路径是 /user/john，将匹配到第二个 location。

4、正则路由中的变量

可以在正则路由中使用正则表达式中的捕获组提取内容，并将其赋值给变量。这样，可以在后续的配置中使用这些变量。

server {
    listen 80;
    server_name example.com;

    location ~ ^/post/(\d+)$ {
        # 匹配形如 /post/123 的路径，并提取其中的数字
        set $post_id $1;
        # ...
    }
}

在这个例子中，set $post_id $1; 将路径中的数字赋值给变量 $post_id，可以在后续的配置中使用。

六、localhost 加载顺序与默认路由

在 Web 开发中，"localhost" 是一个常用的域名，用于访问本地主机上的网站。在 Nginx 中，"localhost" 通常与默认服务器块（server block）相关联。以下是关于 "localhost" 加载顺序和默认路由的一些说明：

1）默认服务器块的加载顺序

默认服务器块是 Nginx 配置文件中未指定 server_name 的服务器块。当请求进入 Nginx 服务器时，如果请求的域名在配置文件中找不到对应的 server_name，Nginx 将会使用默认服务器块。

server {
    listen 80 default_server;
    server_name _;

    # ... 配置内容 ...
}

上述配置中，server_name _; 表示匹配所有域名。因此，当请求进入时，如果找不到匹配的 server_name，将会使用这个默认服务器块。

2）"localhost" 的加载顺序

当你在浏览器中访问 "localhost" 时，实际上是通过域名来请求 Nginx 服务器。此时，Nginx 将根据域名查找匹配的 server_name。

server {
    listen 80;
    server_name localhost;

    # ... 配置内容 ...
}

上述配置中，server_name localhost; 表示当请求的域名是 "localhost" 时，将使用这个服务器块进行处理。

3）加载顺序总结

如果在配置文件中找到匹配的 server_name，将使用对应的服务器块进行处理。
如果找不到匹配的 server_name，将使用默认服务器块进行处理。
默认服务器块通常会使用 listen 80 default_server; 和 server_name _; 来设置。

注意事项：

在配置文件中，加载顺序是按字母顺序从上到下的，因此确保默认服务器块在其他服务器块之前定义，以确保正确的加载顺序。
如果有多个服务器块定义了相同的 server_name，将使用第一个匹配的服务器块。
通过配置默认服务器块和相应的 server_name，可以确保在 "localhost" 或其他未匹配到域名的情况下，Nginx 能够使用合适的配置进行处理。

NGINX 路由配置与参数详解（https配置、跨域配置、socket配置）就先到这里了，有任何疑问也可关注我公众号：大数据与云原生技术分享，进行技术交流，如本篇文章对您有所帮助，麻烦帮忙一键三连（点赞、转发、收藏）~

posted @ 2024-01-14 21:34 大数据老司机阅读(3739) 评论(0) 编辑收藏举报

刷新页面返回顶部

技术栈

匠人精神，持之以恒！

NGINX 路由配置与参数详解（https配置、跨域配置、socket配置）

一、概述

二、https 配置

1）获取 SSL 证书

2）安装 SSL 证书

3）Nginx 配置修改

4）重新加载 Nginx 配置

三、nginx 跨域配置

四、nginx socket 配置

五、NGINX 路由配置

1）基本的 URI 匹配

2）nginx 中斜杠(/)

1、location 以斜杠结尾，proxy_pass 不以斜杠结尾

2、location 不以斜杠结尾，proxy_pass 以斜杠结尾

3、location 以斜杠结尾，proxy_pass 也以斜杠结尾

4、location 不以斜杠结尾，proxy_pass 也不以斜杠结尾

3）nginx root 与 alias 字段区别

1、root 指令

2、alias 指令

4）nginx 正则路由

1、基本的正则路由配置：

2、正则路由中的限定符

3、正则路由中的位置匹配顺序

4、正则路由中的变量

六、localhost 加载顺序与默认路由

1）默认服务器块的加载顺序

2）"localhost" 的加载顺序

3）加载顺序总结

公告