SpringCloud--FastDFS原理及使用

FastDFS简介

为什么

在分布式集群环境下，文件上传至节点A，这时通过负载均衡算法，访问到节点B，则不能访问到文件，这时会出现有时能访问有时不能访问的问题

同时要考虑为文件做冗余备份、负载均衡、线性扩容等功能，这些都是单节点文件上传所不具备的

FastDFS体系结构

FastDFS是一个开源的轻量级[分布式文件系统]，它对文件进行管理，功能包括：文件存储、文件同步、文件访问（文件上传、文件下载）等，解决了大容量存储和负载均衡的问题。特别适合以文件为载体的在线服务，如相册网站、视频网站等等。

FastDFS为互联网量身定制，充分考虑了冗余备份、负载均衡、线性扩容等机制，并注重高可用、高性能等指标，使用FastDFS很容易搭建一套高性能的文件服务器集群提供文件上传、下载等服务。

FastDFS 架构包括 Tracker server 和 Storage server。客户端请求 Tracker server 进行文件上传、下载，通过 Tracker server 调度最终由 Storage server 完成文件上传和下载。

Tracker server 作用是负载均衡和调度，通过 Tracker server 在文件上传时可以根据一些策略找到Storage server 提供文件上传服务。可以将 tracker 称为追踪服务器或调度服务器。Storage server 作用是文件存储，客户端上传的文件最终存储在 Storage 服务器上，Storageserver 没有实现自己的文件系统而是利用操作系统的文件系统来管理文件。可以将storage称为存储服务器。

上传流程

客户端上传文件后存储服务器将文件 ID 返回给客户端，此文件 ID 用于以后访问该文件的索引信息。文件索引信息包括：组名，虚拟磁盘路径，数据两级目录，文件名。

组名：文件上传后所在的 storage 组名称，在文件上传成功后有storage 服务器返回，需要客户端自行保存。虚拟磁盘路径：storage 配置的虚拟路径，与磁盘选项store_path*对应。如果配置了

store_path0 则是 M00，如果配置了 store_path1 则是 M01，以此类推。

数据两级目录：storage 服务器在每个虚拟磁盘路径下创建的两级目录，用于存储数据文件。

文件名：与文件上传时不同。是由存储服务器根据特定信息生成，文件名包含：源存储服务器 IP 地址、文件创建时间戳、文件大小、随机数和文件拓展名等信息。

FastDFS安装

我们使用Docker安装FastDFS

拉取镜像

docker pull morunchang/fastdfs

运行tracker

docker run -d --name tracker --net=host morunchang/fastdfs sh tracker.sh

运行storage

docker run -d --name storage --net=host -e TRACKER_IP=:22122 -e GROUP_NAME= morunchang/fastdfs sh storage.sh

docker run -d --name storage --net=host -e TRACKER_IP=192.168.220.100:22122 -e GROUP_NAME=group1 morunchang/fastdfs sh storage.sh

使用的网络模式是–net=host，host模式可以不用映射容器端口宿主机, 替换为你机器的Ip即可GROUP_NAME是组名，即storage的组如果想要增加新的storage服务器，再次运行该命令，注意更换 新组名

修改nginx的配置

进入storage的容器内部，修改nginx.conf

docker exec -it storage /bin/bash

进入后

vi /etc/nginx/conf/nginx.conf

添加以下内容（已经存在，不用改）

location ~ /M00 { root /data/fast_data/data; ngx_fastdfs_module;

}

禁止缓存：

add_header Cache-Control no-store;

（5）退出容器

exit

（6）重启storage容器

docker restart storage

查看tracker.conf和storage.conf配置文件

docker exec -it storage /bin/bash cd /etc/fdfs vim tracker.conf vim storage.conf

文件上传微服务

搭建项目

创建文件上传微服务upload-service，通过fastdfs-client组件实现文件上传和删除的功能（1）在spring cloud项目中创建子工程，修改pom.xml，引入依赖

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>lxs-springcloud</artifactId> <groupId>com.lxs</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>upload-service</artifactId> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId> </dependency> <!-- FastDFS依赖 --> <dependency> <groupId>com.github.tobato</groupId> <artifactId>fastdfs-client</artifactId> <version>1.26.7</version> </dependency> </dependencies> </project>

（2）application.yml

