efrecon/miniserve

miniserve Docker镜像

镜像概述和主要用途

miniserve Docker镜像是基于Alpine Linux构建的轻量级镜像，用于快速部署miniserve工具。miniserve是一个简单高效的HTTP文件服务工具，旨在让用户能够立即通过HTTP提供文件服务。该镜像的标签与GitHub上miniserve项目的发布版本一一对应（如v0.18.1），新的miniserve版本发布时会被自动检测并构建镜像。镜像通过GitHub工作流自动创建，并支持Docker Hub兼容的钩子，确保镜像的及时更新和分发。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 版本对应：镜像标签严格对应GitHub上miniserve的发布版本，便于版本控制
• 自动更新：新的miniserve版本发布时自动检测并构建镜像，无需手动干预
• 自动化构建：通过GitHub工作流（workflow）自动创建镜像，确保构建过程可靠
• Docker Hub兼容：支持Docker Hub兼容的钩子（hooks），便于集成和分发

使用场景和适用范围

适用于需要快速临时或简单HTTP文件服务的场景，例如：

• 本地开发时临时共享文件
• 局域网内快速分享文件给其他设备
• 临时测试HTTP文件服务功能
• 需要轻量级、即开即用的文件服务解决方案

使用方法和配置说明

基本使用

通过以下命令可快速启动miniserve服务，提供指定目录下的文件：

bash
docker run -v /本地文件目录:/data -p 8080:8080 efrecon/miniserve:版本标签 /data

参数说明：

• -v /本地文件目录:/data：将本地需要提供服务的文件目录挂载到容器内的/data目录
• -p 8080:8080：将容器的8080端口映射到主机的8080端口（默认端口，可根据需求修改）
• efrecon/miniserve:版本标签：指定使用的镜像及版本（如v0.18.1，可在Docker Hub查看最新版本）
• /data：指定miniserve服务的目标目录（即容器内挂载的文件目录）

版本选择

镜像标签与miniserve的GitHub发布版本完全一致，可通过https://hub.docker.com/r/efrecon/miniserve%E6%9F%A5%E7%9C%8B%E6%89%80%E6%9C%89%E5%8F%AF%E7%94%A8%E7%89%88%E6%9C%AC%EF%BC%8C%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E6%9C%80%E6%96%B0%E7%A8%B3%E5%AE%9A%E7%89%88%E6%9C%AC%E4%BB%A5%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E5%8A%9F%E8%83%BD%E5%92%8C%E5%AE%89%E5%85%A8%E6%9B%B4%E6%96%B0%E3%80%82

构建与更新机制

镜像通过GitHub工作流（https://github.com/efrecon/docker-images/tree/master/miniserve/.github/workflows/miniserve.yml%EF%BC%89%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%BD%93miniserve%E9%A1%B9%E7%9B%AE%E5%9C%A8GitHub%E5%8F%91%E5%B8%83%E6%96%B0%E7%89%88%E6%9C%AC%E6%97%B6%EF%BC%8C%E4%BC%9A%E8%87%AA%E5%8A%A8%E8%A7%A6%E5%8F%91%E6%9E%84%E5%BB%BA%E6%B5%81%E7%A8%8B%EF%BC%8C%E7%94%9F%E6%88%90%E5%AF%B9%E5%BA%94%E7%89%88%E6%9C%AC%E7%9A%84%E9%95%9C%E5%83%8F%E5%B9%B6%E6%8E%A8%E9%80%81%E8%87%B3Docker Hub。