Docker 安裝Minio 設(shè)置免token下載
安裝
MinIO 是一個(gè)基于Apache License v2.0開源協(xié)議的對(duì)象存儲(chǔ)服務(wù)。MinIO是一個(gè)非常輕量的服務(wù),可以很簡(jiǎn)單的和其他應(yīng)用的結(jié)合,類似 NodeJS, Redis 或者 MySQL
-
拉取docker鏡像
docker pull minio/minio -
運(yùn)行鏡像
docker run -p 9000:9000 \ --name minio1 \ -v /mnt/data:/data \ -e "MINIO_ROOT_USER=admin" \ -e "MINIO_ROOT_PASSWORD=123465" \ minio/minio server /data命令說明:將minio/minio鏡像別名成minio1運(yùn)行9000端口并映射到物理機(jī)上,并設(shè)置minio的用戶名和密碼(用于上傳登錄)
如果以上命令成功,可以使用下列檢驗(yàn):
查看日志:
docker logs -f minio1登錄web端:
http://192.168.1.12:9000/,賬號(hào)密碼就是上面設(shè)置的那個(gè)上傳文件:點(diǎn)擊右下角的加號(hào)---->create bucket(創(chuàng)建桶)-----> upload file(上傳文件)
使用
下面主要提供java使用例子
新建一個(gè)spring boot 工程
-
引入pom
<dependency> <groupId>io.minio</groupId> <artifactId>minio</artifactId> <version>7.1.0</version> </dependency> -
建立上傳的controller
@PostMapping("/upload") @ResponseBody public String upload(@RequestParam("file") MultipartFile file) throws Exception{ // 創(chuàng)建連接對(duì)象 MinioClient minioClient = MinioClient.builder() .endpoint("http://192.168.1.12:9000") .credentials("admin","12345") .build(); // 前面創(chuàng)建桶的名稱 String bucketName = "public"; // 原文件名 String fileName = file.getOriginalFilename(); // 文件類型 String suffixName = fileName.substring(fileName.lastIndexOf(".")); // 生成新文件名,確保唯一性 String objectName = UUID.randomUUID().toString() + suffixName; // 文件類型 // 使用putObject上傳一個(gè)文件到存儲(chǔ)桶中 minioClient.putObject( PutObjectArgs.builder() .bucket(bucketName) .object(objectName) .stream(file.getInputStream(),-1,10485760) .build()); // 得到文件 url String imageUrl = minioClient.getObjectUrl(bucketName, objectName); // 生成下載鏈接 return imageUrl; }需要填寫的參數(shù):minio的地址、驗(yàn)證信息、桶名稱。
最后返回的就是下載地址。
使用postman或者swagger上傳文件。返回資源的下載地址后,你會(huì)發(fā)現(xiàn),并沒辦法下載,因?yàn)檫@時(shí)候需要驗(yàn)證!!下面我們需要設(shè)置對(duì)應(yīng)的桶進(jìn)行免登陸下載
設(shè)置桶的policy【windows環(huán)境下】
不同的桶需要設(shè)置不同的權(quán)限范圍,這里我們需要使用一個(gè)客戶端工具minioclient。【windows環(huán)境下】
-
下載mc.exe
https://dl.min.io/client/mc/release/windows-amd64/mc.exe -
運(yùn)行mc.exe。在下載好的文件夾,打開bash工具
./mc.exe也可以將對(duì)應(yīng)文件夾添加到環(huán)境變量,就可以直接使用mc命令了。
運(yùn)行完成可以看到以下信息
Name: mc.exe policy - manage anonymous access to buckets and objects USAGE: mc.exe policy [FLAGS] set PERMISSION TARGET mc.exe policy [FLAGS] set-json FILE TARGET mc.exe policy [FLAGS] get TARGET mc.exe policy [FLAGS] get-json TARGET mc.exe policy [FLAGS] list TARGET -
添加對(duì)應(yīng)的minio服務(wù)端
./mc.exe alias set myminio/ http://192.168.1.12:9000 admin 123465命令說明:
添加服務(wù)地址為:
http://192.168.1.12:9000,用戶名和密碼:admin 12345的minio服務(wù),并別名成:myminio,這里非常關(guān)鍵!!以后設(shè)置規(guī)則都是用myminio這個(gè)前綴設(shè)置??!所以你發(fā)現(xiàn)復(fù)制了網(wǎng)上的命令都設(shè)置失敗的原因??! -
針對(duì)對(duì)應(yīng)的桶設(shè)置成免token下載
./mc.exe policy set download myminio/public執(zhí)行成功則顯示:
Access permission for `myminio/public` is set to `download`這樣,我們就可以直接使用資源地址進(jìn)行下載了?。?/p>
資源對(duì)應(yīng)的下載地址就是:地址+桶名+文件名:
比如:
http://192.168.1.12:9000/public/6bf0aa56-b1df-407f-b740-3ab41cad87e1.jpg
錯(cuò)誤提示
-
在使用sdk的時(shí)候,提示
valid part size must be provided when object size is unknown上傳的時(shí)候必須設(shè)置分塊大小。對(duì)象大小直接-1,分塊大小[5m,5G],參數(shù)的單位是B,所以最小單位是:5 * 1024 * 1024 = 5242880。minio支持分塊傳輸,按照下面創(chuàng)建即可
PutObjectArgs.builder() .bucket(bucketName) .object(objectName) .stream(file.getInputStream(),-1,5242880) .build()下面的minio說明
/** * Sets stream to upload. Two ways to provide object/part sizes. * * <ul> * <li>If object size is unknown, pass -1 to objectSize and pass valid partSize. * <li>If object size is known, pass -1 to partSize for auto detect; else pass valid partSize * to control memory usage and no. of parts in upload. * <li>If partSize is greater than objectSize, objectSize is used as partSize. * </ul> * * <p>A valid part size is between 5MiB to 5GiB (both limits inclusive). */ -
設(shè)置policy的時(shí)候提示:
<ERROR> Incorrect number of arguments for alias set command. Invalid arguments provided, please refer `mc <command> -h` for relevant documentation.這個(gè)應(yīng)該就是桶寫錯(cuò)了,或者minio的服務(wù)別名寫錯(cuò)!!
附錄
不同的規(guī)則說明:
1. Set bucket to "download" on Amazon S3 cloud storage.
C:\> mc.exe policy set download s3/burningman2011
2. Set bucket to "public" on Amazon S3 cloud storage.
C:\> mc.exe policy set public s3/shared
3. Set bucket to "upload" on Amazon S3 cloud storage.
C:\> mc.exe policy set upload s3/incoming
4. Set policy to "public" for bucket with prefix on Amazon S3 cloud storage.
C:\> mc.exe policy set public s3/public-commons/images
5. Set a custom prefix based bucket policy on Amazon S3 cloud storage using a JSON file.
C:\> mc.exe policy set-json /path/to/policy.json s3/public-commons/images
6. Get bucket permissions.
C:\> mc.exe policy get s3/shared
7. Get bucket permissions in JSON format.
C:\> mc.exe policy get-json s3/shared
8. List policies set to a specified bucket.
C:\> mc.exe policy list s3/shared
9. List public object URLs recursively.
C:\> mc.exe policy --recursive links s3/shared/