MinIO 安装指南 - Linux ARM64
MinIO 安装指南 - Linux ARM64
1. 系统要求
- 操作系统：Linux (ARM64架构)
- 内存：至少2GB RAM
- 存储：根据数据存储需求准备足够的磁盘空间
- 网络：确保防火墙开放9000端口（API）和9001端口（控制台）
2. 安装前准备
2.1 创建MinIO用户和组
# 创建minio系统用户（无需登录权限）
sudo groupadd -r minio
sudo useradd -M -r -g minio minio
2.2 创建必要的目录
# 创建数据存储目录
sudo mkdir -p /files/tools/minio/data
sudo chown -R minio:minio /files/tools/minio/data# 创建配置文件目录
sudo mkdir -p /files/tools/minio
sudo chown -R minio:minio /files/tools/minio# 创建日志目录
sudo mkdir -p /files/tools/minio/log
sudo chown -R minio:minio /files/tools/minio/log
3. 安装MinIO
由于您已经下载了MinIO二进制文件，我们继续配置：
3.1 配置MinIO二进制文件
# 确保minio二进制文件有执行权限
sudo chmod +x /files/tools/minio/minio
sudo chown minio:minio /files/tools/minio/minio# 验证安装
/files/tools/minio/minio --version
3.2 如果需要重新下载（可选）
# 下载最新的ARM64版本到MinIO目录
cd /files/tools/minio/
wget https://dl.min.io/server/minio/release/linux-arm64/minio
chmod +x minio
sudo chown minio:minio minio
4. 配置MinIO
4.1 创建环境配置文件
sudo vim /files/tools/minio/minio.conf
添加以下内容：
# MinIO配置文件# MinIO访问密钥（用户名）- 至少3个字符
MINIO_ROOT_USER="minioadmin"# MinIO密钥（密码）- 至少8个字符
MINIO_ROOT_PASSWORD="minioadmin123"# MinIO数据目录
MINIO_VOLUMES="/files/tools/minio/data"# MinIO监听地址和端口
MINIO_ADDRESS=":9000"# MinIO控制台地址和端口
MINIO_CONSOLE_ADDRESS=":9001"# 区域设置（可选）
MINIO_REGION="cn-north-1"# 启用浏览器访问
MINIO_BROWSER="on"# 日志配置
MINIO_LOG_DIR="/files/tools/minio/log"
4.2 设置权限
sudo chmod 600 /files/tools/minio/minio.conf
sudo chown minio:minio /files/tools/minio/minio.conf
5. 创建Systemd服务
5.1 创建服务文件
sudo vim /etc/systemd/system/minio.service
添加以下内容：
[Unit]
Description=MinIO Object Storage Server
Documentation=https://docs.min.io
After=network-online.target
Wants=network-online.target[Service]
Type=notify
WorkingDirectory=/files/tools/minio/data
User=minio
Group=minio# 环境配置文件
EnvironmentFile=/files/tools/minio/minio.conf# 启动命令
ExecStart=/files/tools/minio/minio server $MINIO_VOLUMES --address $MINIO_ADDRESS --console-address $MINIO_CONSOLE_ADDRESS# 重启策略
Restart=on-failure
RestartSec=5# 系统限制
LimitNOFILE=65536
LimitNPROC=4096# 安全设置
PrivateTmp=true
ProtectSystem=full
NoNewPrivileges=true
PrivateDevices=true
ProtectHome=true# 标准输出和错误输出
StandardOutput=journal
StandardError=journal# 关闭时发送SIGTERM信号
KillSignal=SIGTERM
SendSIGKILL=no
SuccessExitStatus=0[Install]
WantedBy=multi-user.target
5.2 重新加载systemd配置
sudo systemctl daemon-reload
6. 启动和管理MinIO
6.1 启动MinIO服务
# 启动服务
sudo systemctl start minio# 设置开机自启动
sudo systemctl enable minio# 查看服务状态
sudo systemctl status minio
6.2 查看日志
# 查看实时日志
sudo journalctl -u minio -f# 查看最近的日志
sudo journalctl -u minio -n 100
7. 防火墙配置
7.1 开放端口（如果使用firewalld）
sudo firewall-cmd --permanent --add-port=9000/tcp
sudo firewall-cmd --permanent --add-port=9001/tcp
sudo firewall-cmd --reload
7.2 开放端口（如果使用ufw）
sudo ufw allow 9000/tcp
sudo ufw allow 9001/tcp
sudo ufw reload
7.3 开放端口（如果使用iptables）
# 开放9000和9001端口
sudo iptables -A INPUT -p tcp --dport 9000 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 9001 -j ACCEPT# 保存iptables规则（根据系统不同选择一种方式）
# 方法1：Ubuntu/Debian
sudo iptables-save > /etc/iptables/rules.v4# 方法2：CentOS/RHEL
sudo service iptables save# 方法3：通用方式（需要安装iptables-persistent）
sudo apt-get install iptables-persistent -y
sudo netfilter-persistent save
7.5 如果遇到连接问题
# 检查端口是否开放
sudo netstat -tulnp | grep -E '9000|9001'# 检查防火墙规则
sudo iptables -L -n --line-numbers | grep -E '9000|9001'# 临时关闭防火墙测试（不推荐生产环境）
sudo systemctl stop firewalld # firewalld
sudo ufw disable # ufw
sudo iptables -F # iptables
8. 访问MinIO
8.1 访问方式
- API端点: http://服务器IP:9000
- Web控制台: http://服务器IP:9001
8.2 登录凭证
- 用户名：minioadmin（在配置文件中设置的MINIO_ROOT_USER）
- 密码：minioadmin123（在配置文件中设置的MINIO_ROOT_PASSWORD）
9. MinIO客户端工具（mc）安装
9.1 下载并安装mc
# 下载ARM64版本的mc到MinIO目录
cd /files/tools/minio/
wget https://dl.min.io/client/mc/release/linux-arm64/mc
chmod +x mc
sudo chown minio:minio mc# 验证安装
/files/tools/minio/mc --version# 创建软链接（可选，方便使用）
sudo ln -s /files/tools/minio/mc /usr/local/bin/mc
9.2 配置mc连接到MinIO
# 添加MinIO服务器配置
mc alias set myminio http://localhost:9000 minioadmin minioadmin123# 测试连接
mc admin info myminio
10. 常用操作示例
注意：新版Minio以无法通过UI界面修改桶权限，相关操作只能通过mc命令去执行
10.1 创建存储桶
# 使用mc创建存储桶
mc mb myminio/mybucket# 列出所有存储桶
mc ls myminio
10.2 上传文件
# 上传单个文件
mc cp /path/to/file myminio/mybucket# 上传整个目录
mc cp --recursive /path/to/directory myminio/mybucket
10.3 设置存储桶策略
# 设置存储桶为公开读取
mc anonymous set public myminio/mybucket# 设置存储桶为私有
mc anonymous set private myminio/mybucket
11. 性能优化建议
11.1 系统优化
# 增加系统文件描述符限制
echo "* soft nofile 65536" | sudo tee -a /etc/security/limits.conf
echo "* hard nofile 65536" | sudo tee -a /etc/security/limits.conf# 优化网络参数
sudo sysctl -w net.core.rmem_max=134217728
sudo sysctl -w net.core.wmem_max=134217728
11.2 MinIO配置优化
在/files/tools/minio/minio.conf中添加：
# 设置并发连接数
MINIO_API_REQUESTS_MAX=1000# 设置请求超时时间
MINIO_API_REQUESTS_DEADLINE="30s"
12. 备份和恢复
12.1 备份MinIO数据
# 使用mc镜像功能备份
mc mirror --overwrite myminio/mybucket /backup/mybucket# 使用rsync备份数据目录
sudo rsync -avz /files/tools/minio/data/ /backup/minio/
12.2 恢复数据
# 恢复存储桶数据
mc mirror --overwrite /backup/mybucket myminio/mybucket# 恢复整个数据目录
sudo rsync -avz /backup/minio/ /files/tools/minio/data/
sudo chown -R minio:minio /files/tools/minio/data
13. 监控和维护
查看服务器信息
# 查看服务器状态
mc admin info myminio# 查看磁盘使用情况
mc admin disk info myminio
14. 故障排除
14.1 服务无法启动
# 检查服务状态和错误信息
sudo systemctl status minio
sudo journalctl -u minio -n 50# 检查端口占用
sudo netstat -tlnp | grep -E '9000|9001'# 检查权限问题
ls -la /files/tools/minio/data
ls -la /files/tools/minio/minio.conf
14.2 连接问题
# 测试端口连通性
telnet localhost 9000
telnet localhost 9001# 检查防火墙规则
sudo iptables -L -n | grep -E '9000|9001'
14.3 重置管理员密码
# 停止MinIO服务
sudo systemctl stop minio# 修改配置文件中的密码
sudo nano /files/tools/minio/minio.conf# 重启服务
sudo systemctl start minio
附录：常见配置示例
A.1 多磁盘配置
# 在minio.conf中配置多个磁盘
MINIO_VOLUMES="/files/tools/minio/data1 /files/tools/minio/data2 /files/tools/minio/data3 /files/tools/minio/data4"
A.2 集群模式配置
# 配置分布式MinIO（4节点示例）
MINIO_VOLUMES="http://node{1...4}/files/tools/minio/data"
A.3 启用TLS/SSL
# 将证书文件放置在以下位置
/files/tools/minio/certs/public.crt
/files/tools/minio/certs/private.key# MinIO会自动检测并启用HTTPS