最近博客项目越来越多，各种图片、视频、文档堆得到处都是，传统的文件存储方式真的是让人头疼。之前用过阿里云OSS，效果不错但成本有点高，特别是对于中小企业来说。后来发现了MinIO这个开源的对象存储解决方案，用了一段时间感觉真香！今天就来分享一下MinIO的搭建过程和使用心得。

什么是MinIO，为什么选择它

MinIO是一个高性能的分布式对象存储服务，完全兼容Amazon S3 API。说白了就是一个可以自己部署的"云存储"，而且还是免费的。

我当时选择MinIO主要是因为几个原因：第一个是成本考虑，自己搭建比买云服务便宜太多了；第二个是数据安全，所有数据都在自己手里；第三个就是性能不错，而且扩展性很好。

用过一段时间后发现，MinIO确实有它的优势。部署简单，管理方便，而且因为兼容S3 API，很多现有的工具和SDK都可以直接用，迁移成本很低。

环境准备和基础配置

我的测试环境是Debian GNU/Linux 12 (bookworm)，4核8G内存，500G硬盘。其实MinIO对硬件要求不高，但如果你要存储大量数据的话，硬盘空间肯定要够用。

image-20250827234646617

首先更新一下系统：

apt update && apt upgrade -y

安装一些必要的工具：

apt install wget curl systemd -y

Debian 12默认的防火墙配置比较宽松，不过为了安全起见，我们还是配置一下ufw：

apt install ufw -y
ufw allow ssh
ufw allow 9000/tcp
ufw allow 9001/tcp
ufw --force enable

创建一个专门的用户来运行MinIO：

useradd -r minio-user -s /sbin/nologin

MinIO单机版安装

下载MinIO的二进制文件，官方提供了编译好的版本：

wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio
mv minio /usr/local/bin/

创建数据存储目录：

mkdir -p /data/minio
chown minio-user:minio-user /data/minio

创建配置文件目录：

mkdir -p /etc/minio

配置环境变量，创建 /etc/default/minio 文件：

# 访问密钥，这个相当于用户名
MINIO_ROOT_USER=admin
# 秘密密钥，相当于密码，至少8位
MINIO_ROOT_PASSWORD=password123
# 数据存储路径
MINIO_VOLUMES="/data/minio"
# 服务监听地址和端口
MINIO_OPTS="--console-address :9001"

这里要注意，MINIO_ROOT_PASSWORD必须至少8位，不然启动会报错。我之前就因为密码太短折腾了半天。

创建systemd服务

为了方便管理，我们创建一个systemd服务文件 /etc/systemd/system/minio.service：

[Unit]
Description=MinIO
Documentation=https://docs.min.io
Wants=network-online.target
After=network-online.target
AssertFileIsExecutable=/usr/local/bin/minio

[Service]
WorkingDirectory=/usr/local/

User=minio-user
Group=minio-user

EnvironmentFile=/etc/default/minio
ExecStartPre=/bin/bash -c "if [ -z \"${MINIO_VOLUMES}\" ]; then echo \"Variable MINIO_VOLUMES not set in /etc/default/minio\"; exit 1; fi"

ExecStart=/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES

# Let systemd restart this service always
Restart=always

# Specifies the maximum file descriptor number that can be opened by this process
LimitNOFILE=65536

# Specifies the maximum number of threads this process can create
TasksMax=infinity

# Disable timeout logic and wait until process is stopped
TimeoutStopSec=infinity
SendSIGKILL=no

[Install]
WantedBy=multi-user.target

启动服务：

systemctl daemon-reload
systemctl enable minio
systemctl start minio

检查服务状态：

systemctl status minio

image-20250827235842643

如果一切正常，你应该能看到服务正在运行。这时候可以通过浏览器访问 http://你的服务器IP:9001 来打开MinIO的Web管理界面。

Web界面初体验

第一次打开MinIO的Web界面，感觉还是挺现代化的。用刚才配置的用户名密码登录后，界面很直观，左侧是功能菜单，右侧是主要操作区域。

