Nginx限制路径访问，其他URL返回404

文章不知道大家是否熟悉？今天我将给大家介绍《Nginx 限制路径访问，其他 URL 返回 404》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

通过 Nginx 的 `location = /path` 精确匹配和 `return 404` 指令，可限制仅允许 `/blog`、`/contact`、`/faq` 等白名单路径访问，其他路径（如 `/test`）直接返回标准 404 页面，同时保留基础认证等通用逻辑。

要实现“仅放行特定路径（如 /blog、/contact、/faq），其余所有未匹配路径统一返回 404”，关键在于优先级控制与精确匹配。Nginx 的 location 匹配遵循严格优先级规则：=（精确匹配） > ^~（前缀匹配且不继续正则） > 正则匹配 > 普通前缀匹配。因此，我们应将所有需拒绝的路径用 location = 显式声明，并置于通用 location / 之前。

以下是推荐配置方案（适用于少量白名单路径）：

# 先定义所有需返回 404 的非法路径（支持任意数量，但建议 ≤50 条以保可维护性）
location = /test     { return 404; }
location = /admin    { return 404; }
location = /tmp      { return 404; }
# ... 其他禁止路径

# 白名单路径：显式允许并交由 PHP 处理（或静态服务）
location = /blog     { try_files $uri $uri/ /index.php; }
location = /contact  { try_files $uri $uri/ /index.php; }
location = /faq      { try_files $uri $uri/ /index.php; }

# 默认兜底：匹配所有未被上面精确 location 捕获的请求
location / {
    auth_basic "Restricted Content";
    auth_basic_user_file /etc/nginx/.htpasswd;
    # 注意：此处不再使用 try_files 跳转 index.php，
    # 因为只有白名单路径才应进入应用逻辑
    return 404;
}

✅ 优势说明：

• 所有 location = /xxx 均为精确匹配，性能极高；
• 认证逻辑统一收口在 location / 中，避免重复配置；
• 未列在白名单中的路径（如 /test）由独立 location = /test 直接拦截并返回 404，无需进入后续处理流程；
• location / 作为兜底，确保无匹配时也返回 404，增强安全性。

⚠️ 注意事项：

• 不要将 return 404 写在 location / 内部却仍保留 try_files … /index.php —— 这会导致非法路径仍被错误路由至 index.php；
• 若禁止路径数量极多（如上千条），应改用 map 指令 + 变量判断（参考 Nginx 官方 map 模块文档），避免配置臃肿；
• 修改后务必执行 nginx -t 测试语法，并 nginx -s reload 生效配置；
• 确保你的 error_page 404 已正确指向自定义 404 页面（如 error_page 404 /404.html;），否则将返回默认 Nginx 404 响应。

总结：通过合理利用 location = 的高优先级特性，配合清晰的路径分类策略，即可在不依赖后端的情况下，由 Nginx 层面高效、安全地实现 URL 白名单访问控制。

终于介绍完啦！小伙伴们，这篇关于《Nginx限制路径访问，其他URL返回404》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！