mac上用homebrew安装minio是最轻快、适合开发测试的方式，支持一键安装、路径可控、几分钟即可启动s3兼容的本地对象存储服务，包括创建数据目录、前台启动、控制台登录（minioadmin/minioadmin）、建桶上传及后台自启等完整流程。
mac 上用 homebrew 安装 minio 是最轻快、适合开发测试的方式，整个过程不依赖 docker 或手动下载二进制，命令清晰、路径可控，几分钟就能跑起来一个 s3 兼容的本地对象存储服务。
确认并安装 Homebrew（如未安装）
Homebrew 是 macOS 的核心包管理器，MinIO 的官方稳定版通过它分发。先检查是否已就绪：
- 终端执行 brew --version，若显示版本号（如 4.3.x），说明已装好
- 若提示 command not found，运行安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装完成后重启终端，再执行 brew doctor 确保环境正常
安装 MinIO 官方稳定版
MinIO 官方维护了独立 tap（软件源），推荐使用稳定分支而非通用 brew install minio（后者可能指向旧版或非官方镜像）：
- 执行：brew install minio/stable/minio
- 验证安装：brew info minio/stable/minio，能看到版本、安装路径和默认配置说明
- 可选：查看可执行文件位置 —— brew --prefix minio/stable/minio，通常为
/opt/homebrew/opt/minio（Apple Silicon）或/usr/local/opt/minio（Intel）
准备数据目录并启动服务
MinIO 需要一个有读写权限的本地目录存放对象数据，建议用用户主目录下的子目录，避免权限问题：
- 创建目录：mkdir -p ~/minio-data
- 赋予基础权限：chmod 755 ~/minio-data（无需 777，安全更可控）
- 启动服务（前台运行，便于调试）：
minio server ~/minio-data --console-address ":9001" - 服务启动后，终端会输出访问地址和日志；默认 API 端口是
:9000，Web 控制台在:9001
登录控制台并完成基础配置
打开浏览器访问 http://localhost:9001，用默认凭据登录：
-
用户名：
minioadmin -
密码：
minioadmin - 首次登录后建议立即修改密码：点击右上角头像 → “Access Keys” → 新建 root 用户或更新凭证
- 创建 Bucket：左侧菜单选 “Buckets” → “Create Bucket”，输入名称（如
myfiles），保持默认设置即可 - 上传测试文件：进入该 Bucket → 点 “Upload” 按钮，拖入任意小文件（如 .txt 或 .png），验证读写通路
可选：后台常驻与开机自启（生产级轻量部署）
如果希望 MinIO 像系统服务一样长期运行，可用 Homebrew Services 管理：
- 启用服务：brew services start minio/stable/minio
- 查看状态：brew services list | grep minio（状态应为 “started”）
- 默认数据目录为
/opt/homebrew/var/minio（Apple Silicon）或/usr/local/var/minio（Intel），如需自定义路径，需编辑 plist 配置文件：$(brew --prefix)/Cellar/minio/*/homebrew.mxcl.minio.plist
