davralin/nginx-autoindex

nginx-autoindex

镜像概述

nginx-autoindex是一个基于官方nginx:stable-alpine镜像构建的Docker容器，默认启用autoindex（目录浏览）功能并关闭server_tokens（隐藏Nginx版本信息），简化了需要目录浏览功能的Nginx部署流程。

此仓库从自托管的Gitea实例镜像而来。

核心功能与特性

• 默认开启autoindex：无需额外配置即可启用目录浏览功能，访问服务器时将自动列出指定目录下的文件和子目录。
• 关闭server_tokens：默认隐藏Nginx版本信息，增强安全性，避免通过HTTP响应头泄露服务器软件版本。
• 基于官方稳定版：继承自nginx:stable-alpine，保持官方镜像的轻量特性（基于Alpine Linux）和稳定性。

使用场景

• 个人文件共享服务器：需要快速搭建支持目录浏览的静态文件服务器。
• 开发环境资源服务：为前端或后端开发提供依赖文件、静态资源的目录访问服务。
• 简单文档托管：用于托管无需复杂配置的文档文件，支持通过目录结构浏览内容。

使用方法与配置说明

基本使用

通过以下命令启动容器，默认会将当前目录作为文件根目录（可替换/path/to/your/files为实际文件目录）：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/files:/usr/share/nginx/html \
  --name nginx-autoindex \
  davralin/nginx-autoindex

参数说明：

• -d：后台运行容器
• -p 80:80：映射容器80端口到主机80端口（可根据需要修改主机端口）
• -v /path/to/your/files:/usr/share/nginx/html：将主机文件目录挂载到容器内Nginx的默认网站根目录
• --name nginx-autoindex：指定容器名称

访问服务

启动后，通过浏览器访问 http://<主机IP或域名> 即可看到目录浏览页面，展示挂载目录下的文件结构。

自定义配置（可选）

若需调整autoindex参数（如排序方式、显示文件大小单位等），可通过挂载自定义Nginx配置文件覆盖默认配置。例如，创建custom.conf文件：

nginx
server {
    listen 80;
    server_name localhost;
    root /usr/share/nginx/html;
    autoindex on;
    autoindex_exact_size off;  # 显示文件大小为人类可读格式（如KB、MB）
    autoindex_localtime on;    # 显示文件修改时间为本地时间
    server_tokens off;
}

启动时挂载配置文件：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/files:/usr/share/nginx/html \
  -v /path/to/custom.conf:/etc/nginx/conf.d/default.conf \
  davralin/nginx-autoindex

镜像拉取

直接从Docker Hub拉取最新镜像：

bash
docker pull davralin/nginx-autoindex