目录
一、概述
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配置)就先到这里了,有任何疑问也可关注我公众号:大数据与云原生技术分享
,进行技术交流,如本篇文章对您有所帮助,麻烦帮忙一键三连(点赞、转发、收藏)~