在Buckets页面可以创建存储桶，这个概念和AWS S3是一样的。点击"Create Bucket"，输入桶名称，比如"test-bucket"。桶名称有一些限制，不能有大写字母，不能有特殊字符等等。

创建好桶之后就可以上传文件了。界面支持拖拽上传，也可以点击上传按钮选择文件。上传速度还是很快的，我测试了几个几十MB的文件，基本上都是秒传。

image-20250827235947143

image-20250828000019049

image-20250828000033524

配置访问策略

默认情况下，上传的文件是私有的，外部无法直接访问。如果你想让某些文件可以公开访问，需要配置访问策略。

在桶的设置页面，有一个"Access Policy"选项。你可以设置整个桶为公开读取，或者只对特定路径设置策略。

比如我想让test-bucket下的images目录公开可读，可以添加这样的策略：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": ["*"]
      },
      "Action": ["s3:GetObject"],
      "Resource": ["arn:aws:s3:::test-bucket/images/*"]
    }
  ]
}

使用API和SDK

MinIO最大的优势就是完全兼容S3 API，这意味着你可以使用任何支持S3的工具和SDK。

我用Python测试了一下，使用boto3库：

import boto3
from botocore.client import Config

# 配置MinIO连接
s3_client = boto3.client('s3',
    endpoint_url='http://你的服务器IP:9000',
    aws_access_key_id='admin',
    aws_secret_access_key='password123',
    config=Config(signature_version='s3v4'),
    region_name='us-east-1'
)

# 列出所有桶
response = s3_client.list_buckets()
print('桶列表:')
for bucket in response['Buckets']:
    print(f'  {bucket["Name"]}')

# 上传文件
s3_client.upload_file('local_file.txt', 'test-bucket', 'remote_file.txt')

# 下载文件
s3_client.download_file('test-bucket', 'remote_file.txt', 'downloaded_file.txt')

代码运行很顺利，和使用AWS S3没什么区别。这样的话，如果以后要迁移到云端或者从云端迁移回来，基本上不用改代码。

集群部署考虑

单机版MinIO适合测试和小规模使用，但如果数据量大或者对可用性要求高，就需要考虑集群部署了。

MinIO支持分布式部署，最少需要4个节点。我之前在另一个项目中部署过4节点的MinIO集群，配置稍微复杂一些，但性能和可靠性确实提升了不少。

集群部署的话，每个节点的配置基本相同，主要是在启动命令中指定所有节点的地址：

minio server http://node{1...4}.example.com/data/minio --console-address ":9001"

不过集群部署涉及的东西比较多，网络配置、负载均衡、数据一致性等等，这个话题可以单独写一篇文章了。

性能优化和监控

用了一段时间后，我发现有几个地方可以优化性能。

Debian 12的内核版本比较新，对SSD的支持很好。如果可能的话最好使用SSD，特别是对于小文件比较多的场景。我把数据目录迁移到SSD后，响应速度明显提升。

其次是内存，MinIO会使用内存做缓存，内存越大性能越好。我把测试服务器的内存从8G升级到16G后，并发处理能力有明显改善。

网络带宽也很重要，特别是如果你要存储大文件的话。千兆网卡基本够用，但如果预算允许，万兆网卡当然更好。

监控方面，MinIO提供了Prometheus metrics接口，可以很方便地集成到现有的监控系统中。访问 http://你的服务器IP:9000/minio/v2/metrics/cluster 就能看到各种指标数据。

备份和恢复策略

数据安全永远是第一位的，所以备份策略很重要。

MinIO支持多种备份方式。最简单的是使用mc（MinIO Client）工具进行镜像同步：

# 下载mc工具
wget https://dl.min.io/client/mc/release/linux-amd64/mc
chmod +x mc
mv mc /usr/local/bin/

# 配置别名
mc alias set myminio http://localhost:9000 admin password123

