当前位置：首页 > news >正文

Nginx IP 限制与路径访问控制配置

news 2025/11/26 6:46:21

Nginx IP 限制与路径访问控制配置

1. 简介

在某些应用场景下，特定路径需要免登录访问，但为了安全考虑，限制只有指定的 IP 地址才能访问该路径。本文档描述了如何在 Nginx 中配置 IP 限制，并在未授权访问时返回 401 Unauthorized 错误。

2. 场景描述

在集成项目中，有一个路径 /demo，要求免登录访问，但需要通过 IP 限制来控制访问权限。只有指定的 IP 地址可以访问该路径，其它 IP 地址访问时返回 401 Unauthorized。

3. Nginx 配置

为实现上述功能，我们将修改 Nginx 的配置文件，具体步骤如下：

3.1 基本路径配置

以下是初始的路径配置，路径别名指向 $base_dir/demo，并且指定了默认的索引文件。

location /demo {alias $base_dir/demo ;index index.html index.htm;try_files $uri $uri/ /demo /index.html;
}

3.2 添加 IP 限制

为了限制只有特定的 IP 地址能够访问 /demo ，我们在路径配置中添加 allow 和 deny 指令。

location /demo {alias $base_dir/demo ;index index.html index.htm;try_files $uri $uri/ /demo /index.html;# IP 限制allow 192.168.1.100;  # 允许访问的IP，可以添加多个 allow 行allow 192.168.1.101;  # 示例：再添加一个允许的IPdeny all;  # 拒绝所有其他IP# 返回 401 Unauthorizederror_page 403 401 = @error401;
}

3.3 自定义 401 错误页面

在 Nginx 中，默认的 403 Forbidden 和 401 Unauthorized 错误页面可以通过 error_page 指令重定向到自定义位置。

location @error401 {return 401;
}

3.4 完整配置示例

以下是添加了 IP 限制并返回 401 Unauthorized 的完整 Nginx 配置示例。

location /demo {alias $base_dir/demo ;index index.html index.htm;try_files $uri $uri/ /demo /index.html;# IP 限制部分allow 192.168.1.100;  # 允许访问的IP，可以添加多个 allow 行allow 192.168.1.101;  # 示例：再添加一个允许的IPdeny all;  # 拒绝所有其他IP# 返回 401 Unauthorizederror_page 403 401 = @error401;
}location @error401 {return 401;
}

4. 配置说明

allow 192.168.1.100;：只允许指定的 IP 地址 192.168.1.100 访问路径 /demo 。
deny all;：拒绝所有未在 allow 中指定的 IP 地址。
error_page 403 401 = @error401;：将 403 Forbidden 和 401 Unauthorized 错误页面重定向到自定义位置 @error401。
location @error401：定义了一个内部位置，当发生错误时，返回 401 Unauthorized。