Nginx的server、location用法及说明

 更新时间:2026年05月27日 14:52:48   作者:无语堵上西楼  
Nginx配置详解:server指令、server_name配置虚拟主机、location匹配匹配匹配规则、rewrite重写规则,帮助理解Nginx服务器配置与URL重写

server常用指令

listen指令

用来配置监听端口

语法

listen address[:port] [default_server]...;

listen port [default_server]...;

默认值listen *:80 | *:8000
位置server

listen的设置比较灵活,我们通过几个例子来把常用的设置方式熟悉下:

listen 127.0.0.1:8000; // listen localhost:8000 监听指定的IP和端口
listen 127.0.0.1;    监听指定IP的所有端口
listen 8000;    监听指定端口上的连接
listen *:8000;    监听指定端口上的连接 

default_server

default_server属性是标识符,用来将此虚拟主机设置成默认主机。

所谓的默认主机指的是如果没有匹配到对应的address:port,则会默认执行的。

如果不指定默认使用的是第一个server。  

server{
	listen 8080;
	server_name 127.0.0.1;
	location /{
		root html;
		index index.html;
	}
}
server{
	listen 8080 default_server;
	server_name localhost;
	default_type text/plain;
	return 444 'This is a error request';
}

server_name指令

用来设置虚拟主机服务名称

语法

server_name name ...;

name可以提供多个中间用空格分隔

默认值server_name "";
位置server

关于server_name的配置方式有三种,分别是

  • 精确匹配
  • 通配符匹配
  • 正则表达式匹配 

精确匹配

server {
	listen 80;
	server_name www.test.cn www.test1.cn;
	...
}

使用通配符配置

server {
	listen 80;
	server_name  *.test.cn	www.test1.*;
	...
}

使用正则表达式配置

server_name中可以使用正则表达式,并且使用~作为正则表达式字符串的开始标记

常见的正则表达式

代码说明
^匹配搜索字符串开始位置
$匹配搜索字符串结束位置
.匹配除换行符\n之外的任何单个字符
\转义字符,将下一个字符标记为特殊字符
[xyz]字符集,与任意一个指定字符匹配
[a-z]字符范围,匹配指定范围内的任何字符
\w与以下任意字符匹配 A-Z a-z 0-9 和下划线,等效于[A-Za-z0-9_]
\d数字字符匹配,等效于[0-9]
{n}正好匹配n次
{n,}至少匹配n次
{n,m}匹配至少n次至多m次
*零次或多次,等效于{0,}
+一次或多次,等效于{1,}
?零次或一次,等效于{0,1}

举例 

server{
        listen 80;
        server_name ~^www\.(\w+)\.com$; # 以 "www." 开头,后跟一个或多个单词字符(字母、数字、下划线),然后以 ".com" 结尾的域名。其中,( ) 括号用于捕获匹配的内容,可以在后面的指令中使用。
        default_type text/plain; # 设置响应的 MIME 类型为 "text/plain",即纯文本类型
        return 200 $1  $2 ..; # 将捕获到的第一个括号内的值 $1、第二个括号内的值 $2 依次附加在返回的文本内容中。
}
注意 ~后面不能加空格,括号可以取值

由于server_name指令支持通配符和正则表达式,因此在包含多个虚拟主机的配置文件中,可能会出现一个名称被多个虚拟主机的server_name匹配成功,当遇到这种情况,当前的请求交给谁来处理呢?

server{
	listen 80;
	server_name ~^www\.\w+\.com$;
	default_type text/plain;
	return 200 'regex_success';
}

server{
	listen 80;
	server_name www.test.*;
	default_type text/plain;
	return 200 'wildcard_after_success';
}

server{
	listen 80;
	server_name *.test.com;
	default_type text/plain;
	return 200 'wildcard_before_success';
}

server{
	listen 80;
	server_name www.test.com;
	default_type text/plain;
	return 200 'exact_success';
}

server{
	listen 80 default_server;
	server_name _;
	default_type text/plain;
	return 444 'default_server not found server';
}

那么他们都会去执行一遍

exact_success
wildcard_before_success
wildcard_after_success
regex_success
default_server not found server!!

location

用来设置请求的URI

语法location [ = | ~ | ~* | ^~ |@ ] uri{...}
默认值
位置server,location

Nginx locaiton 作⽤是根据⽤户请求的 URI 不同,来执行不同的应用。针对用户请求的网站URL 进行匹配,匹配成功后进行对应的操作。

