Linux 单机 MinIO:安装、systemd 与对象读写验证
整理单机 MinIO 的安装和服务管理,修正命令拼写、启动参数与清理说明,补充二进制路径和对象读写验证。
明确版本、安装来源与单机范围
原记录引用了 2025 年的 MinIO RPM。这里保留“单机安装与 systemd 管理”的主题,但不再把某个历史下载链接称为当前官方推荐。社区版本与商业产品文档可能不同,必须先核对实际产品、版本、许可和安装包来源。
单机适合学习和受控验证,不应据此宣称已经具备多节点容错能力。应用也不应长期使用管理账户访问所有对象。
1. 核对已安装的二进制
按所选版本的发行说明安装之后,执行:
command -v minio
minio --version
minio server --help
原文的 mino --version 拼写有误,本次已修正。如果使用 RPM,可结合包管理器的文件清单核对路径,不应假定二进制总是在 /usr/local/bin/minio。
2. 使用独立运行账户和数据目录
以下展示目标布局,不是已在服务器执行的变更:运行账户为 minio-user,数据目录为 /srv/minio/data,配置文件为 /etc/default/minio。账户需要读写数据目录,但不必获得无关目录权限。
sudo install -d -o minio-user -g minio-user -m 750 /srv/minio/data
执行前应确认账户已创建。不要对整个系统路径递归修改权限来解决一个数据目录访问问题。
MINIO_ROOT_USER="REPLACE_WITH_ADMIN_NAME"
MINIO_ROOT_PASSWORD="REPLACE_WITH_STRONG_PASSWORD"
MINIO_VOLUMES="/srv/minio/data"
MINIO_OPTS="--address :9000 --console-address :9002"
--console-address 与参数值之间需要正确分隔,原文的 --console-address:9002 已修正。真实凭据只放在访问受限的配置中;不要把占位符原样用于公开服务。
3. systemd 配置要匹配实际安装
若安装包已经提供服务单元,优先阅读该单元并通过适当的 override 调整,不要直接覆盖包管理器维护的全部文件。需要自行配置时,下列片段中的二进制路径必须替换成实际路径:
[Unit]
Description=MinIO single-node example
Wants=network-online.target
After=network-online.target
[Service]
User=minio-user
Group=minio-user
EnvironmentFile=/etc/default/minio
ExecStart=/ABSOLUTE/PATH/minio server $MINIO_OPTS $MINIO_VOLUMES
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
这是有意保留占位路径的示意配置,不应未经核对就启动。日志中若显示无法执行文件或目录权限错误,应先定位路径和账户,不要反复重启掩盖原因。
sudo systemctl daemon-reload
sudo systemctl start minio
systemctl status minio
journalctl -u minio --no-pager -n 100
4. 验证对象能力,而不只验证控制台
使用受控测试桶上传一个小文件,下载后比较摘要;重启服务再重复下载,确认数据目录配置正确。将管理凭据与应用访问凭据分开,并确认应用只具有所需桶和操作的权限。
5. 卸载与删除对象数据分开进行
原文把卸载软件与递归删除数据目录放在同一流程,本次移除了这些删除命令。停止服务、卸载程序、保留或销毁对象数据是三个不同决定。需要迁移时,应先检查备份可读取,再处理服务与包。
来源与参考
- 原转载来源
- MinIO 项目
- 原文引用的 AIStor 文档入口 属于具体产品文档,应与实际安装产品核对。