Nginx & 详细举例 location -＞ index、return、rewrite、try_files、alias 各个属性的含义和注意事项

最新推荐文章于 2024-09-16 08:14:20 发布
最新推荐文章于 2024-09-16 08:14:20 发布
阅读量7.6k 收藏 23
点赞数 7
分类专栏： Nginx 文章标签： nginx web 服务器
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/cookcyq__/article/details/122629541
版权

1、准备工作

1.1 本案例以 centos7 系统作为演示，配置文件在 /etc/nginx/conf.d/test.conf 中，内容如下

server {
  listen  8000;
  server_name           127.0.0.1;
  root                  /home/cookcyq/web/;
  error_page  404              /40x.html;
  error_page  500 502 503 504  /50x.html;
  
  location / {
    return 200 'Hello,world';
  }
}

请务必记住好这几个配置，后面的案例都是以上面作为铺垫。

1.2 /home/cookcyq/web/ 目录如下：

home
	cookcyq
		web
			40x.html 内容为：40xxxxxxxx.html
			50x.html 内容为：50xxxxxxxx.html
			index.html 内容为: indexxxxxx.html

1.3 在 /etc/nginx/nginx.conf 配置文件中将上面的文件引入进来（下面这段下载时就自动加上的，如果没有看到手动加即可）

