nginx目录索引autoindex与fancy

2014年8月12日 发表评论 阅读评论

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模块效果

fancy

ngx_http_autoindex_module模块效果

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时间)




本站的发展离不开您的资助,金额随意,欢迎来赏!

You can donate through PayPal.
My paypal id: itybku@139.com
Paypal page: https://www.paypal.me/361way

分类: http/html/web, 开源软件 标签:
  1. 本文目前尚无任何评论.
  1. 本文目前尚无任何 trackbacks 和 pingbacks.