nginx目录索引autoindex与fancy

nginx不仅仅作为web站点使用,也可以当做一个文件共享的使用,索引目录列表提供用户下载文件,apache的index功能很强大也很漂亮.咱们使用的nginx,说下nginx索引目录(nginx内置索引目录点我),他自带的autoindex模块<a href="http://nginx.org/en/docs/http/ngx_http_autoindex_module.html" target="_blank" rel="noopener">ngx_http_autoindex_module</a>功能很简单,而使用第三方模块<a href="https://www.nginx.com/resources/wiki/modules/fancy_index/" target="_blank" rel="noopener">fancy</a>漂亮,可以实现与apache index相面的功能。本篇就这两个索引模块做下简单的介绍。

一、安装

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



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



<a href="https://www.361way.com/wp-content/uploads/2015/10/fancy.png"><img src="https://www.361way.com/wp-content/uploads/2015/10/fancy.png" alt="fancy" width="654" height="226" class="alignnone size-full wp-image-4767" /></a>



<br />



ngx_http_autoindex_module模块效果



<a href="https://www.361way.com/wp-content/uploads/2015/10/ngx_http_autoindex_module.png"><img src="https://www.361way.com/wp-content/uploads/2015/10/ngx_http_autoindex_module.png" alt="ngx_http_autoindex_module" width="644" height="163" class="alignnone size-full wp-image-4768" /></a>

三、参数说明

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



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



footer.html内容如下:



<br />

 
 

fancy参数详细说明如下:

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



fancyindex_css_href



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



fancyindex_exact_size



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



fancyindex_footer



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



fancyindex_header



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



fancyindex_ignore



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



<br />



fancyindex_localtime



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



<br />

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注