hausgold/minio
hausgold
基于minio/minio镜像，添加mDNS/ZeroConf支持，默认可通过minio.local访问（HTTP API端口80映射9000，Web控制台端口9090），支持自动创建指定名称的桶并允许***下载，便于本地S3兼容服务测试。
下载次数: 0状态：社区镜像维护者：hausgold仓库类型：镜像最近更新：4 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
hausgold/minio 镜像文档
!https://raw.githubusercontent.com/hausgold/docker-minio/master/docs/assets/project.svg
https://github.com/hausgold/docker-minio/actions/workflows/package.yml/badge.svg?branch=master](https://github.com/hausgold/docker-minio/actions/workflows/package.yml) https://img.shields.io/badge/source-on%20github-blue.svg](https://github.com/hausgold/docker-minio) https://img.shields.io/badge/image-on%20docker%20hub-blue.svg](https://hub.docker.com/r/hausgold/minio/)
镜像概述和主要用途
本Docker镜像以https://hub.docker.com/r/minio/minio%E4%B8%BA%E5%9F%BA%E7%A1%80%EF%BC%8C%E6%B7%BB%E5%8A%A0%E4%BA%86mDNS/ZeroConf%E6%A0%88%E3%80%82%E5%9B%A0%E6%AD%A4%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E4%BD%BF%E7%94%A8https://min.io/%EF%BC%8C%E5%B9%B6%E9%BB%98%E8%AE%A4%E9%80%9A%E8%BF%87*minio.local*%E8%AE%BF%E9%97%AE%EF%BC%88HTTP API端口80映射至9000，Web控制台端口9090）。
默认根用户凭据为minioadmin/minioadmin，可通过MINIO_ROOT_USER/MINIO_ROOT_PASSWORD环境变量修改。当BUCKET_NAME环境变量非空时，会自动创建指定名称的桶，并允许***下载该桶内容，便于使用本地S3（兼容）服务测试应用。
核心功能和特性
- 基于官方minio/minio镜像，保留原生功能
- 集成mDNS/ZeroConf，默认通过minio.local访问
- 支持自动创建指定名称的桶，并配置***下载权限
- 可自定义mDNS主机名及多个别名（CNAME）
- 兼容标准minio环境变量配置
要求
- 主机已启用Avahi守护进程
- 主机已启用mDNS NSS查找
快速开始
运行以下命令即可启动一个可用的minio服务：
bash$ docker run --rm hausgold/minio
9000端口（API）保持不变，也可通过mDNS在80端口访问。Web控制台可通过9090端口访问。
docker-compose使用示例
yamlservices: minio: image: docker.xuanyuan.run/hausgold/minio environment: # 注意.local后缀 MDNS_HOSTNAME: minio.test.local
主机配置
安装nss-mdns包，启用并启动avahi-daemon.service。然后编辑/etc/nsswitch.conf文件，修改hosts行如下：
bashhosts: ... mdns4_minimal [NOTFOUND=return] resolve [!UNAVAIL=return] dns ...
配置不同的mDNS主机名
通过环境变量MDNS_HOSTNAME可自定义mDNS主机名，示例：
bash$ docker run --rm -e MDNS_HOSTNAME=something.else.local hausgold/minio
这将使服务可通过something.else.local访问。
还可通过MDNS_CNAMES环境变量配置多个别名（CNAME），以逗号分隔多个域名：
bash$ docker run --rm \ -e MDNS_HOSTNAME=something.else.local \ -e MDNS_CNAMES=nothing.else.local,special.local \ hausgold/minio
此时服务可通过something.else.local、nothing.else.local和special.local访问。
其他顶级域名
默认使用*.local*作为mDNS顶级域名，本镜像不强制使用该域名。若使用非默认顶级域名，需https://wiki.archlinux.org/index.php/avahi#Configuring_mDNS_for_custom_TLD以接受自定义TLD。
进一步阅读
- Docker/mDNS演示：https://github.com/Jack***/docker-mdns
- Archlinux使用指南：https://wiki.archlinux.org/index.php/avahi
- Ubuntu/Debian使用指南：https://wiki.ubuntuusers.de/Avahi/
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull hausgold/minio:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"