davidsiaw/fileserver

fileserver 镜像文档

镜像概述和主要用途

fileserver是一个轻量级的静态文件服务器Docker容器，主要用于提供静态文件服务。该镜像特别设计用于与https://github.com/jwilder/nginx-proxy%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%EF%BC%8C%E4%BE%BF%E4%BA%8E%E5%AE%9E%E7%8E%B0%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E5%92%8C%E8%99%9A%E6%8B%9F%E4%B8%BB%E6%9C%BA%E9%85%8D%E7%BD%AE%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E9%9D%99%E6%80%81%E8%B5%84%E6%BA%90%E3%80%82

核心功能和特性

• 静态文件服务：支持各类静态资源（如HTML、CSS、JavaScript、图片等）的访问
• MP4文件支持：容器内/mp4目录下的文件将被自动识别为MP4视频文件并正确提供服务
• 轻量级设计：镜像体积小，部署简单，资源占用低
• nginx-proxy集成：通过环境变量可轻松配置虚拟主机和端口，与nginx-proxy无缝协作

使用场景和适用范围

• 快速部署静态网站或静态资源服务
• 需要通过nginx-proxy实现多域名/虚拟主机的静态文件托管
• 小型文件共享服务或临时静态资源服务
• 开发环境中快速搭建静态资源服务器

使用方法和配置说明

基本使用方法

通过docker run命令启动容器，挂载本地静态文件目录到容器内指定路径，并配置必要的环境变量实现与nginx-proxy的集成。

部署示例

bash
docker run -v /home/myuser/www:/var/www/static -e VIRTUAL_HOST=example.com -e VIRTUAL_PORT=8080 davidsiaw/fileserver

参数说明

• 数据卷挂载：

  • -v /home/myuser/www:/var/www/static：将本地静态文件目录（如/home/myuser/www）挂载到容器内的/var/www/static目录，容器将从该目录读取并提供静态文件

• 环境变量配置：

  • VIRTUAL_HOST=example.com：指定虚拟主机名，用于nginx-proxy识别并配置反向代理规则
  • VIRTUAL_PORT=8080：指定容器内服务端口，nginx-proxy将代理请求到该端口

特殊目录说明

• /mp4目录：容器内的/mp4目录为特殊处理目录，该目录下的文件将被自动以MP4视频文件类型提供服务，便于视频资源的直接访问。如需提供视频文件，可将MP4文件放置于本地目录的mp4子目录，然后通过-v参数挂载整个目录（如/home/myuser/www:/var/www/static，则本地/home/myuser/www/mp4目录对应容器内/var/www/static/mp4）。