Nginx 目录浏览模块 中文乱码 访问认证 ngx_http_autoindex_module

欢迎大家关注本博，同时欢迎大家评论交流，可以给个赞哦！！！

  ngx_http_autoindex_module模块处理以斜杠字符（’/’）结尾的请求，并生成目录列表。通过，ngx_http_autoindex_module当ngx_http_index_module模块找不到索引文件时，会将请求传递到该模块。一般以html格式输出的目录，可以和提供和FTP类似的服务。

  目录浏览模块 语法及语义

  autoindex

   语法：autoindex on | off;

   语义：启用或禁用目录列表输出。

  autoindex_exact_size

   语法：autoindex_exact_size on | off;

   语义：对于HTML格式来说，指定是否应在目录列表中输出确切的文件大小或者四舍五入为千字节、兆字节和千兆字节。

  autoindex_format

   语法：autoindex_format html | xml | json |jsonp;

   语义：设置目录列表的格式。使用JSONP格式时，将使用callbackrequest参数设置回调函数的名称。如果参数丢失或值为空，则使用JSON格式。

  autoindex_locable

   语法：autoindex_localtime on | off;

   语义：对于HTML格式来说，指定是否应在本地时区或UTC中输出目录列表中的时间。

  目录浏览模块 示例

  为演示效果，在/usr/local/nginx/html/下新建如下目录结构，其中存放了bootstrap的js和css文件：

  在默认nginx.conf进行修改，以支持自动索引模块支持：

worker_processes  1;

error_log  logs/error.log;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    sendfile        on;

    keepalive_timeout  65;

    server {
        listen       80;
        server_name  securitit;

        location / {
	    # 启用目录列表输出.
	    autoindex on;
	    # 指定在目录列表中输出确切的文件大小或四舍五入为千字节、兆字节和千兆字节.
	    autoindex_exact_size on;
	    # 指定目录列表的格式. 
	    autoindex_format html;
	    # 指定在本地时区或UTC中输出目录列表中的时间.
	    autoindex_localtime on;
        }

    }

}

  通过浏览器访问http://192.168.20.9/index.html，可以看到响应的内容是一个列表形式的文件目录：

​

  图中红色标识的为目录，可以继续深入查看目录内容：

  上面展示了以html格式输出目录，若要使用json和xml格式输出目录，只需更改autoindex_format配合即可：

# 以json格式输出目录信息.
autoindex_format json;
# 以xml格式输出目录信息;
autoindex_format xml;

  以json和xml格式输出目录的展示结果如下：

  目录浏览模块 乱码问题

  上面示例使用的都是ASCII码的路径和文件名，下面在/usr/local/nginx/html/autoindex/下新建中文目录和中文文件：

  此时配置autoindex_format html;后，浏览器访问http://192.168.20.9/autoindex/，发现中文是乱码的，无法正常显示：

  出现这种情况是Nginx的charset与系统不一致造成的，通过charset参数将字符集设置为系统字符集即可：

charset utf-8;

  设置正确字符集后，通过浏览器访问http://192.168.20.9/autoindex/，发现中文显示正常：

  目录浏览模块 访问认证

  从演示示例乍一看，是不是和FTP服务提供的功能有些类似，虽然Nginx提供了目录浏览的功能，但是其对服务器的暴露程度可谓之高，可能会带来安全问题，我们需要对其增加权限认证，确保其安全性。

  Nginx的ngx_http_auth_basic_module模块提供了基于用户名和密码的认证，其需要使用htpasswd，需要进行安装：

yum install -y httpd-tools

  htpasswd安装后，通过htpasswd生成认证文件：

  在Server级别增加ngx_http_auth_basic_module模块的配置指令：

# 验证时的提示信息.
auth_basic "Please input password";
# 指定认证文件路径.
auth_basic_user_file /usr/local/nginx/conf/passwd;

  通过./nginx -s reload平滑重启Nginx，通过浏览器访问http://192.168.20.9/autoindex/，会出现权限认证：

  输入htpasswd设定的用户名和口令通过认证，可获得正常的可浏览目录：

  总结

  目录浏览模块（ngx_http_auth_basic_module），看似相对简单的模块，但是有很多需要注意的细节，若是这些细节处理不好，目录浏览的效果却会适得其反。

  若文中存在错误和不足，欢迎指正！

本博微信公众号“超哥说码”，欢迎大家订阅，公众号正在完善中，会及时将更优质的博文推送于您！