access
access 指令在 NGINX 配置中根据变量条件控制访问。
Advanced access control based on variables
·
httpserverlocationlimit_except
语法access (allow|deny) variable;
默认值none
上下文http, server, location, limit_except
参数2
说明
access 指令在 NGINX 中提供基于指定变量的高级访问控制。它允许配置规则，根据运行时对这些变量的评估来允许或拒绝对资源的访问。使用此指令时，可以在 'allow' 或 'deny' 之后指定一个变量；如果该变量非空且不为零，则会触发相应规则。一旦请求被允许，就会绕过任何后续的访问规则，以简化访问控制的执行。
该指令可用于不同的上下文：http, server, location, and limit_except，使其在配置的各个范围内都具有灵活性。此外，还可以通过 access_rules_inherit 指令进一步控制行为，该指令决定当在嵌套的 location 中定义该指令时，来自上级上下文的访问规则应如何应用。
默认情况下，access 指令没有覆盖性的默认值，因此在每个需要访问控制的场景中都必须显式定义。与 access_deny_status 指令结合使用时，管理员还可以自定义拒绝访问时的响应状态码，从而更好地控制服务器对未经授权请求的响应。
配置示例
server {
listen 80;
server_name example.com;
# Allow access if $var1 is non-empty and not zero
access allow $var1;
# Deny access if $var2 is non-empty and not zero
access deny $var2;
location / {
# Your other configurations
}
location /restricted {
# Override deny status code
access_deny_status 404;
# Deny access if $var3 is non-empty and not zero
access deny $var3;
}
}⚠
在未定义适当变量的情况下使用该指令会导致意外行为或错误授予权限。
⚠
如果在嵌套配置中定义多个 access 规则，会增加复杂性；确保规则优先级清晰。
⚠
在考虑 access 规则的执行顺序及其对性能的影响时需要格外小心。条件评估中不必要的复杂性会影响响应时间。