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"> 版权所有 © 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时间)