ubuntu中minio如何访问
小樊
36
2025-12-20 19:18:29
Ubuntu 中访问 MinIO 的常用方式
通过浏览器访问 Web 控制台 :使用 http://<服务器IP>:9001 (推荐)或 http://<服务器IP>:9000 。新版 MinIO 将 API 与控制台分离,控制台默认端口为 9001 ,API 为 9000 。首次登录使用设置的 Access Key / Secret Key 凭证。若本机访问,也可用 http://127.0.0.1:9001 。
通过 S3 兼容 API:应用以 S3 方式访问 http://<服务器IP>:9000 ,使用 Access Key / Secret Key 进行签名请求。
通过命令行客户端 mc :在 Ubuntu 上安装 mc 后,添加别名并操作对象(见下文示例)。
前置检查与网络放行
放行防火墙端口(示例为 UFW ):
sudo ufw allow 9000
sudo ufw allow 9001
云服务器需确保安全组/防火墙对 9000/9001 入站放行。
如需外网访问,确保云厂商控制台已配置 端口转发 (如使用非标准端口)。
方式一 浏览器访问 Web 控制台
启动 MinIO(示例):
minio server /data --address :9000 --console-address :9001
在浏览器打开 http://<服务器IP>:9001 ,使用启动前设置的 MINIO_ROOT_USER / MINIO_ROOT_PASSWORD 登录。
若只能访问 9000 端口,部分版本会在该端口提供登录入口,但推荐使用 9001 控制台。
提示:首次启动时的终端输出会显示生成的 Access Key / Secret Key (若未通过环境变量预设)。
方式二 应用通过 S3 API 访问
终端测试连通性(返回 MinIO 信息即表示可达):
curl -I http://<服务器IP>:9000 /minio/health/live
应用配置要点:
Endpoint:http://<服务器IP>:9000
区域(Region):如未特别设置,可用 us-east-1
访问密钥:使用 MINIO_ROOT_USER / MINIO_ROOT_PASSWORD 或自建 IAM 用户的密钥
注意:S3 签名默认使用 Path-style (路径风格)访问,确保客户端启用该模式(多数 SDK 默认支持)。
方式三 命令行客户端 mc 访问与管理
安装 mc:
wget https://dl.min.io/client/mc/release/linux-amd64/mc
chmod +x mc && sudo mv mc /usr/local/bin/
添加别名并测试:
mc alias set myminio http://<服务器IP>:9000 <ACCESS_KEY> <SECRET_KEY>
mc ls myminio
mc mb myminio/mybucket
mc cp /path/file myminio/mybucket/remote-file
以上命令可完成桶创建、对象上传/下载等日常管理。
常见问题与排查
端口不通:检查 ufw/安全组 是否放行 9000/9001 ,并确认服务监听在 0.0.0.0 (而非仅 127.0.0.1)。
登录失败:核对 MINIO_ROOT_USER / MINIO_ROOT_PASSWORD 是否与启动命令或环境变量一致;注意新版控制台默认端口为 9001 。
仅 9000 能访问:部分旧版本或未显式指定 –console-address 时,控制台与 API 同在 9000 ;建议显式指定 :9001 以避免混淆。
生产建议:启用 HTTPS/TLS 、设置强密码与最小权限策略、限制来源 IP、定期更新版本。