autoindex on不生效主要因三处配置错误：未在匹配路径的location块内显式开启、被上级autoindex off覆盖、或alias/root路径配置错误导致403/404。
为什么 autoindex on 不生效？检查这三处配置位置
目录索引功能默认是关闭的，必须在正确的 location 块里显式开启，且不能被上级 server 或 http 块里的 autoindex off 覆盖。常见错误是只在 server 级写了一次，但实际生效的是嵌套最深、匹配路径最精确的 location。
-
autoindex必须放在匹配目标目录的location块内，例如想让/downloads/可浏览，就写location /downloads/ { autoindex on; } - 确认该
location没有被alias或root配置误导：若用alias /var/www/files/;，则 Nginx 会把请求路径拼接到/var/www/files/后；若用root /var/www;，则会拼到/var/www/downloads/，路径不一致会导致 403 或 404 - 检查是否遗漏
autoindex_exact_size off;和autoindex_format html;—— 否则可能返回纯文本列表（难读）或 JSON（浏览器不渲染）
如何让下载目录支持中文文件名和大文件点击即下
Nginx 默认对中文文件名会做 URL 编码，浏览器解码后可能乱码；同时，大文件若未设置响应头，部分浏览器会尝试在线打开而非下载。这两点需手动干预。
- 加
charset utf-8;到location或server块，确保响应头声明编码 - 用
add_header Content-Disposition "attachment";强制下载（但注意：这会让所有文件都触发下载，包括 HTML 页面；更稳妥的做法是配合if ($request_filename ~ \.(zip|pdf|tar\.gz|exe)$) { add_header Content-Disposition "attachment"; }） - 中文文件名本身无需额外转义，只要文件系统保存为 UTF-8、Nginx 配置中未启用
underscores_in_headers on并避免使用非法字符（如/、NULL），就能正常显示
为什么访问目录返回 403 Forbidden？权限与 SELinux 是真凶
即使 Nginx 配置完全正确，仍返回 403，大概率是系统层限制。Nginx worker 进程以 www-data（Debian/Ubuntu）或 nginx（CentOS/RHEL）用户身份读取文件，它必须对目录有 x（执行）权限才能进入，对文件有 r 权限才能读取内容。
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 运行
ls -ld /var/www/downloads，确认输出中包含r-x（至少对 group 或 other），例如drwxr-xr-x；若为drw-r--r--，则补上执行位：chmod o+x /var/www/downloads - SELinux 启用时（如 CentOS 7+ 默认开启），即使权限正确也会拦截。临时验证：运行
setenforce 0，再试访问；若恢复访问，说明是 SELinux 策略问题，需执行chcon -R -t httpd_sys_content_t /var/www/downloads - 别忽略父目录链：从
/到目标目录的每一级都必须有x权限，否则 Nginx 根本进不去
如何限制目录索引仅对内网开放或加简单密码
公开暴露下载目录有风险，尤其含敏感文件时。Nginx 原生不支持“仅目录级”密码保护，但可用 auth_basic 结合 IP 限制快速落地。
- IP 白名单：在
location块中加allow 192.168.1.0/24;+deny all;，注意allow必须在deny前，且若用云服务（如 AWS ALB、CDN），真实 IP 可能是X-Forwarded-For，需先配置real_ip_header X-Forwarded-For; - 基础认证：加
auth_basic "Restricted Area";和auth_basic_user_file /etc/nginx/.htpasswd;，然后用openssl passwd -apr1生成密码并写入文件（不要用htpasswd，它默认不兼容 Nginx 的 apr1 格式） - 注意：
auth_basic作用于整个location，包括目录索引页和所有子文件；无法单独对索引页设密而放行文件下载
真正容易被忽略的是：目录索引页的 CSS 和图标资源（如 icon 模块提供的小图标）默认由 Nginx 内置提供，但如果你禁用了 include /etc/nginx/mime.types; 或覆盖了 types 块，这些资源会 404，导致页面排版错乱——这不是功能失效，只是前端看起来很奇怪。
