在 nginx 中，`autoindex`（目录列表）与 `rewrite` 配合处理目录重写时，核心在于利用 `try_files` 指令或正则匹配来拦截对特定目录的请求，并将其重定向到自定义的入口文件（如 index.html），从而避免直接暴露原始目录结构。具体做法是：在 `location` 块中设置 `autoindex on;` 用于调试或备用，但通过 `rewrite ^/target-dir/(.*)$ /custom-handler/index.php?path=$1 last;` 将请求转发给后端脚本处理，或者使用 `try_files $uri $uri/ /fallback/index.html;` 确保当目录不存在时回退到默认页面。这样做可以隐藏真实的目录层级，同时允许通过 url 参数传递路径信息供应用层解析。
如何配置 location 块以拦截目录请求并重写
要拦截对 `/uploads/` 目录的直接访问并重写到 `/app/handler.php`，需要在 `server` 或 `location` 块中使用 `rewrite` 指令。关键在于匹配 URI 模式并捕获子路径。例如，当用户访问 `/uploads/images/photo.jpg` 时，我们希望将其内部重写到 `/app/handler.php?file=images/photo.jpg`。配置如下：首先定义一个 `location` 块匹配 `/uploads/`，然后使用 `rewrite` 规则进行转换。注意，如果同时开启了 `autoindex on`，Nginx 会优先尝试列出目录内容，除非请求被明确重写且不再返回原位置。通常我们会结合 `try_files` 来确保静态文件存在时直接服务，不存在时才重写。
server {
listen 80;
server_name example.com;
# 主应用目录
root /var/www/html;
index index.html;
# 处理 uploads 目录的重写
location /uploads/ {
# 可选：开启 autoindex 用于调试，生产环境建议关闭
# autoindex on;
# 如果文件存在，直接返回；否则重写到 handler
try_files $uri $uri/ /app/handler.php?path=$uri&is_dir=1 last;
}
# 处理程序入口
location /app/ {
fastcgi_pass unix:/var/run/php-fpm.sock;
include fastcgi_params;
}
}
上述配置中，`try_files` 首先检查 `$uri`（即请求的文件）是否存在。如果存在，Nginx 直接返回该文件，此时 `autoindex` 不会生效，因为找到了具体文件。如果 `$uri` 不存在，它检查 `$uri/`（即目录）。如果目录存在且 `autoindex on` 开启，Nginx 会生成目录列表。但如果我们想强制重写，即使目录存在，也可以直接使用 `rewrite` 指令覆盖默认行为。更常见的做法是关闭 `autoindex`，完全由应用层处理目录遍历逻辑。若需保留 `autoindex` 作为 fallback，则需确保 `rewrite` 的优先级高于目录浏览，这通常通过 `last` 标志实现内部跳转，随后由新的 location 处理。
如何处理带参数的目录重写以避免冲突
当目录重写涉及查询参数（query string）时，需要特别注意 `rewrite` 指令是否保留原有参数。默认情况下，`rewrite` 会丢弃原始 query string，除非使用 `?` 符号显式追加。例如，访问 `/docs/v1.0/readme` 时，若希望重写为 `/api/docs?version=1.0&name=readme`，必须手动构建新参数。此外，若目录下有同名文件，`autoindex` 的行为可能与预期不符。解决冲突的方法是：在 `location` 中先判断是否为目录，若是则重写；若否，则直接服务。可以使用 `if (-d $request_filename)` 进行条件判断，但这在 Nginx 中性能较差且易出错。推荐做法是使用 `map` 指令预处理 URI，或在应用层统一处理。
# 使用 map 指令预处理 URI
map $uri $mapped_path {
~^/docs/(.+)$ /api/docs?segment=$1;
default "";
}
server {
listen 80;
server_name example.com;
root /var/www/html;
location /docs/ {
# 如果 map 设置了 mapped_path，则重写
if ($mapped_path) {
rewrite ^ $mapped_path last;
}
# 否则尝试列出目录（需确保 autoindex on）
autoindex on;
try_files $uri $uri/ =404;
}
}
在这个示例中，`map` 指令将 `/docs/` 开头的 URI 映射到 API 端点。当请求进入 `location /docs/` 时，首先检查 `$mapped_path` 是否有值。如果有，执行 `rewrite` 并跳转到新的 location 处理。如果没有，则继续执行 `try_files`，此时若目录存在且 `autoindex on`，Nginx 会返回目录列表。这种方式避免了在 `location` 块中使用复杂的 `if` 嵌套，提高了配置的可读性和性能。需要注意的是，`autoindex` 生成的链接可能不包含正确的上下文路径，因此在生产环境中，通常建议禁用 `autoindex`，完全由前端或后端应用控制目录展示。
基于 autoindex 输出格式的具体问题如何解决
当启用 `autoindex` 后，Nginx 会生成 HTML 格式的目录列表。这个 HTML 结构包含 `` 标签指向文件和子目录。如果希望通过 `rewrite` 修改这些链接的目标地址，直接在 Nginx 配置中是不可能的，因为 `autoindex` 是动态生成的。解决方法是在应用层拦截目录请求，由应用生成自定义的目录页面。例如，将 `/files/` 重写为 `/app/file-browser?dir=/files/`，然后在 PHP 或 Python 应用中读取目录内容并渲染带有自定义链接的 HTML。这样既保留了 `autoindex` 的功能逻辑，又实现了完全定制化的 UI 和 SEO 友好的 URL 结构。此外，可以通过 `add_header` 指令添加自定义响应头，辅助前端脚本处理目录数据。
