功能簡介

Nginx ngx_http_autoindex_module 模組提供目錄列表功能，適合靜態檔案下載站、內部資源分享等場景。預設關閉，需顯式開啟。

核心配置指令

指令	預設值	說明
autoindex	off	開啟目錄列表功能
autoindex_exact_size	on	off 時以人類可讀單位（KB/MB/GB）顯示檔案大小
autoindex_localtime	off	on 時顯示伺服器本地時間，而非 GMT

配置範例

server {
    listen 80;
    server_name files.example.com;
    root /var/www/files;

    location / {
        autoindex on;
        autoindex_exact_size off;
        autoindex_localtime on;
    }
}

進階美化與安全建議

• 第三方模組美化： 使用 ngx_fancyindex 模組支援主題、排序、搜尋、面包屑導航
• 存取控制： 搭配 allow/deny 或 auth_basic 限制存取權限
• 隱藏特定檔案： autoindex_format json 搭配前端過濾，或用 location ~ /\. { deny all; } 隱藏隱藏檔
• 效能優化： 大量檔案目錄建議啟用 open_file_cache 減少系統呼叫

常見問題

開啟後仍顯示 403 Forbidden

確認 root 路徑正確、目錄執行權限（chmod +x）、SELinux/AppArmor 未阻擋

中文檔名亂碼

確保系統 locale 為 UTF-8，Nginx 配置 charset utf-8;

大目錄載入緩慢

考慮分頁、快取或改用專用檔案索引服務

合理配置 autoindex 三大參數，即可快速建立功能完善、體驗友善的檔案瀏覽介面。