ondh/nginx-fancyindex

Nginx with fancyindex module 镜像文档

镜像概述

本镜像基于Nginx构建，集成了fancyindex模块，提供增强的目录列表展示功能。相比Nginx默认目录列表，fancyindex模块支持更美观的界面样式和更丰富的文件信息展示，适合用于个人文件服务器、下载站点或内部文档共享等场景。

核心功能与特性

• 美观目录列表：提供现代化的目录展示界面，支持自定义样式
• 文件信息展示：显示文件大小、修改时间等详细信息
• Nginx原生功能：保留Nginx的全部核心功能，可作为常规Web服务器使用
• 配置灵活：支持通过挂载配置文件自定义fancyindex参数及Nginx配置

使用场景

• 个人文件共享服务器
• 软件/资源下载站点
• 内部团队文档共享平台
• 需要展示目录结构的Web应用

使用方法

基本部署（docker run）

bash
docker run -d --name nginx-fancyindex \
  -p 80:80 \
  -v /data/http.d:/etc/nginx/http.d \
  ondh/nginx-fancyindex

参数说明：

• -d：后台运行容器
• --name nginx-fancyindex：指定容器名称为nginx-fancyindex
• -p 80:80：将容器的80端口映射到主机的80端口
• -v /data/http.d:/etc/nginx/http.d：挂载主机目录到容器内Nginx配置目录，用于自定义站点配置

自定义配置

1. 在主机的/data/http.d目录下创建站点配置文件（如default.conf）
2. 配置示例（启用fancyindex）：

nginx
server {
    listen 80;
    server_name localhost;
    root /usr/share/nginx/html;
    
    # 启用fancyindex
    fancyindex on;
    # 显示文件大小（human-readable格式）
    fancyindex_exact_size off;
    # 显示修改时间
    fancyindex_show_last_modified on;
    # 自定义标题
    fancyindex_header "/fancyindex/header.html";
}

3. 重启容器使配置生效：

bash
docker restart nginx-fancyindex

注意事项

• 若需展示自定义文件目录，可额外挂载文件目录到容器内（如-v /path/to/files:/usr/share/nginx/html）
• fancyindex模块的更多配置参数可参考其官方文档
• 生产环境建议添加容器重启策略（如--restart always）