# 镜像同步到另一个MinIO实例
mc mirror myminio/test-bucket backup-minio/test-bucket-backup

也可以定期将数据同步到其他存储系统，比如另一台服务器的文件系统，或者云存储服务。

我现在的做法是每天晚上自动将重要数据同步到另一台服务器，每周做一次完整备份到外部存储。虽然有点麻烦，但数据安全有保障。

遇到的一些坑

部署过程中也遇到了一些问题，分享一下避免大家踩坑。

第一个是权限问题。MinIO对文件权限要求比较严格，如果数据目录的权限不对，服务启动会失败。记得要把数据目录的所有者设置为minio-user。

第二个是端口冲突。MinIO默认使用9000端口提供API服务，9001端口提供Web界面。如果这些端口被占用，需要在配置中修改。

第三个是时间同步。如果服务器时间不准确，可能会导致一些奇怪的问题，特别是在集群环境中。Debian 12默认使用systemd-timesyncd，可以检查一下时间同步状态：

timedatectl status

如果时间不同步，可以手动同步：

apt install ntp -y
systemctl enable ntp
systemctl start ntp

还有就是防火墙配置，如果开启了ufw，记得开放相应的端口：

ufw allow 9000/tcp
ufw allow 9001/tcp
ufw reload

实际使用场景

我们现在主要用MinIO存储几类数据：

用户上传的图片和文档，这部分数据量最大，而且访问频率比较高。MinIO的性能完全能满足需求，响应速度比之前用的传统文件存储快很多。

系统日志和备份文件，这些数据访问频率不高，但需要长期保存。MinIO的存储成本比云存储低很多，很适合这种场景。

还有就是临时文件和缓存数据，比如视频转码的中间文件，数据处理的临时结果等等。这些文件生命周期比较短，但需要高性能的存储。

总的来说，MinIO在我们的使用场景中表现很好，稳定性和性能都没问题。

与其他方案的对比

之前也评估过其他一些开源存储方案，比如Ceph、GlusterFS等等。

Ceph功能很强大，但配置复杂，学习成本高，而且对硬件要求也比较高。对于我们这种中小规模的应用来说有点杀鸡用牛刀的感觉。

GlusterFS在文件系统层面工作，适合传统的文件存储场景，但对象存储的支持不如MinIO原生。

FastDFS是国内比较流行的分布式文件系统，但生态不如MinIO丰富，而且缺少标准的API支持。

综合考虑下来，MinIO确实是一个不错的选择，特别是对于需要S3兼容API的场景。

未来规划

目前我们的MinIO部署还比较简单，主要是单机版。随着业务发展，计划逐步升级到集群版本，提高可用性和性能。

另外也在考虑集成更多的监控和告警功能，比如磁盘空间不足告警、服务异常告警等等。MinIO的生态还是很丰富的，有很多现成的工具可以使用。

还有就是数据生命周期管理，对于一些不常访问的历史数据，可以考虑迁移到更便宜的存储介质，或者设置自动删除策略。

MinIO确实是一个值得推荐的开源对象存储解决方案。部署简单，性能不错，生态丰富，而且完全免费。如果你也在为存储方案发愁，不妨试试MinIO，说不定会有惊喜。

当然，任何技术方案都不是万能的，选择存储方案还是要根据自己的实际需求来。数据量、访问模式、性能要求、预算限制等等都是需要考虑的因素。

一些实用的运维技巧

用了这么长时间MinIO，积累了一些运维方面的小技巧，分享给大家。

日志管理是个重要的话题。MinIO的日志默认输出到标准输出，如果用systemd管理的话，可以通过journalctl查看：

journalctl -u minio -f

但生产环境建议把日志重定向到文件，方便后续分析。可以修改systemd服务文件，添加日志重定向：

ExecStart=/bin/bash -c '/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES >> /var/log/minio/minio.log 2>&1'

记得创建日志目录并设置合适的权限：

