2025年6月最新更新,在ubuntu22.04环境下,可以直接安装:
apt install libnginx-mod-http-fancyindex
通常的nginx的配置文件如下:
server {
listen 80;
listen [2a14:640:2:f7c2::1]:80;
server_name moneyslow.com;
access_log /var/log/nginx/moneyslow.log;
error_log /var/log/nginx/moneyslow.error.log;
location / #指定~/path目录开启自动列目录
{
fancyindex on; #开启nginx目录浏览功能
fancyindex_css_href "/fancyindex/style.css";
fancyindex_name_length 500; # 配置可显示的文件名长度
fancyindex_exact_size off; #文件大小从KB开始显示
fancyindex_localtime on; #显示文件修改时间为服务器本地时间
alias /moneyslow.com/;
fancyindex_header "/fancyindex/header.html";
fancyindex_footer "/fancyindex/footer.html";
fancyindex_time_format "%Y-%m-%d %H:%M";
}
}
------------------------ 以下是旧文 -----------------------------
ngx-fancyindex 代替 autoindex 实现索引目录美化,而且可以加长显示文件名长度。
本文为已安装 Nginx 环境下的操作。
安装ngx-fancyindex
第一步
查看已安装的 Nginx 版本与模块信息:
nginx -V
输出信息类似于:
nginx version: nginx/1.8.0
built by gcc 4.8.5 20150623 (Red Hat 4.8.5-4) (GCC)
TLS SNI support enabled
configure arguments: --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module --with-http_gzip_static_module --user=nginx --group=nginx
第二步
下载对应版本的 Nginx 源码包: http://nginx.org/download/
下载最新版本的 ngx-fancyindex 源码包: https://github.com/aperezdc/ngx-fancyindex/releases
上传至服务器并解压,这里我们上传到/tmp目录。
第三步
编译 Nginx
cd /tmp/nginx-1.8.0 #进入源码目录
./configure --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module --with-http_gzip_static_module --user=nginx --group=nginx --add-module=../ngx-fancyindex-0.4.4
make #编译
可能没有安装的组件:
apt install gcc
apt install make
apt-get install libpcre3-dev
apt-get install libssl-dev
apt-get install zlib1g-dev
特别注意:
./configure后面的配置要对应第一步的输出信息,防止不必要的麻烦,–add-module=../ngx-fancyindex-0.4.4 这里根据你下载解压后的 ngx-fancyindex 目录名来。
只需要 make,不需要 install.
第四步
重命名旧的 nginx 文件:
mv /usr/sbin/nginx /usr/sbin/nginx.bak
复制重新编译的nginx文件到nginx原来安装目录下:
cp ./objs/nginx /usr/sbin/
重新启动 nginx 服务:
service nginx restart
配置ngx-fancyindex
修改nginx配置文件
location /path/ #指定~/path目录开启自动列目录
{
alias /alliot/path/; #虚拟目录/alliot/path/开启自动列目录
root /path/; #实际目录/path/开启自动列目录 与alias二选一
fancyindex on; #开启nginx目录浏览功能
fancyindex_name_length 500; 配置可显示的文件名长度
fancyindex_exact_size off; #文件大小从KB开始显示
fancyindex_localtime on; #显示文件修改时间为服务器本地时间
fancyindex_footer "footer.html"; #设置footer为当前目录下的footer.html
fancyindex_ignore "footer.html"; #设置不列出当前目录下的footer.html
}
location /path/ #指定~/path目录开启自动列目录
{
alias /alliot/path/; #虚拟目录/alliot/path/开启自动列目录
root /path/; #实际目录/path/开启自动列目录 与alias二选一
fancyindex on; #开启nginx目录浏览功能
fancyindex_exact_size off; #文件大小从KB开始显示
fancyindex_localtime on; #显示文件修改时间为服务器本地时间
fancyindex_footer "footer.html"; #设置footer为当前目录下的footer.html
fancyindex_ignore "footer.html"; #设置不列出当前目录下的footer.html
}
上面 alias 与 root 的区别在于, alias 指定的是当前目录,而 root 指定的是根目录,一般情况下,建议在 “location /” 中通过root命令来配置根目录。