hausgold/minio

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)

镜像概述和主要用途

本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%A8minio%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使用示例

yaml
services:
  minio:
    image: hausgold/minio
    environment:
      # 注意.local后缀
      MDNS_HOSTNAME: minio.test.local

主机配置

安装nss-mdns包，启用并启动avahi-daemon.service。然后编辑/etc/nsswitch.conf文件，修改hosts行如下：

bash
hosts: ... 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顶级域名，本镜像不强制使用该域名。若使用非默认顶级域名，需配置主机Avahi服务以接受自定义TLD。

进一步阅读

• Docker/mDNS演示：https://github.com/Jack***/docker-mdns
• Archlinux使用指南：[***]
• Ubuntu/Debian使用指南：[***]