mkdir -p /var/log/minio
chown minio-user:minio-user /var/log/minio

还有一个就是定期清理临时文件。MinIO在处理上传请求时会产生一些临时文件，正常情况下会自动清理，但有时候可能会有遗留。可以写个简单的脚本定期清理：

#!/bin/bash
find /data/minio/.minio.sys/tmp -type f -mtime +1 -delete

安全配置建议

安全方面有几个地方需要注意。

首先是访问控制，生产环境一定不要使用默认的用户名密码。而且建议定期更换密码，MinIO支持在线更换管理员密码。

其次是网络安全，如果MinIO服务暴露在公网上，强烈建议配置HTTPS。可以使用Let's Encrypt的免费证书，或者自签名证书。

在Debian 12上安装certbot很简单：

apt install certbot -y
certbot certonly --standalone -d your-domain.com

配置HTTPS需要修改启动参数：

MINIO_OPTS="--console-address :9001 --certs-dir /etc/minio/certs"

然后把证书文件放到指定目录：

mkdir -p /etc/minio/certs
cp /etc/letsencrypt/live/your-domain.com/privkey.pem /etc/minio/certs/private.key
cp /etc/letsencrypt/live/your-domain.com/fullchain.pem /etc/minio/certs/public.crt
chown -R minio-user:minio-user /etc/minio/certs

另外就是访问日志的记录和分析。MinIO可以配置访问日志，记录所有的API调用，这对安全审计很有用：

export MINIO_AUDIT_WEBHOOK_ENABLE=on
export MINIO_AUDIT_WEBHOOK_ENDPOINT=http://your-log-server/webhook

容量规划和扩展

随着数据量的增长，容量规划变得越来越重要。

MinIO提供了一些工具来监控存储使用情况。通过Web界面可以看到每个桶的大小和对象数量，也可以通过API获取详细信息：

mc admin info myminio

当存储空间不足时，单机版MinIO的扩展选项比较有限。可以添加更多的磁盘，或者迁移到更大的存储设备。

如果数据量真的很大，还是建议考虑集群部署。MinIO的分布式模式可以很好地处理PB级别的数据，而且支持在线扩容。

我之前参与过一个项目，数据量从几TB增长到几十TB，最后不得不从单机版迁移到4节点集群。迁移过程虽然有点复杂，但MinIO提供的工具还是很好用的。

故障处理经验

运维过程中难免会遇到各种问题，分享几个我遇到过的典型故障和处理方法。

有一次服务器突然断电，重启后MinIO无法启动，报错说数据目录损坏。这种情况下不要慌，MinIO有一定的自修复能力。先检查磁盘是否有问题：

fsck /dev/sdb1

如果磁盘没问题，可以尝试使用MinIO的修复工具：

minio server /data/minio --heal

还有一次是磁盘空间满了，导致上传失败。这种情况比较好处理，清理一些不必要的文件或者扩展存储空间就行。但要注意的是，MinIO需要一定的剩余空间来进行内部操作，建议至少保留10%的空闲空间。

网络问题也比较常见，特别是在集群环境中。如果发现节点间通信异常，首先检查网络连通性：

telnet node2 9000

然后检查防火墙设置，确保所有必要的端口都已开放。

性能调优实战

经过一段时间的使用，我发现MinIO的性能还有不少优化空间。

操作系统层面的优化很重要。比如调整文件描述符限制，在Debian 12上可以这样配置：

echo "minio-user soft nofile 65536" >> /etc/security/limits.conf
echo "minio-user hard nofile 65536" >> /etc/security/limits.conf

磁盘I/O调度算法也可以优化，对于SSD建议使用mq-deadline或none：

echo mq-deadline > /sys/block/sdb/queue/scheduler

MinIO本身也有一些调优参数。比如可以调整并发连接数：

export MINIO_API_REQUESTS_MAX=1600

还可以优化内存使用：

export MINIO_CACHE_DRIVES="/tmp/cache1,/tmp/cache2"
export MINIO_CACHE_EXCLUDE="*.pdf"

