一、autoindex概述

autoindex是Nginx的一個自帶模塊，它用於在瀏覽器中展示一個目錄列表。

當用戶訪問一個Nginx web服務器下的一個目錄而不是一個特定的文件時，autoindex模塊會創建一個HTML頁面，列出目錄下的所有文件及其相關的信息，如文件大小、創建時間、文件類型等。

autoindex模塊還允許用戶對文件進行下載、刪除和重命名等操作。

二、autoindex模塊的開啟和配置

開啟autoindex只需要在Nginx配置文件中添加一行autoindex on語句即可：

server {
  listen 80;
  server_name localhost;
  root /var/www/html;

  autoindex on;
}

除了on之外，還可以設置autoindex為off或exact，默認為exact。

當autoindex為off時，將禁用目錄列表功能，頁面會返回404錯誤。

當autoindex為exact時，Nginx將只顯示與請求的URI精確匹配的目錄，而不是所有子目錄。

同時，autoindex還允許我們進行更加詳細的配置。我們可以設置autoindex_format來控制目錄列表的格式、autoindex_localtime來控制是否用本地時間顯示、autoindex_max_size來限制列表中文件的最大大小等。

三、autoindex的格式配置

autoindex_format可以設置各種目錄列表的格式，比如簡單的默認格式、帶有氣泡提示的完整格式等等。下面是默認的autoindex_format配置：

autoindex_format html;
autoindex_localtime on;
autoindex_exact_size off;
autoindex_min_file_size 0;

autoindex_name_len     255;
autoindex_description on;
autoindex_header_len   35;

autoindex_enable_charset on;
autoindex_charset utf-8;

我們可以根據自己的需求進行修改。例如，我們可以將autoindex_format設置為完整格式：

autoindex_format fancy;

這裡的fancy表示我們將使用一個帶有氣泡提示的完整格式，這樣頁面中的每個文件都有一個氣泡提示框，可以顯示更多的文件信息。

我們還可以使用autoindex_format指定一個自定義的模板，例如：

autoindex_format "


  


  
{{HEADER}}
  
      {{FILES}}
    

    

      

        
名字
        
大小
        
創建時間
      
    
    

  
  
{{FOOTER}}

";

這個模板中使用了一些佔位符，比如{{TITLE}}代表頁面標題、{{HEADER}}代表列表頁頭、{{FILES}}代表文件列表、{{FOOTER}}代表頁腳。我們可以使用這些佔位符來自定義頁面的格式和布局。

四、autoindex的操作功能

除了展示文件信息以外，autoindex還支持文件操作功能，例如下載、刪除和重命名等。比如我們可以通過點擊文件名來下載文件，或者通過點擊刪除按鈕來刪除文件。

autoindex還支持一個叫做accept的參數，用於限定允許下載的文件類型。例如，我們可以只允許下載MP4文件：

location /videos {
  autoindex on;
  autoindex_format fancy;
  accept .mp4;
}

這樣就只會顯示MP4格式的文件了。

除了accept參數外，autoindex還支持deny參數，用於限制不允許下載的文件類型，以及ignore參數，用於忽略某些特定的文件或目錄。

五、總結

Nginx的autoindex模塊可以方便地展示目錄列表，支持自定義格式配置、文件操作功能等多種功能，適用於搭建文件下載站點、上傳文件管理等多種場景。

通過合理的配置，我們可以打造一個美觀、易用的文件共享平台。