mohamnag/nginx-file-browser

nginx file browser

镜像概述和主要用途

nginx file browser 是一个为Nginx设计的极简文件浏览器，旨在增强Nginx autoindex模块的功能，提供更友好的Web文件浏览界面。通过该镜像，用户可以便捷地通过浏览器访问和管理Nginx服务器上的文件目录。详细信息可参考项目仓库：https://github.com/mohamnag/nginx-file-browser。

核心功能和特性

• 简洁易用：设计极简，无需复杂配置即可快速部署
• 兼容性强：专为Nginx autoindex模块打造，无缝集成
• 轻量级：资源占用低，不影响Nginx服务器性能
• 直观界面：提供清晰的文件目录结构展示，支持文件浏览和访问

使用场景和适用范围

• 个人服务器文件管理：通过Web界面便捷查看和访问服务器文件
• 开发环境资源共享：供团队成员浏览和获取项目资源文件
• 轻量级文件服务：快速搭建简单的Web文件共享服务

使用方法和配置说明

基本部署（Docker Run）

通过以下命令快速启动容器，将本地文件目录挂载到容器中并映射端口：

bash
docker run -d \
  -p 8080:80 \
  -v /path/to/your/files:/usr/share/nginx/html \
  docker.xuanyuan.run/mohamnag/nginx-file-browser

• -p 8080:80：将容器的80端口映射到主机的8080端口
• -v /path/to/your/files:/usr/share/nginx/html：挂载本地文件目录到Nginx的默认网站根目录

Docker Compose 配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  nginx-file-browser:
    image: docker.xuanyuan.run/mohamnag/nginx-file-browser
    ports:
      - "8080:80"
    volumes:
      - /path/to/your/files:/usr/share/nginx/html
    restart: always

执行以下命令启动服务：

bash
docker-compose up -d

访问方式

部署完成后，通过浏览器访问 http://<主机IP>:8080 即可查看挂载目录下的文件列表。

注意事项

• 确保挂载的本地目录具有适当的读写权限，以便Nginx能够正常访问文件
• 如需自定义Nginx配置，可通过挂载Nginx配置文件到容器的/etc/nginx/conf.d/目录实现