这些优化的效果因环境而异，建议在测试环境中验证后再应用到生产环境。

数据迁移的一些心得

如果你现在用的是其他存储方案，想迁移到MinIO，有几个地方需要注意。

首先是数据格式的兼容性。如果原来用的是文件系统存储，迁移到对象存储需要重新组织数据结构。建议提前规划好桶和对象的命名规则。

迁移工具的选择也很重要。MinIO提供的mc工具功能很强大，支持多种数据源：

# 从文件系统迁移
mc mirror /local/path myminio/bucket-name

# 从其他S3兼容存储迁移
mc mirror s3-source/bucket myminio/bucket-name

大数据量迁移时要注意带宽限制，可以使用mc的限速功能：

mc mirror --limit-upload 100MB /local/path myminio/bucket-name

还有就是迁移过程中的数据一致性问题。建议在业务低峰期进行迁移，或者采用分批迁移的方式，降低对业务的影响。

Debian 12特有的一些配置

在Debian 12上部署MinIO，有几个地方和其他发行版不太一样。

Debian 12默认使用systemd-resolved作为DNS解析器，如果你的MinIO集群使用域名进行节点发现，可能需要调整DNS配置：

systemctl status systemd-resolved

另外，Debian 12的默认文件系统是ext4，但如果你要存储大量小文件，可以考虑使用XFS：

apt install xfsprogs -y
mkfs.xfs /dev/sdb1

还有就是内核参数的调优，Debian 12的内核版本比较新，支持一些新的优化选项：

echo 'vm.dirty_ratio = 15' >> /etc/sysctl.conf
echo 'vm.dirty_background_ratio = 5' >> /etc/sysctl.conf
sysctl -p

监控和告警配置

生产环境中，监控和告警是必不可少的。MinIO提供了丰富的监控接口，可以很方便地集成到现有的监控系统中。

如果你用的是Prometheus + Grafana的监控方案，可以直接使用MinIO的metrics接口：

curl http://localhost:9000/minio/v2/metrics/cluster

也可以安装专门的MinIO监控工具，比如MinIO Console：

wget https://github.com/minio/console/releases/latest/download/console-linux-amd64
chmod +x console-linux-amd64
mv console-linux-amd64 /usr/local/bin/console

对于关键指标的告警，可以写一些简单的脚本定期检查：

#!/bin/bash
DISK_USAGE=$(df /data/minio | awk 'NR==2 {print $5}' | sed 's/%//')
if [ $DISK_USAGE -gt 80 ]; then
    echo "警告：MinIO存储空间使用率已达到 ${DISK_USAGE}%"
    # 这里可以添加邮件通知或其他告警逻辑
fi

MinIO真的是一个很不错的开源存储解决方案，无论是从功能完整性、性能表现还是生态丰富度来看，都达到了企业级应用的标准。当然，任何技术都不是银弹，选择存储方案还是要结合自己的实际需求。

如果你的团队正在寻找一个可靠、高性能、成本可控的对象存储解决方案，MinIO绝对值得考虑。它不仅能满足当前的需求，还有很好的扩展性，可以随着业务的发展而成长。

最后想说的是，开源软件的魅力就在于此，你不仅可以免费使用，还可以根据自己的需求进行定制和优化。MinIO的社区也很活跃，遇到问题基本都能找到解决方案。

好了，今天的分享就到这里。如果你在使用MinIO的过程中遇到什么问题，或者有什么心得体会，欢迎在评论区交流讨论。技术这东西就是要多实践多交流，才能不断进步。

如果这篇文章对你有帮助，别忘了点赞转发支持一下！想了解更多运维实战经验和技术干货，记得关注微信公众号@运维躬行录，领取学习大礼包！！！我会持续分享更多接地气的运维知识和踩坑经验。让我们一起在运维这条路上互相学习，共同进步！
公众号：运维躬行录
个人博客：躬行笔记

标签: none