location [ = | ~| ~* | ^~ ] uri {
 #指定对应的动作
}

​uri变量是待匹配的请求字符串,可以不包含正则表达式,也可以包含正则表达式,那么nginx服务器在搜索匹配location的时候,是先使用不包含正则表达式进行匹配,找到一个匹配度最高的一个,然后在通过包含正则表达式的进行匹配,如果能匹配到直接访问,匹配不到,就使用刚才匹配度最高的那个location来处理请求。

正则表达式解释

匹配符匹配规则 优先级
= 精确匹配1
^~ 以某个字符串开头,不做正则2
~*        正则匹配3
/blog/ 匹配常规字符串,有正则就优先正则4
/ 通⽤匹配,不符合其他location的默认匹配5

不带符号,要求必须以指定模式开始

server {
	listen 80;
	server_name 127.0.0.1;
	location /abc{
		default_type text/plain;
		return 200 "access success";
	}
}
以下访问都是正确的
http://192.168.2.4/abc
http://192.168.2.4/abc?p1=TOM
http://192.168.2.4/abc/
http://192.168.2.4/abcdef

= : 用于不包含正则表达式的uri前,必须与指定的模式精确匹配

server {
	listen 80;
	server_name 127.0.0.1;
	location =/abc{
		default_type text/plain;
		return 200 "access success";
	}
}
可以匹配到
http://192.168.2.4/abc
http://192.168.2.4/abc?p1=TOM
匹配不到
http://192.168.2.4/abc/
http://192.168.2.4/abcdef

~ : 用于表示当前uri中包含了正则表达式,并且区分大小写

~*: 用于表示当前uri中包含了正则表达式,并且不区分大小写

server {
	listen 80;
	server_name 127.0.0.1;
	location ~^/abc\w${
		default_type text/plain;
		return 200 "access success";
	}
}
server {
	listen 80;
	server_name 127.0.0.1;
	location ~*^/abc\w${
		default_type text/plain;
		return 200 "access success";
	}
}

^~: 用于不包含正则表达式的uri前,功能和不加符号的一致,唯一不同的是,如果模式匹配,那么就停止搜索其他模式了。

server {
	listen 80;
	server_name 127.0.0.1;
	location ^~/abc{
		default_type text/plain;
		return 200 "access success";
	}
}

root/alias指令

root

设置请求的根目录

语法root path;
默认值root html;
位置http、server、location

path为Nginx服务器接收到请求以后查找资源的根目录路径。

alias

用来更改location的URI

语法alias path;
默认值
位置location

path为修改后的根路径。

以上两个指令都可以来指定访问资源的路径,那么这两者之间的区别是什么?

举例说明 :在/usr/local/nginx/html目录下创建一个 images目录,并在目录下放入一张图片mv.png图片

location /images {
	root /usr/local/nginx/html;
}

root的访问图片的路径为

http://192.168.2.4/images/mv.png

如果把root改为alias,再次访问上述地址,页面会出现404的错误

需要在alias后面路径改为

location /images {
	alias /usr/local/nginx/html/images;
}

小结

root的处理结果是: root路径+location路径
/usr/local/nginx/html/images/mv.png
alias的处理结果是:使用alias路径替换location路径
/usr/local/nginx/html/images

index指令

设置网站的默认首页

语法index file ...;
默认值index index.html;
位置http、server、location

index后面可以跟多个设置,如果访问的时候没有指定具体访问的资源,则会依次进行查找,找到第一个为止。

location / {
	root /usr/local/nginx/html;
	index index.html index.htm;
}
访问该location的时候,可以通过 http://ip:port/,地址后面如果不添加任何内容,则默认依次访问index.html和index.htm,找到第一个来进行返回

error_page指令

设置网站的错误页面

语法error_page code ... [=[response]] uri;
默认值
位置http、server、location......

当出现对应的响应code后,如何来处理。

1.可以指定具体跳转的地址

server {
	error_page 404 http://www.itcast.cn;
}

2.可以指定重定向地址

server{
	error_page 404 /50x.html;
	error_page 500 502 503 504 /50x.html;
	location =/50x.html{
		root html;
	}
}

3.使用location的@符合完成错误信息展示

server{
	error_page 404 @jump_to_error;
	location @jump_to_error {
		default_type text/plain;
		return 404 'Not Found Page...';
	}
}

实战

修改 nginx.conf

