Nginx的location配置详解

💡Location 是 Nginx 中一个非常核心的配置,通过location块,Nginx可以根据URI的不同部分进行匹配,并指定不同的行为,如代理请求、提供静态文件、重定向等。这篇重点讲解一下 Location 的配置问题以及一些注意事项。

语法

关于 Location,举个简单的配置例子:

js 复制代码
http { 
  server {
      listen 80;
    	server_name www.yayujs.com;
    	location / {
      	root /home/www/ts/;
	      index index.html;
    	}
  }
}

大致的意思是,当你访问 www.yayujs.com 的 80 端口的时候,返回 /home/www/ts/index.html 文件。

我们看下 Location 的具体语法:

css 复制代码
location [ = | ~ | ~* | ^~ ] uri { ... }

重点看方括号中的 = \| \~ \| ~~\* \| \^~~ ,其中 | 分隔的内容表示你可能会用到的语法,其中:

  • = 表示精确匹配,比如:
js 复制代码
location = /test {
  return 200 "hello";
}

# /test ok
# /test/ not ok
# /test2 not ok
# /test/2 not ok
  • ~ 表示区分大小写的正则匹配,比如:
js 复制代码
location ~ ^/test$ {
  [ configuration ] 
}

# /test ok
# /Test not ok
# /test/ not ok
# /test2 not ok
  • ~* 表示不区分大小写的正则匹配
js 复制代码
location ~* ^/test$ {     
	[ configuration ] 
}

# /test ok
# /Test ok
# /test/ not ok
# /test2 not ok
  • ^~ 表示 uri 以某个字符串开头
js 复制代码
location ^~ /images/ {    
	[ configuration ] 
}

# /images/1.gif ok

而当你不使用这些语法的时候,只写 uri 的时候:

/ 表示通用匹配:

ini 复制代码
location / {     
	[ configuration ] 
}

# /index.html ok
shell 复制代码
location /test {
    [ configuration ] 
}

# /test ok
# /test2 ok
# /test/ ok

匹配顺序

location 的定义分为两种:

  • 前缀字符串(prefix string)
  • 正则表达式(regular expression),具体为前面带 ~* 和 ~ 修饰符的

在优先级上,= 修饰符最高,^~ 次之,再者是正则,最后是前缀字符串匹配。在使用前缀字符串的 locations 中选择最长匹配的,并将结果进行储存。

示例

bash 复制代码
server {
    location /doc {
        [ configuration A ] 
    }
    location /docu {
        [ configuration B ] 
    }
}

# 请求 /document 使用 configuration B
# 虽然 /doc 也能匹配到,但在顺序上,前缀字符串顺序不重要,按照匹配长度来确定
bash 复制代码
server {
    location ~ ^/doc {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

# 请求 /document 使用 configuration A
# 虽然 ~ ^/docu 也能匹配到,但正则表达式则按照定义顺序
bash 复制代码
server {
    location ^~ /doc {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

# 请求 /document 使用 configuration A
# 虽然 ~ ^/docu 也能匹配到,但 ^~ 的优先级更高
bash 复制代码
server {
    location /document {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

# 请求 /document 使用 configuration B
# 虽然 /document 也能匹配到,但正则的优先级更高

root 与 alias 的区别

当我们这样设置 root 的时候:

bash 复制代码
location /i/ {
    root /data/w3;
}

当请求 /i/top.gif ,/data/w3/i/top.gif 会被返回。

当我们这样设置 alias 的时候:

bash 复制代码
location /i/ {
    alias /data/w3/images/;
}

当请求 /i/top.gif ,/data/w3/images/top.gif 会被返回。

root 是直接拼接 root + location,alias英文意思为别名ˈeɪliəs,不管请求地址是什么,都是在alias定义的目录下找。

比如刚才的请求时/i/top.gif ,直接的请求路径就是 /data/w3/images/ + top.gif

所以如果你这样使用 allias 定义一个路径:

bash 复制代码
location / {
    alias /data/w3/images/;
}

请求是 a/b/i/top.gif ,最终请求地址为 /data/w3/images/ top.gif

server 和 location 中的 root

server 和 location 中都可以使用 root,举个例子:

ini 复制代码
http { 
  server {
      listen 80;
    	server_name www.yayujs.com;
    	root /home/www/website/;
    	location / {
      	root /home/www/ts/;
	      index index.html;
    	}
  }
}

如果两者都出现,是怎样的优先级呢?

简单的来说,就是就近原则,如果 location 中能匹配到,就是用 location 中的 root 配置,忽略 server 中的 root,当 location 中匹配不到的时候,则使用 server 中的 root 配置。

相关推荐
考虑考虑11 小时前
nginx打印请求日志
运维·后端·nginx
Rain的Java大神之路1 天前
JavaWeb开发如何解决跨域问题
java·前端·后端·nginx·web安全·面试·运维开发
Lsetea2 天前
Nginx报SSL_CTX_use_PrivateKey failed:证书与私钥不匹配怎么排查
nginx·https·ssl证书·openssl·私钥
!chen2 天前
客户环境 Nginx 配置流式报表与超时排查
运维·nginx
大喵桑丶2 天前
AlmaLinux 9 上基于 PostgreSQL + Nginx 部署高可用轻量级 Gitea 服务
nginx·postgresql·gitea
我最爱吃鱼香茄子3 天前
【踩坑实录】若依Vue宝塔部署:验证码空白、反复提示登录状态已过期|完整排错
nginx·宝塔·若依·ruoyi‑vue·登录状态已过期
dazhong20123 天前
Docker 进阶篇(二) Docker Compose 部署 Nginx 实践
nginx·docker·容器
笑梦无境3 天前
nginx安装(5)
linux·运维·nginx
墨着染霜华4 天前
SpringCloud Gateway线上Nginx代理后自定义下划线请求头丢失(app_name/app_version获取不到)完美解决
nginx·spring cloud·gateway
流光D4 天前
AI Era: Building Web Sites and Configuring Nginx Reverse Proxy Process
前端·人工智能·nginx