dceoy/nginx-autoindex

docker-nginx-autoindex

支持autoindex功能的Nginx Docker镜像

https://github.com/dceoy/docker-nginx-autoindex/actions/workflows/docker-publish.yml/badge.svg](https://github.com/dceoy/docker-nginx-autoindex/actions/workflows/docker-publish.yml)

镜像概述和主要用途

docker-nginx-autoindex是一个集成了autoindex功能的Nginx Docker镜像，旨在快速搭建以Web目录列表形式展示指定目录内容的服务器。通过该镜像，用户可将本地目录挂载到容器中，Nginx会自动生成并展示该目录的文件列表，方便通过浏览器浏览和访问目录内文件。

核心功能和特性

• autoindex功能：自动生成目录列表，以Web页面形式展示挂载目录的文件和子目录结构
• Nginx基础服务：基于Nginx构建，提供稳定的Web服务能力
• 只读目录挂载：支持将本地目录以只读（ro）方式挂载至容器，保障源文件安全
• 轻量级部署：无需复杂配置，通过简单命令即可快速启动服务

使用场景和适用范围

• 个人文件共享：快速分享本地目录中的文件，如文档、图片、下载资源等
• 项目文档托管：展示项目文档目录结构，方便团队查阅接口文档、说明文档等
• 内部资源共享：企业或团队内部共享工具、模板、安装包等文件资源
• 临时文件服务：开发测试环境中临时搭建文件服务，用于测试文件访问或下载功能

使用方法和配置说明

拉取镜像

从Docker Hub拉取最新版本镜像：

sh
$ docker image pull dceoy/nginx-autoindex

基本使用（docker run）

通过docker run命令直接启动Web服务器，展示当前目录内容：

sh
$ docker container run --rm -p 80:80 -v ${PWD}:/var/lib/nginx/html:ro dceoy/nginx-autoindex

参数说明：

• --rm：容器停止后自动删除容器文件
• -p 80:80：将容器的80端口映射到主机的80端口，通过http://localhost访问
• -v ${PWD}:/var/lib/nginx/html:ro：将当前目录（${PWD}）以只读（ro）方式挂载到容器内的/var/lib/nginx/html目录（Nginx默认网站根目录）

使用docker-compose运行

通过docker-compose配置文件启动服务：

sh
$ docker-compose -f /path/to/docker-nginx-autoindex/docker-compose.yml up

说明：需将/path/to/docker-nginx-autoindex/docker-compose.yml替换为实际的docker-compose.yml文件路径，配置文件中需定义Nginx服务的端口映射、目录挂载等参数（具体配置可参考镜像源码仓库中的示例文件）。