在 nginx 中,使用 internal 指令可以限制特定 location 块仅能被内部重定向(如 try_files、error_page 或子请求)访问,而拒绝客户端的直接 http 请求。实现方法是直接在目标 location 块中添加 internal 关键字,这样当外部用户尝试直接访问该路径时,nginx 会返回 404 not found 错误。

如何配置 location 以启用 internal 控制
通过在 location 块内声明 internal 指令,即可对该路径实施访问控制。这通常用于保护那些不应被浏览器直接输入 URL 访问的资源,例如由 PHP-FPM 生成的临时文件或由后端服务动态创建的缓存文件。

server {
listen 80;
server_name example.com;
# 正常公开访问的目录
location /public/ {
root /var/www/html;
}
# 受内部控制的目录
location /private/ {
root /var/www/html;
internal;
}
}
在上述配置中,/public/ 下的文件可以被任何用户通过浏览器直接访问。而 /private/ 下的文件则受到保护。如果用户尝试直接访问 http://example.com/private/file.txt,Nginx 将返回 404 错误,即使该文件在磁盘上真实存在。只有当服务器内部逻辑(如 try_files 或 include)引用该路径时,请求才会被允许处理。
internal 与 deny all 的区别及实际应用场景
internal 与 deny all; 的主要区别在于对内部重定向的处理方式。deny all; 会阻止所有请求,包括内部重定向;而 internal 允许内部重定向但阻止外部直接访问。这种特性使得 internal 成为实现“间接访问”模式的理想选择,常用于需要验证权限后才能获取资源的场景。

server {
listen 80;
server_name example.com;
location /protected-resource {
# 模拟权限检查
if ($http_authorization != "valid-token") {
return 403;
}
# 权限通过后,内部重定向到受保护的文件
try_files /private/$uri =404;
}
location /private/ {
root /var/www/html;
internal; # 禁止直接访问,只允许内部重定向
}
}
在这个示例中,用户必须首先访问 /protected-resource 并携带有效的授权头。如果授权成功,Nginx 会通过 try_files 内部重定向到 /private/ 下的对应文件。由于 /private/ 标记为 internal,即使用户知道了该路径,也无法通过直接输入 URL 来绕过权限检查。这种方式有效地将资源访问与权限验证解耦,提高了安全性。
当 internal location 中的文件不存在时会发生什么
当对标记为 internal 的 location 发起内部重定向,且指定文件在磁盘上不存在时,Nginx 的行为取决于具体的触发上下文。如果是通过 try_files 触发的内部重定向,且文件不存在,Nginx 会继续尝试 try_files 列表中定义的后续选项,或者返回指定的错误码(如 404)。如果是通过 error_page 或其他内部机制触发的重定向,且文件不存在,Nginx 通常会返回 404 Not Found 错误,因为内部重定向本身并不改变文件存在的状态。
server {
listen 80;
server_name example.com;
location /test-internal {
# 尝试访问一个不存在的内部文件
try_files /private/nonexistent.html @fallback;
}
location /private/ {
root /var/www/html;
internal;
}
location @fallback {
return 200 "Fallback response";
}
}
在上述配置中,当用户访问 /test-internal 时,Nginx 会尝试内部重定向到 /private/nonexistent.html。由于该文件不存在,try_files 会失败,并转而执行 @fallback 命名位置,返回 "Fallback response"。这证明了 internal 指令仅控制访问权限,而不影响文件存在性检查的逻辑流程。如果 try_files 中没有定义 fallback,则会直接返回 404 错误。











