nginx目录索引autoindex与fancy

nginx不仅仅作为web站点使用，也可以当做一个文件共享的使用，索引目录列表提供用户下载文件，apache的index功能很强大也很漂亮.咱们使用的nginx，说下nginx索引目录（nginx内置索引目录点我），他自带的autoindex模块ngx_http_autoindex_module功能很简单，而使用第三方模块fancy漂亮，可以实现与apache index相面的功能。本篇就这两个索引模块做下简单的介绍。

一、安装

由于autoindex模块是nginx安装后自带模块，这里不再单独介绍。这里看下fancy模块的安装。

# wget http://nginx.org/download/nginx-1.9.5.tar.gz
# git clone https://github.com/aperezdc/ngx-fancyindex.git ngx-fancyindex
# tar zxvf http://nginx.org/download/nginx-1.9.5.tar.gz
# cd nginx-1.9.5
# ./configure --prefix=/App/nginx --add-module=../ngx-fancyindex
# make && make install

二、nginx索引配置

这里新增了一个测试用的域名 ，并且对两个目录进行了索引配置。上面的361way目录使用fancy模块，下面的auotindex目录使用nginx自带的autoindex模块。

server {
        listen 80;
        server_name index.361way.com;
        root /opt/test;
        index index.html index.htm;
        charset utf-8;
        location ~^/361way(/.*) {
                    fancyindex on;
                    fancyindex_exact_size off;
                    fancyindex_localtime on;
                    fancyindex_footer "/myfooter.html";
                    }
         location ~^/autoindex(/.*) {
                autoindex on;//自动显示目录
                autoindex_exact_size off;//人性化方式显示文件大小否则以byte显示
                autoindex_localtime on;//按服务器时间显示，否则以gmt时间显示
                    }
} 

具体效果如下：

fancy模块效果

ngx_http_autoindex_module模块效果

三、参数说明

由于在最开始的介绍中都链接了两个模块的wiki 地址 ，这里不做详细的说明，只对fancy模块的的使用参数做下介绍。上面用到的几个参数作用如下：

• ancyindex on：开启fancy索引
• fancyindex_exact_size off:不使用精确的大小,使用四舍五入,1.9M会显示为2M这样.如果开启的话，单位为字节
• fancyindex_localtime on：使用本地时间
• fancyindex_footer "/footer.html"：把网站根路径下的footer.html内容作为底部.文件不存在底部会出现404

footer.html内容如下：

<!-- footer START -->
 <div id="footer">
 <a id="gotop" href="#" onclick="MGJS.goTop();return false;">回到顶部</a>
 <a id="powered" href="http://wordpress.org/">WordPress</a>
 <div id="copyright">
 版权所有 &copy; 2011-2013 运维之路  </div>
 <div id="themeinfo">
 <a href="http://www.361way.com/about/">关于我们</a> | <a href="http://www.361way.com/sitemap.html">网站导航</a> | <a href="http://www.361way.com/sitemap.xml">网站地图</a> |<a rel="nofollow" href="http://www.miibeian.gov.cn/">浙ICP备14037069号-2</a>
 </div>
 </div>
 <!-- footer END -->

fancy参数详细说明如下：

fancyindex

语法: *fancyindex* [*on* | *off*]
默认值: fancyindex off
配置块: http, server, location
描述: 开启/关闭目录索引功能

fancyindex_css_href

语法: *fancyindex_css_href uri*
默认值: fancyindex_css_href ""
配置块: http, server, location
描述: 外置css路径，这个css将会替代掉现有的css样式。如果你会css，那你可以把索引列表做得更加漂亮.

fancyindex_exact_size

语法: *fancyindex_exact_size* [*on* | *off*]
默认值: fancyindex_exact_size on
配置块: http, server, location
描述: 定义如何显示文件的大小，默认是on，on：文件大小使用精确值，单位为字节.off:单位为KB,MB,GB，如果含有小数点，将会四舍五入。例如1.9MB，将会显示为2MB。

fancyindex_footer

语法: *fancyindex_footer path*
默认值: fancyindex_footer ""
配置块: http, server, location
描述: 指定哪个文件嵌入到索引页面的底部，效果请看本文的第一张图片

fancyindex_header

语法: *fancyindex_header path*
默认值: fancyindex_header ""
配置块: http, server, location
描述: 指定哪个文件嵌入到索引页面的头部.用法和fancyindex_footer类似

fancyindex_ignore

语法: *fancyindex_ignore string1 [string2 [... stringN]]*
默认值: No default.
配置块: http, server, location
描述: 哪些文件/目录隐藏掉，如果你的nginx支持正则，那么可以使用正则表达式来过滤
例如我想隐藏dir打头的文件或目录以及文件filea.txt，配置如下：fancyindex_ignore "dir*" "filea.txt"

fancyindex_localtime

语法: *fancyindex_localtime* [*on* | *off*]
默认值: fancyindex_localtime off
配置块: http, server, location
Description: 使用当地时间显示文件的创建时间，默认是off（GMT时间）