摘要本文使用 MinIO 官方容器文档中的镜像 quay.io/minio/minio在 Docker 中部署单节点单磁盘 MinIO完成 API 端口、Console 控制台、命名卷持久化、Bucket 创建和重启验证。该方案适合本地开发、学习和功能评估不等同于生产环境的高可用部署。一、端口和数据目录9000S3 API程序上传下载对象使用。9001Web Console浏览器管理使用。/dataMinIO 容器内对象数据目录。二、前置准备docker version docker info确认 Docker 已启动主机 9000 和 9001 端口没有被占用并预留对象文件所需空间。三、创建数据卷并启动docker volume create minio_data docker volume inspect minio_data把示例密码替换成强密码docker run -d --name minio -p 9000:9000 -p 9001:9001 -e MINIO_ROOT_USERminioadmin -e MINIO_ROOT_PASSWORDChangeMe_123456 -v minio_data:/data --restart unless-stopped quay.io/minio/minio:latest server /data --console-address :9001latest 是移动标签生产环境应选择经过验证的固定版本。root 密码不能使用示例值。四、确认服务和登录控制台docker ps --filter nameminio docker logs --tail 100 minio浏览器打开http://localhost:9001使用启动命令中的账号密码登录。应用程序访问http://localhost:9000五、创建 Bucket 和测试对象在 Console 中创建 app-files Bucket上传一个小文件再下载和删除它。不要为了方便直接开放公开访问访问策略应按业务需要最小化配置。六、重启持久化验证docker restart minio docker logs --tail 50 minio docker volume inspect minio_data重新登录 Console确认 Bucket 和测试对象仍然存在。命名卷独立于容器但不是备份。七、mc 客户端可选docker run --rm --entrypoint minio/mc --versionWindows Docker Desktop 的 network host 行为与 Linux 有差异mc 连接失败时先使用 Console 验证服务不要直接判断 MinIO 不可用。八、生产边界官方容器文档中的单节点单磁盘流程主要适合开发和评估。生产环境还需要固定镜像版本、TLS、最小权限、独立备份、恢复测试以及符合业务要求的多节点架构。九、常见问题Console 打不开检查 9001 端口映射、容器日志和 Docker 防火墙docker ps docker logs --tail 100 minio删除容器后对象是否还在只要没有删除 minio_data通常可以用同一个卷重新创建容器。删除卷前先确认备份。卸载docker rm -f minio docker volume rm minio_data docker image rm quay.io/minio/minio:latest删除卷会永久删除对象数据。十、官方资料MinIO 官方容器文档Docker Volumes 官方文档总结本教程完成了 Console 登录、API 端口、Bucket 操作、命名卷和重启验证。单节点方案适合本地学习不应直接当作生产高可用方案。