server: port: 9004 logging: pattern: console: "%d - %msg%n" level: org.springframewotk.web: deubg com.xzk: debug spring: application: name: upload-service servlet: multipart: enabled: true max-file-size: 10MB # 单个文件上传大小 max-request-size: 20MB # 总文件上传大小 fdfs: # 链接超时 connect-timeout: 60 # 读取时间 so-timeout: 60 # 生成缩略图参数 thumb-image: width: 150 height: 150 tracker-list: 115.159.85.200:22122 eureka: client: service-url: defaultZone: http://127.0.0.1:10086/eureka instance: # 更倾向于使用IP地址，而不是主机名 prefer-ip-address: true # ip地址 ip-address: 127.0.0.1 # 持续间隔，默认30秒 lease-renewal-interval-in-seconds: 5 #服务的失效时间，默认90秒 lease-expiration-duration-in-seconds: 5

（3）启动类UploadApplication

package com.xzk; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.client.discovery.EnableDiscoveryClient; @SpringBootApplication @EnableDiscoveryClient public class UploadApplication { public static void main(String[] args) { SpringApplication.run(UploadApplication.class, args); } }

(4) FastDfs配置类DfsConfig

package com.xzk.config; import com.github.tobato.fastdfs.FdfsClientConfig; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Import; /** * @Classname DfsConfig * @Description TODO * @Date 2020/10/20 11:22 * @Created by ccc-j * @email ccc-ju@outlook.com */ @Configuration @Import(FdfsClientConfig.class) public class DfsConfig { }

工具类FileDfsUtil

调用fastdfs-client工具方法实现文件上传和删除

package com.xzk.config; import com.github.tobato.fastdfs.domain.fdfs.StorePath; import com.github.tobato.fastdfs.service.FastFileStorageClient; import org.apache.commons.io.FilenameUtils; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Component; import org.springframework.web.multipart.MultipartFile; import java.io.IOException; /** * @Classname FileDfsUtil * @Description TODO * @Date 2020/10/20 11:24 * @Created by ccc-j * @email ccc-ju@outlook.com */ @Component public class FileDfsUtil { @Autowired private FastFileStorageClient fastFileStorageClient; /** * 上传文件 * @param multipartFile * @return * @throws IOException */ public String upload(MultipartFile multipartFile) throws IOException { String extName = FilenameUtils.getExtension(multipartFile.getOriginalFilename()); StorePath storePath = fastFileStorageClient.uploadImageAndCrtThumbImage(multipartFile.getInputStream(), multipartFile.getSize(), extName, null); return storePath.getFullPath(); //group1/M00/00/00/xxxx.jpg } /** * 删除文件 * @param fileUrl */ public void deleteFile(String fileUrl){ StorePath storePath = StorePath.parseFromUrl(fileUrl); fastFileStorageClient.deleteFile(storePath.getGroup(), storePath.getPath()); } }

FileController

package com.xzk.controller; import com.xzk.config.FileDfsUtil; import io.swagger.annotations.Api; import org.apache.commons.lang.StringUtils; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartFile; import java.io.IOException; /** * @Classname FileController * @Description TODO * @Date 2020/10/20 11:34 * @Created by ccc-j * @email ccc-ju@outlook.com */ @Api("文件上传") @RestController public class FileController { @Autowired private FileDfsUtil fileDfsUtil; /** * 上传 * @param file * @return */ @RequestMapping(value = "/uploadFile", method = RequestMethod.POST, headers = "content-type=multipart/form-data") public ResponseEntity<String> uploadFile(@RequestParam("file")MultipartFile file){ String result = ""; try { String path = fileDfsUtil.upload(file); //group0//M00/00/00/xxxx.jpg if(StringUtils.isEmpty(path)){ result = "上传失败"; }else{ result = path; } } catch (IOException e) { e.printStackTrace(); result = "服务器异常!"; } return ResponseEntity.ok(result); } /** * 删除文件 * @param filePathName "/group1/M00/00/00/xxx.jpg" * @return */ @RequestMapping(value = "/deleteByPath", method = RequestMethod.GET) public ResponseEntity<String> deleteByPath(String filePathName){ //删除大图 fileDfsUtil.deleteFile(filePathName); return ResponseEntity.ok("success delete"); } }

postman测试

上传测试 删除测试

本文具体代码已上传gitee: https://gitee.com/ccc-ju/spring-cloud-traning 本文示例仅需启动如下服务即可：

有需要参考拿来即用