http{
	...
	include /etc/nginx/conf.d/*.conf;
}

1.4 重启 nginx ，访问 http://127.0.0.1/:8000/ 即可看到输出 Hello,world
在这里插入图片描述
接下来正式进入本文

2、location -> return

2.1 返回状态码 + 字符串

location /a {
	return 200 'Hi, I am a.';
}

重启 nginx，访问 http://127.0.0.1:8000/a 输出：
在这里插入图片描述

2.2 重定向

location /a {
  return https://www.baidu.com;
 }

重启 nginx，访问 http://127.0.0.1:8000/a 重定向到 https://www.baidu.com
在这里插入图片描述

3、location -> index

3.1 准备工作

在 /home/cookcyq/web/ 目录下新建 a 目录，并创建 index.html 和 test.html，结构如下

home
	cookcyq
		web
			a
				index.html  内容为: Hello, index.html.
				test.html 	  内容为：Hello,test.html.

3.2 使用

root                  /home/cookcyq/web/;
....
location /a {
    index index.html;
 }

现在访问 http://127.0.0.1:8000/a 时就会访问 /home/cookcyq/web/a/ 下的 index.html 文件
在这里插入图片描述

index 的作用就是当没有访问任何文件时，则默认访问 index.html

现在我们来指定一个，如 http://127.0.0.1:8000/a/test.html 就会访问 /home/cookcyq/web/a/ 下的 test.html 文件
在这里插入图片描述
如果我们指定一个不存在的文件比如 http://127.0.0.1:8000/a/ffff.html 则存在两种情况：

  1. 如果存在 , location / {} 则先访问
location / { 
	return "Hello,wolrd" 
}

在这里插入图片描述

  1. 如果不存在 location / { … } ，则访问前面所配置好的 error_page 404 /40x.html; 即 /home/cookcyq/web/40.html。
    在这里插入图片描述

4、location -> try_files

try_files 的细节蛮多的，稍不小心就掉进坑里，大家可要细心点哦。

4.1 准备工作

在 /home/cookcyq/web/ 目录下新建 b 目录结构如下

home
	cookcyq
		web
			b
				foo.html  		内容为: Hello, foo.html.
				bar.html	  	内容为：Hello,bar.html.
				index.html		内容为：Hello,b1, index.html.
				b2
					bird.html 		内容为：Hello,Bird.html
					index.html   	内容为：Hello,b2, index.html

请务必记住好这些结构，下面将会使用以上结构作为示例。

4.2 使用

location /b {
	try_files $uri $uri/ /b/index.html;
}

参数解释：

  • 参数一 $uri 表示访问 /b/path/anyfile
  • 参数二 $uri/ 表示访问 /b/path/ 时，访问该目录下的 index.xxx 索引文件
    注意：如果该目录下不存在任何 index.xxx 索引文件则返回 403，如果访问不存在的目录则返回 500。
  • 参数三 表示如果前面两个都找不到则访问 /b/index.html
    注意：如果 /b/index.html 也不存在，则返回 500

接下来我会一一演示如何触发这三个参数：
4.2.1 访问 http://127.0.0.1:8000/b/foo.html 则对应 $uri
4.2.2 访问 http://127.0.0.1:8000/b/b2/bird.html 则对应 $uri
在这里插入图片描述

4.2.3 访问 http://127.0.0.1:8000/b/ 则对应 $uri/
4.2.4 访问 http://127.0.0.1:8000/b/b2/ 则对应 $uri/
在这里插入图片描述

4.2.5 访问 http://127.0.0.1:8000/b/oooo.html 由于 oooo.html 不存在，则对应第三个参数 /b/index.html。
4.2.6 访问 http://127.0.0.1:8000/b/b2/oooo.html 由于 oooo.html 不存在，则对应第三个参数 /b/index.html。
在这里插入图片描述

4.2.7 访问 http://127.0.0.1:8000/b/oooo.html 或 http://127.0.0.1:8000/b/b2/oooo.html 由于 oooo.html 不存在，且第三个参数 /b/index.html 也不存在的话(手动把index.html删掉或重命名即可实现效果)，则返回 500
在这里插入图片描述

4.3 注意事项

  • 第三个参数推荐使用绝对路径的形式 /path/index.html ，请不要采用 $uri/index.html ，因为 $uri/ 是动态的目录，会随着 url 发生变化而变，这样很容易产生找不到目录而报 500 的问题
  • 第三个参数的 / 代表 root 根目录，但它并不会累加 location /b {} ，比如第三个参数为 /index.html 它对应的是 root/index.html 而不是 root/b/index.html，这就是为什么上面的第三个参数为 /b/index.html，而如果是 location /b { index /index.html } 则会累加 root/b/index.html 的形式，这点要注意。

5、location -> rewrite

rewrite 的细节也挺多的，不过理解起来很容易。

5.1 准备工作

在 /home/cookcyq/web/ 目录下新建 c 目录结构如下

home
	cookcyq
		web
			c
				c.html  	内容为：Hello, c.html.
			r
				1.html  	内容为：Hello, 1.html.
				2.html	  	内容为：Hello, 2.html.
				3.html		内容为：Hello, 3.html.

请务必记住好这些结构，下面将会使用以上结构作为示例。

5.2 使用

语法：rewrite [匹配模式] [重定向目标] [指令(可选)]

5.2.1 简单使用

location /c {
	rewrite ^(.*)$ /r/1.html;
}

当访问
http://127.0.0.1:8000/c
http://127.0.0.1:8000/c/c.html
http://127.0.0.1:8000/c/xxx/xxx/xxx
都会重定向访问 root/r/1.html
在这里插入图片描述

记得把前面 location / { return 200 ‘Hello,world’ } 语句去掉，因为 return 指令会跳过下面的 location

5.2.2 带有 last 指令

location /c {
    rewrite ^(.*)$ /r/1.html last;
    # 不会触发这个，因为 last 会跳过下面的执行语句
    rewrite ^(.*)$ /r/2.html last; 
}

当访问
http://127.0.0.1:8000/c
http://127.0.0.1:8000/c/c.html
http://127.0.0.1:8000/c/xxx/xxx/xxx
都会重定向访问 root/r/1.html
在这里插入图片描述

5.2.3 带有 last 指令

location /c {
    rewrite ^(.*)$ /r/1.html last;
    # 不会触发这个，因为 last 会跳过下面的执行语句，但它会继续走进下一个 location 块
    rewrite ^(.*)$ /r/2.html last; 
}
# 这里监听 /r/1.html 再做一次重定向
location = /r/1.html {
	rewrite ^(.*)$ /r/3.html last;
}

当访问
http://127.0.0.1:8000/c
http://127.0.0.1:8000/c/c.html
http://127.0.0.1:8000/c/xxx/xxx/xxx
都将重定向访问 root/r/3.html
在这里插入图片描述
5.2.4 带有 break 指令

location /c {
  rewrite ^(.*)$ /r/1.html break;
  # 不会触发这个，因为 break 会跳过下面的执行语句
  rewrite ^(.*)$ /r/2.html last; 
}

http://127.0.0.1:8000/c
http://127.0.0.1:8000/c/c.html
http://127.0.0.1:8000/c/xxx/xxx/xxx
都会重定向访问 root/r/1.html
在这里插入图片描述
5.2.5 带有 break 指令

location /c {
    rewrite ^(.*)$ /r/1.html break;
    # 不会触发这个，因为 break 会跳过下面的执行语句，同时也会跳过下面的 location 块
    rewrite ^(.*)$ /r/2.html last; 
  }
  # 由于 break 这里不会触发到
  location = /r/1.html {
    rewrite ^(.*)$ /r/3.html last;
  }

http://127.0.0.1:8000/c
http://127.0.0.1:8000/c/c.html
http://127.0.0.1:8000/c/xxx/xxx/xxx
都会重定向访问 root/r/1.html
在这里插入图片描述
5.2.6 容易犯错的重定向案例

location /c {
  rewrite ^(.*)$ /r/1.html last;
}
location = /r/1.html {
  index /r/2.html;
}

思考一下，最终会重定向到哪里？

其实如果你知道 index 的作用，答案就简单多了，这里只会重定向到 root/r/1.html 而不会访问 root/r/2.html，因为 index 只是未访问任何文件时作为默认访问索引文件的指令。
在这里插入图片描述

5.3 注意事项

  • rewrite 重定向目标如果不存在则走进 error_page 404 /40x.html
  • 如果 root 是 /home/cookcyq/web 没有加 /，那么重定向目标时得加 /，反之 root 有加 / 则重定向目标可加可不加 /

6、location -> root 与 alias

假如我们不想让每个 location 都继承 root，而是拥有自己的 root，那么 location 内的 root 与 alias 指令就是很好的选择。

6.1 准备工作

目录结构

home
	cookcyq
		web
			d
				1.html 			内容为 Hello, 1.html
				index.html 		内容为 Hello, web index.html
		my
			d
				foo.html 		内容为 Hello, foo.html.
				index.html 		内容为 Hello, my index.html.

6.2 root

root /home/cookcyq/web/;
location /d {
	root /home/cookcyq/my/;
	try_files $uri $uri/ /d/index.html;
}

当我们访问 http://127.0.0.1:8000/d/foo.html 就会访问 /home/cookcyq/my/d/foo.html
在这里插入图片描述

6.3 alias

root /home/cookcyq/web/;
location /d {
	alias /home/cookcyq/my/d/;
	try_files $uri $uri/ /d/index.html;
}

当我们访问 http://127.0.0.1:8000/d/foo.html 就会访问 /home/cookcyq/my/d/foo.html
在这里插入图片描述

6.4 root 与 alias 的区别

root 指令最终形成的路径为：root+location xxx/*
alias 指令最终形成的路径为：alias/*

cookcyq
关注
专栏目录
nginx rewrite 和 try_files的配置
jurenaa的专栏
05-24 1414
今天看了nginx的这两个线上配置，有点忘记了，查了一些资料，然后梳理了一下，这里做一个记录，原来的配置大约如下（做了简化） location /test { client_max_body_size 1024M; rewrite /test/(.*) /test/abc/$1?$args break; try_files $uri $uri/ @proxy; } location @proxy { xxxx } 这里有一个rewrite和try_files,假设这个...
Nginx 配置 location 以及 return、rewrite 和 try_files 指令
weixin_30348519的博客
06-12 1377
正则表达式 Nginx 内置的全局变量 location 前缀字符串及优先级 示例 location 匹配原则 if 和 break 指令 if break return、rewrite 和 try_files 指令 return 指令 rewrite 指令 flag 标志位 示例 try_files 指令 正则表达式 ...
Nginx - location块中的alias和try_files重定向
SAGGITARXM
01-05 880
然后try_files关键字尝试查找/opt/config/logo/logo.png并返回，如果不存在则返回/opt/config/www/html/logo.png，都不存在，则返回404。如：访问http://127.0.0.1/logo/general/logo.png的时候，在location块中，使用了alias将目录重定向到了/opt/congig，意为：访问/logo/general/地址时，
Nginx的location配置详解
2402_85402030的博客
06-06 1970
💡Location 是 Nginx 中一个非常核心的配置，通过location块，Nginx可以根据URI的不同部分进行匹配，并指定不同的行为，如代理请求、提供静态文件、重定向等。这篇重点讲解一下 Location 的配置问题以及一些注意事项。
Nginx中return和rewrite的区别
最新发布
qq_43038960的博客
09-16 669
rewrite用于修改请求 URI，并将请求重定向到另一个地址，通常用于URL重写或内部转发。rewrite：重写请求的 URI，并根据新的 URI 重新进行一次请求。如果只是简单的重定向需求，推荐使用 return，而如果需要更复杂的 URI 重写逻辑，则可以使用 rewrite。return 比 rewrite 更高效，因为它在 Nginx 的内部进行处理，不会引起额外的请求-响应往返。在Nginx中，return和rewrite都用于重定向请求，但还是有区别，写法也不一样。
Nginx之坑：完全理解location中的index，配置网站初始页
热门推荐
洛丹伦的夏天
08-22 9万+
目录 目录 完全理解index指令 Nginx中文文档 Nginx官方文档 吐槽 完全理解index指令 该指令后面可以跟多个文件，用空格隔开； 文件可以是相对路径也可以是绝对路径； 文件可以使用变量$来命名； 该指令拥有默认值，index index.html ，即，如果没有给出index，默认初始页为index Nginx中文文档 index ...
nginx伪静态之try_files和rewrite讲解
p763833631的博客
06-07 6423
在新浪博客上看到这篇 讲解的不错  分享一下服务器脚本以php为例一、伪静态是个啥？1、说起伪静态基本上搞web开发的人，多多少少都有了解与使用，有人会说什么时候会使用伪静态？使用原生的url地址不是蛮好的吗，确实是这样的，其实我蛮喜欢原生的url风格的，但是由于某些原因我不得不使用伪静态。比如：（1）， url地址比较友好，看着爽，更有说服务力（2）， 如果是一个内容站，有利于seo优化（3），...
nginx 中 index try_files location 这三个配置项的作用
ii窝窝头的博客
06-05 1483
一直在懵逼nginx 的路由配置，经过今天几个小时的努力这次终于弄明白了。 如果有不对的地方，希望有前辈指出错误，让我更上一层楼，也让我别再错误的道路上越走越远。 1.index 我的理解是默认路径，也就是当找不到文件的时候的一个默认的路径，可以配置多个。 具体的用法稍后说，请先记住这个东西当你找不到其他合适的东西，默认给你分配的。 2.location 这个东西匹配你需要的路径 server { listen 80; server_name localhost...
nginx的server、location、root、alias、try_files指令
小小技术团队
07-16 1839
nginx location 配置1. url 结构说明2. nginx server 部分简单说明3. nginx location 部分简单说明4. root，alias, try_files 的相关配置4.1 root4.2 alias4.3 try_files 1. url 结构说明 https://zhangsan:123456@hostname:8888/path/path2?param=value#h123 参考 URL - Web API 接口参考 | MDN 示例部分 英文名
【Nginx的前端配置try_files用法解释（使用alias配置代理）】
wanzhong11的博客
06-08 1473
使用示例一的配置，下钻后的页面能正常在当前页面刷新;alias：ip/screen/访问代理到ip/data/sanwang/screen/alias：ip/screen/访问代理到ip/data/sanwang/screen/根据上面的配置，当请求 http://ip/screen/aiGovernance 时。根据上面的配置，当请求 http://ip/screen/aiGovernance 时。最后：如果没有找到任何文件，则进行内部重定向到最后一个参数中指定的 uri。成功刷新到了当前页面。
nginx 编译不添加重写模块--without-http_rewrite_module
快乐de馒头
03-21 4464
配置nginx时加上--without-http_rewrite_module这个参数，就不需要安装pcre不加--without-http_rewrite_module这个参数时就是启动URL重写，所以需要pcre./configure --with-http_stub_status_module --without-http_rewrite_module --prefix=/usr/local...
nginx-1.19.3_nginx-http-flv-module.rar
09-01
标题中的"nginx-1.19.3_nginx-http-flv-module.rar"表明这是一个关于Nginx服务器的软件包，特别地，它包含了Nginx的1.19.3版本，并且已经集成了`nginx-http-flv-module`模块。这个模块是用于支持HTTP FLV（Flash ...
Nginx的location指令
Leon_Jinhai_Sun的博客
10-31 958
location指令 server{ listen 80; server_name localhost; location / { } location /abc{ } ... } location:用来设置请求的URI 语法 location [ = | ~ | ~* | ^~ |@ ] uri{...} 默认值 — 位置 server,location uri变量是待匹配的请求字符串，可以不包含正则表达式，也可以包含正则表达式，那么nginx服
nginx location 配置中 try_files, alias, root, index 的
weixin_33787529的博客
11-23 1950
需求场景 朋友让我帮忙挂一个网页，有点类似“钓鱼”的性质（开玩笑，没这么严重），就是找一个类似的域名，把原网站其中一个网页完全复制过来，修改其中的内容，然后给甲方看。但是，这个新域名的其他 URL 都需要跳转到原域名。 假设，原域名为 a.com, 新域名为 b.com。规则是： http://www.b.com/a/b.aspx?id=1024 显示...
nginx(七十一)root、alias、index、try_files关系指令再探
wzj_110的博客
04-22 5599
root、alias、index、try_files辨析。internal内部重定向。try_files再探。
nginx的localtion指令详解
qfyangsheng的博客
09-17 716
nginx的localtion指令详解 Nginx 的 HTTP 配置主要包括三个区块，结构如下： http { # 这个是协议级别 　　include mime.types; 　　default_type application/octet-stream; 　　keepalive_timeout 65; 　　gzip on; 　　　　server { # 这个是服务器级别 　　　　　　listen 80; 　　　　　　server_n
nginx之location详解
weixin_38168918的博客
08-26 253
location有定位的意思，根据uri来进行不同的定位，在虚拟主机中是必不可少的，location可以定位网站的不同部分，定位到不同的处理方式上。 location匹配分类 精准匹配 一般匹配 正则匹配 总结 精准匹配 精准匹配以=号为标志 location = /index.htm { root /var/www/html/; index index.htm i...
Nginx之location详解
HSJ0170的博客
07-28 1949
rootlocation中root指定的只是相对路径，需要和路径结合起来映射地址，比如。
nginx中location里面的try_files配置导致Vue设置history模式下的请求丢失参数
weixin_44457062的博客
07-21 5432
vue使用history模式在访问地址的参数会丢失，地址栏也会变成没有参数的地址，并且请求会发生301重定向。最后，发现vue从history模式改成hash模式可以解决参数丢失。但是产生301是nginx的问题，发现nginx配置的try_files有问题，所以会导致丢参数，try_files的配置是为了适配history模式。而nginx默认支持hash模式，不需要额外的配置，所以nginx默认hash是没有问题。最终，发现更改nginx的try_files也能让history模式的访问地址不丢参数。.
如何查看：域名->端口-> location -> upstream -> 后端IP:端口 请详细说明并带上执行的命令
09-12
要查看从域名到后端IP端口的完整路径，通常是在一个配置了反向代理的环境中，比如使用了Nginx或Apache这样的Web服务器。下面我将以Nginx为例，说明如何查看域名映射到后端服务器的过程。 1. 查看域名配置的端口和location配置 首先，你需要查看Nginx的配置文件来确定域名对应的端口以及location块的配置。这通常在`nginx.conf`文件以及`conf.d`目录下或`sites-available`目录下的配置文件中。 执行命令： ```bash grep -R "server_name" /etc/nginx/ # 查找包含server_name（域名）的行 ``` 2. 查看upstream配置 接下来，需要找到upstream块的配置，这个块通常定义了一个服务器组，Nginx会根据配置向这些服务器转发请求。 执行命令： ```bash grep -R "upstream" /etc/nginx/ # 查找包含upstream的行 ``` 3. 查看后端服务器的IP和端口 最后，你需要查看upstream中指定的服务器的IP地址和端口。这通常在upstream配置中指定。 以下是一个Nginx配置文件的示例，展示了一个简单的域名到后端服务器的映射： ```nginx http { server { listen 80; # 监听80端口 server_name example.com; # 域名 location / { proxy_pass http://backend; # 这里的backend是upstream块中定义的名称 } } upstream backend { server 192.168.1.100:8080; # 后端服务器的IP和端口 } } ``` 在这个例子中，当用户访问`http://example.com`时，Nginx会将请求转发到IP地址为`192.168.1.100`，端口为`8080`的后端服务器上。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

cookcyq

请作者喝杯暖暖的奶茶

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值