用 MinIO 搭建 S3 兼容对象存储服务
分类:开源项目部署
MinIO 适合附件、备份归档和 S3 兼容对象文件。这类主题真正跑起来并不难,难的是上线后稳定、可备份、能排错。本文按实操方式整理一套可以直接落地的流程,默认你已经会登录 Linux 服务器,并能使用 Docker Compose、systemctl 和基础防火墙命令。
核心特性 / 为什么选择 MinIO
- 重点目标是桶策略、访问密钥、数据目录,这些点决定了后续维护成本。
- 配置集中在一个项目目录里,服务、数据、备份脚本和反代规则都能按目录迁移。
- 方案尽量选择容器化或系统原生命令,避免把依赖散装到系统里,后续升级和回滚更容易。
服务器配置建议
MinIO 的配置选择要看使用人数、数据量和是否有重任务。入门不要只追求最低价格,至少要给系统日志、备份压缩、镜像更新和临时文件留出余量。建议系统盘 40G 起步,长期保存数据的项目单独挂载数据盘;如果服务涉及图片、视频、游戏存档或数据库,磁盘 I/O 比单纯 CPU 核心数更影响体验。
我把这套服务部署在雨云服务器 rainyun-com的 2 核 4G 机型上,保存备份、图片附件和小团队对象文件比较稳。注册填优惠码2026off领 5折。
安装步骤
- 准备一台干净的 Ubuntu 22.04 或 Debian 12 服务器,先完成 SSH 密钥登录、防火墙和系统更新。
- 如果是 Web 服务,把域名 A 记录解析到服务器公网 IP;如果是游戏或网络服务,确认云安全组已经放行对应端口。
- 创建项目目录:
/opt/minio-object-storage-20260519。所有配置、数据和备份说明都放在这里,迁移时直接打包目录。 - 写入配置文件后先在本机端口验证,再开放给外部访问。不要一边改配置一边导入大量正式数据。
部署类服务建议先创建一个测试账号,完成登录、写入、重启、再次读取的最小闭环,再交给其他人使用。
配置文件
先创建目录并写入compose.yaml。下面配置保留了关键环境变量,密码和 Token 请换成自己的随机值:
services:minio:image:minio/minio:latestcontainer_name:miniorestart:unless-stoppedports:-"127.0.0.1:9000:9000/tcp"environment:TZ:Asia/ShanghaiSERVICE_NAME:"MinIO"APP_PASSWORD:"change-this-password"volumes:-./data:/datanetworks:-webnetworks:web:external:trueCaddy 反代或端口检查示例:
minioobjectstorage.example.com { encode zstd gzip reverse_proxy 127.0.0.1:9000 }执行命令:
mkdir-p/opt/minio-object-storage-20260519cd/opt/minio-object-storage-20260519dockercompose up-ddockercomposeps启动和验证
验证不要只看“容器是 running”或“命令没有报错”。更可靠的方式是访问入口、写入一条测试数据、重启服务,再确认数据仍然存在。对运维任务来说,则要看状态、日志和实际效果是否一致。
cd/opt/minio-object-storage-20260519dockercompose logs--tail=80ss-lunpt|grep"9000"||true如果验证失败,先按顺序检查三件事:配置文件语法、端口监听状态、日志里的第一条错误。很多问题不是服务本身坏了,而是端口被占用、域名没解析、密码写错或数据目录权限不对。
常用操作 / 使用技巧
- 查看日志或状态时先从当前项目目录执行,避免误操作到其他服务。
- 每次升级前先备份,再拉取镜像或修改配置;升级后观察日志 3 到 5 分钟。
- 密码、Token、数据库口令不要写进公开仓库,生产环境至少放在
.env或权限更严格的配置文件里。 - 应用连接不要长期使用 root key,应创建独立用户和最小权限策略。
备份 / 升级
备份要分清“可再生成”和“不可丢失”的内容。缓存、临时文件、转码文件通常可以丢;数据库、上传文件、配置文件、存档和密钥不能丢。升级前先做一次手动备份,确认备份包能解压,再进行版本更新。
cd/opt/minio-object-storage-20260519dockercompose stoptar-czfminio-object-storage-$(date+%F-%H%M).tar.gz.dockercompose start建议至少保留最近 7 天每日备份和最近 3 个月每月备份。重要数据再同步到另一台服务器或本地硬盘,单机备份挡不住磁盘损坏和误删。