当前位置：网站首页 >平台公告 > nginx access 配置文件

nginx access 配置文件

2026-05-23 平台公告 1695

nginx access配置：掌控Web访问的核心技巧

在nginx的配置体系中，access配置模块是守护Web服务安全、优化访问体验的"守门人"。它通过定义一系列规则，对请求的来源、路径、行为进行精细管控，直接影响网站的安全性、稳定性和用户体验。掌握access配置的核心逻辑，能让你在服务器运维中更主动地应对各种场景——从基础的权限控制到复杂的流量管理。

一、基础：access配置的核心角色

nginx的access配置本质是一组请求处理规则，基于ngx_http_access_module等模块实现。它通过allow/deny指令直接控制访问权限，也能结合return、rewrite、limit_req等指令实现路径重写、请求拦截、限流等功能。配置文件通常位于nginx.conf或独立的access.conf中，生效优先级遵循"location块 > server块 > 全局配置"的原则。

二、核心指令速查：从拒绝到限流

1. 权限控制：allow/deny

nginx access 配置文件

最基础的访问控制，通过IP网段或单个IP限制访问。
语法：allow 192.168.1.0/24; deny 10.0.0.1;
示例：

location /admin {
  # 允许内网网段访问
  allow 192.168.1.0/24;
  # 拒绝单个IP
  deny all;  # 最后允许/拒绝规则生效，建议用deny all兜底
}

2. 拦截响应：return

直接返回状态码或内容，替代默认错误页。
语法：return <状态码> [内容];
示例：

location /forbidden {
  return 403 "非法访问！请联系管理员";
}

3. URL重写：rewrite

通过正则匹配实现路径转换，常用于301/302跳转。
语法：rewrite <匹配规则> <目标路径> [标志位];
示例：

# 将旧路径重定向到新路径
rewrite ^/old/(.*)$ /new/$1 permanent;  # 301永久重定向

4. 认证保护：auth_basic

HTTP基础认证，适合保护后台管理页面。
配置步骤：

生成密码文件：htpasswd -c /etc/nginx/.htpasswd admin

配置认证：

location /admin {
auth_basic "后台管理";
auth_basic_user_file /etc/nginx/.htpasswd;
}

5. 限流控制：limit_req

防止请求过载，通过limit_req_zone定义限流策略。
示例：

limit_req_zone $binary_remote_addr zone=api_limit:10m rate=1r/s;  # 每秒1次请求
location /api {
  limit_req zone=api_limit burst=5 nodelay;  # 突发5次请求，不延迟
}

三、实战场景：4个高频配置示例

1. 保护后台接口

location /admin {
  auth_basic "后台访问验证";
  auth_basic_user_file /etc/nginx/conf.d/.htpasswd;
  # 仅允许内网IP
  allow 192.168.1.0/24;
  deny all;
}

2. 限制爬虫访问

location ~* \.(php|html)$ {
  # 识别爬虫User-Agent
  if ($http_user_agent ~* "bot|spider|curl") {
    return 403 "爬虫访问被拒绝";
  }
  # 允许正常浏览器访问
  allow all;
}

3. 静态资源防盗链

location ~* \.(jpg|png|css)$ {
  valid_referers none blocked *.example.com;  # 允许本站及无referer访问
  if ($invalid_referer) {
    return 403 "资源访问受限";
  }
}

4. API接口限流

limit_req_zone $binary_remote_addr zone=api:10m rate=2r/s;
location /api/v1/data {
  limit_req zone=api burst=10 nodelay;  # 每秒2次，突发10次
  proxy_pass http://backend_server;
}