#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 83;
		 server_name _;
		 
		 #最低级匹配,不符合其他locaiton就来这
		 location / {
		 return 401;
		}
		 #优先级最⾼
		 location = / {
		 return 402;
		}
		 #以/blog/开头的url,来这⾥,如符合其他locaiton,则以其他优先
		 location /blog/ {
		 return 403;
		}
		 #匹配任何以/img/开头的请求,不匹配正则
		 location ^~ /img/ {
		 return 404;
		}

	}
}

访问localhost:83/

访问localhost:83/blog/

访问localhost:83/img/

rewrire

Nginx rewrire技术主要是实现URL地址重写,且⽀持正则表达式的规则。 通过rewrite可以规范URL、根据变量进⾏URL跳转等,常⽤的功能如

  1. 对于爬⾍的封禁,让其跳转无用页面
  2. 动态的URL伪装成HTMl⻚⾯,便于搜索引擎的抓取
  3. 旧域名、旧⽬录的更新,需要跳转到新的URL地址

语法

rewrite ^/(.*) http://www.baidu.com/$1 permanent;
rewrite是指令,开启⼀个跳转规则
正则是 ^/(.*) 表示匹配所有,匹配成功后跳转到后⾯的url地址
$1 表示取出前⾯正则括号⾥的内容
permanent表示 301 重定向的标记

参数解析

标记解释
last规则匹配完成后,继续向下匹配新的 Locaiton
break本条规则完成匹配后,⽴即停⽌
redirect返回 302 临时重定向,浏览器地址栏显示跳转后的 URL
permanent返回 301 永久重定向,浏览器地址显示跳转后的 URL
  • lastbreak⽤于实现URL重写,浏览器地址栏不发⽣变化
  • redirectpermanent⽤于实现URL跳转,浏览器地址栏跳转新的URL

访问localhost:90/

跳转百度

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Nginx中部署Angular项目遇到的坑巨坑

    Nginx中部署Angular项目遇到的坑巨坑

    这篇文章主要介绍了Nginx中部署Angular项目遇到的坑巨坑,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-10-10
  • keepalived+nginx实现网站高可用性

    keepalived+nginx实现网站高可用性

    本文主要介绍了keepalived+nginx实现网站高可用性,包含配置Keepalived实现双主热备集群架构,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-02-02
  • 为何要小心Nginx的add_header指令详解

    为何要小心Nginx的add_header指令详解

    这篇文章主要给大家介绍了关于为何说要小心Nginx的add_header指令的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-02-02
  • Nginx+Lua动态加载黑名单的实现方案

    Nginx+Lua动态加载黑名单的实现方案

    本文给大家介绍Nginx+Lua动态加载黑名单的完整技术实现方案,包含核心原理、代码实现和性能优化策略,感兴趣的朋友跟随小编一起看看吧
    2025-10-10
  • HAProxy和Nginx搭建负载均衡器的实现

    HAProxy和Nginx搭建负载均衡器的实现

    负载均衡器是一个常用于分布式计算和网络应用中的系统组件,主要用于将客户端的请求分发到多个后端服务器上,以实现高可用性、高性能和可扩展性,本文主要介绍了HAProxy和Nginx搭建负载均衡器的实现,感兴趣的可以了解一下,感兴趣的可以了解一下
    2023-11-11
  • Nginx的超时timeout配置详解

    Nginx的超时timeout配置详解

    本篇文章主要介绍了Nginx的超时timeout配置详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-12-12
  • 分享一份nginx重启脚本

    分享一份nginx重启脚本

    nginx是超级稳定的服务器,一般不会因为超载问题而需要重启,重启的目的一般都是修改配置文件后需要加载一下
    2012-09-09
  • Nginx安装与使用教程详解

    Nginx安装与使用教程详解

    这篇文章主要介绍了Nginx安装与使用教程详解的相关资料
    2016-09-09
  • Nginx负载均衡中的Memcached缓存模块

    Nginx负载均衡中的Memcached缓存模块

    Nginx 的 ngx_http_memcached_module 模块本身并没有提供缓存功能,它只是一个将用户请求转发到 Memcached 服务器的代理模块,这篇文章主要介绍了Nginx负载均衡之Memcached缓存模块,需要的朋友可以参考下
    2024-06-06
  • Nginx服务优化配置方案

    Nginx服务优化配置方案

    这篇文章主要介绍了Nginx服务优化配置方案,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2018-03-03

最新评论