yoyowallet/minio

Minio 快速入门指南

镜像概述和主要用途

Minio是一个基于Apache License v2.0协议发布的对象存储服务器，兼容Amazon S3云存储服务。它轻量级设计，可与NodeJS、Redis和MySQL等应用栈捆绑使用，特别适合存储非结构化数据，如照片、视频、日志文件、备份以及容器/VM镜像，支持对象大小从几KB到最大5TB。

核心功能和特性

• S3兼容性：完全兼容Amazon S3 API，可无缝集成现有S3工具和应用
• 轻量级部署：体积小，易于集成到应用栈中
• 跨平台支持：支持GNU/Linux、Apple OS X、Microsoft Windows、FreeBSD及Docker容器
• 灵活存储：支持存储各类非结构化数据，单对象最大可达5TB
• 多访问方式：提供Web浏览器界面、命令行客户端（mc）及多种语言SDK

使用场景和适用范围

• 存储照片、视频等媒体文件
• 保存应用日志和系统备份数据
• 托管容器镜像和虚拟机镜像
• 构建私有云存储解决方案
• 开发/测试环境中的对象存储服务

详细使用方法和配置说明

下载与安装

支持的平台

Homebrew安装（macOS）

sh
$ brew install minio
$ minio --help

源码安装（开发者适用）

需先配置Golang环境，然后执行：

sh
$ go get -u github.com/minio/minio

Docker容器部署

拉取镜像

sh
$ docker pull minio/minio

运行容器

sh
$ docker run -p 9000:9000 minio/minio

详细Docker部署指南：Minio Docker快速入门

运行Minio服务器

以下示例将Photos目录作为对象存储根目录：

GNU/Linux

sh
$ chmod +x minio
$ ./minio --help
$ ./minio server ~/Photos

Endpoint:  http://10.0.0.10:9000  http://127.0.0.1:9000  http://172.17.0.1:9000
AccessKey: USWUXHGYZQYFYFFIT3RE
SecretKey: MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03
Region:    us-east-1

Browser Access:
   http://10.0.0.10:9000  http://127.0.0.1:9000  http://172.17.0.1:9000

Command-line Access: https://docs.minio.io/docs/minio-client-quickstart-guide
   $ mc config host add myminio http://10.0.0.10:9000 USWUXHGYZQYFYFFIT3RE MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03

Object API (Amazon S3 compatible):
   Go:         https://docs.minio.io/docs/golang-client-quickstart-guide
   Java:       https://docs.minio.io/docs/java-client-quickstart-guide
   Python:     https://docs.minio.io/docs/python-client-quickstart-guide
   JavaScript: https://docs.minio.io/docs/javascript-client-quickstart-guide

Apple OS X

sh
$ chmod 755 minio
$ ./minio --help
$ ./minio server ~/Photos
# 输出内容与GNU/Linux相同

Microsoft Windows

sh
C:\Users\Username\Downloads> minio.exe --help
C:\Users\Username\Downloads> minio.exe server D:\Photos
# 输出内容类似，命令行访问使用mc.exe

FreeBSD

sh
$ chmod 755 minio
$ ./minio --help
$ ./minio server ~/Photos
# 输出内容与GNU/Linux相同

测试Minio服务器

使用Minio浏览器

打开Web浏览器访问 [***] 即可查看存储桶。

!https://github.com/minio/minio/blob/master/docs/screenshots/minio-browser.jpg?raw=true

使用mc客户端

1. 从Minio客户端快速入门安装mc
2. 配置服务器连接：

sh
$ mc config host add myminio http://10.0.0.10:9000 USWUXHGYZQYFYFFIT3RE MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03

3. 创建并列出存储桶：

sh
$ mc mb myminio/mybucket
$ mc ls myminio/
[2015-08-05 08:13:11 IST]     0B mybucket/

更多操作示例见Minio客户端完整指南

进一步探索

• Minio纠删码快速入门
• Minio Docker快速入门
• 使用mc客户端
• 使用aws-cli访问
• 使用s3cmd工具
• Minio Go SDK使用

贡献到Minio项目

请遵循https://github.com/minio/minio/blob/master/CONTRIBUTING.md