FastDFS配置以及java操作
综合介绍
内容介绍
FastDFS是由淘宝的余庆先生所开发，是一个轻量级、高性能的开源分布式文件系统，用纯C语言开发，包括文件存储、文件同步、文件访问（上传、下载）、存取负载均衡、在线扩容、相同内容只存储一份等功能，适合有大容量存储需求的应用或系统。做分布式系统开发时，其中要解决的一个问题就是图片、音视频、文件共享的问题，分布式文件系统正好可以解决这个需求。同类的分布式文件系统有谷歌的GFS、HDFS（Hadoop）、TFS（淘宝）等。
源码开放下载地址：https://github.com/happyfish100
FastDFS系统架构：
[外链图片转存失败(img-lz8srEnk-1563207367763)(mdpic/xitongjiagou.jpg)]
FastDFS文件上传流程：
[外链图片转存失败(img-JbhDKtzj-1563207367764)(mdpic/shangchuanliucheng.jpg)]
- client询问tracker上传到的storage，不需要附加参数；
- tracker返回一台可用的storage；
- client直接和storage通讯完成文件上传。
FastDFS文件下载流程:
[外链图片转存失败(img-wZ8ri0Sm-1563207367765)(mdpic/xiazailiucheng.jpg)]
- client询问tracker下载文件的storage，参数为文件标识（组名和文件名）；
- tracker返回一台可用的storage；
- client直接和storage通讯完成文件下载。
术语
FastDFS两个主要的角色：Tracker Server 和 Storage Server
Tracker Server：跟踪服务器，主要负责调度storage节点与client通信，在访问上起负载均衡的作用，和记录storage节点的运行状态，是连接client和storage节点的枢纽。
Storage Server：存储服务器，保存文件和文件的meta data（元数据）
Group：文件组，也可以称为卷。同组内服务器上的文件是完全相同的，做集群时往往一个组会有多台服务器，上传一个文件到同组内的一台机器上后，FastDFS会将该文件即时同步到同组内的其它所有机器上，起到备份的作用。
meta data：文件相关属性，键值对（Key Value Pair）方式，如：width=1024, height=768。和阿里云OSS的meta data相似。
FastDFS单节点安装
服务器规划：
跟踪服务器（Tracker Server）：10.0.31.189
存储服务器（Storage Server）：10.0.31.189
操作系统：CentOS6.8
用户：root
数据存储目录：/fastdfs
安装包：
fastdfs-master-V5.05.zip：FastDFS源码
libfastcommon-master.zip：（从 FastDFS 和 FastDHT 中提取出来的公共 C 函数库）
fastdfs-nginx-module-master.zip：storage节点http服务nginx模块
nginx-1.10.0.tar.gz：Nginx安装包
下载完成后，将压缩包解压到/usr/local目录下
一、所有tracker和storage节点都执行如下操作(单节点就一个,多节点都执行)
1、安装所需的依赖包
[root@localhost ~]# yum install make cmake gcc gcc-c++ perl
2、安装libfatscommon
[root@localhost ~]# cd /usr/local
[root@localhost local]# unzip libfastcommon-master.zip
[root@localhost local]# cd libfastcommon-master
[root@localhost libfastcommon-master]# ll
总用量 36
drwxr-xr-x. 2 root root 4096 7月 6 2017 doc
-rw-r--r--. 1 root root 8005 7月 6 2017 HISTORY
-rw-r--r--. 1 root root 566 7月 6 2017 INSTALL
-rw-r--r--. 1 root root 1607 7月 6 2017 libfastcommon.spec
-rwxr-xr-x. 1 root root 3099 7月 6 2017 make.sh
drwxr-xr-x. 2 root root 4096 7月 6 2017 php-fastcommon
-rw-r--r--. 1 root root 2763 7月 6 2017 README
drwxr-xr-x. 3 root root 4096 9月 28 2017 src
####编译、安装
[root@localhost libfastcommon-master]# ./make.sh
[root@localhost libfastcommon-master]# ./make.sh install
3、安装FastDFS
[root@localhost ~]# cd /usr/local
[root@localhost local]# unzip fastdfs-master.zip
[root@localhost local]# cd fastdfs-master
[root@localhost fastdfs-master]# ll
总用量 136
drwxr-xr-x. 3 root root 4096 9月 28 2017 client
drwxr-xr-x. 2 root root 4096 9月 28 2017 common
drwxr-xr-x. 2 root root 4096 8月 10 2017 conf
-rw-r--r--. 1 root root 35067 8月 10 2017 COPYING-3_0.txt
-rw-r--r--. 1 root root 3171 8月 10 2017 fastdfs.spec
-rw-r--r--. 1 root root 33207 8月 10 2017 HISTORY
drwxr-xr-x. 2 root root 4096 8月 10 2017 init.d
-rw-r--r--. 1 root root 7755 8月 10 2017 INSTALL
-rwxr-xr-x. 1 root root 5548 8月 10 2017 make.sh
drwxr-xr-x. 2 root root 4096 8月 10 2017 php_client
-rw-r--r--. 1 root root 2380 8月 10 2017 README.md
-rwxr-xr-x. 1 root root 1768 8月 10 2017 restart.sh
-rwxr-xr-x. 1 root root 1680 8月 10 2017 stop.sh
drwxr-xr-x. 4 root root 4096 9月 28 2017 storage
drwxr-xr-x. 2 root root 4096 8月 10 2017 test
drwxr-xr-x. 2 root root 4096 9月 28 2017 tracker
## 编译、安装
[root@localhost fastdfs-master]# ./make.sh
[root@localhost fastdfs-master]# ./make.sh install
采用默认安装方式，相应的文件与目录如下：
- 服务脚本文件位置
/etc/init.d/fdfs_storaged
/etc/init.d/fdfs_trackerd
- 配置文件（示例配置文件）：
所在位置:/etc/fdfs
[root@localhost fastdfs-master]# ll /etc/fdfs/
-rw-r--r--. 1 root root 1461 9月 28 2017 client.conf.sample
-rw-r--r--. 1 root root 7927 9月 28 2017 storage.conf.sample
-rw-r--r--. 1 root root 7200 9月 28 2017 tracker.conf.sample
- 命令行工具（/usr/bin目录下）
[root@localhost fastdfs-master]# ll /usr/bin/ | grep fdfs
-rwxr-xr-x. 1 root root 262291 9月 28 2017 fdfs_appender_test
-rwxr-xr-x. 1 root root 261988 9月 28 2017 fdfs_appender_test1
-rwxr-xr-x. 1 root root 252300 9月 28 2017 fdfs_append_file
-rwxr-xr-x. 1 root root 251458 9月 28 2017 fdfs_crc32
-rwxr-xr-x. 1 root root 252407 9月 28 2017 fdfs_delete_file
-rwxr-xr-x. 1 root root 253222 9月 28 2017 fdfs_download_file
-rwxr-xr-x. 1 root root 252948 9月 28 2017 fdfs_file_info
-rwxr-xr-x. 1 root root 265628 9月 28 2017 fdfs_monitor
-rwxr-xr-x. 1 root root 879078 9月 28 2017 fdfs_storaged
-rwxr-xr-x. 1 root root 268651 9月 28 2017 fdfs_test
-rwxr-xr-x. 1 root root 267828 9月 28 2017 fdfs_test1
-rwxr-xr-x. 1 root root 374227 9月 28 2017 fdfs_trackerd
-rwxr-xr-x. 1 root root 253350 9月 28 2017 fdfs_upload_appender
-rwxr-xr-x. 1 root root 256992 9月 28 2017 fdfs_upload_file
二、配置tracker服务器
1.复制tracker样例配置文件，并重命名
[root@localhost fastdfs-master]# cp /etc/fdfs/tracker.conf.sample /etc/fdfs/tracker.conf
2.修改tracker配置文件
[root@localhost fastdfs-master]# vi /etc/fdfs/tracker.conf
###修改内容如下
disabled=false # 启用配置文件
port=22122 # tracker服务器端口（默认22122）
base_path=/fastdfs/tracker # 存储日志和数据的根目录
3 .创建base_path指定的目录
[root@localhost fastdfs-master]# mkdir -p /fastdfs/tracker
4.防火墙中打开tracker服务器端口（ 默认为 22122）
[root@localhost fastdfs-master]# vi /etc/sysconfig/iptables
末尾添加
-A INPUT -m state --state NEW -m tcp -p tcp --dport 22122 -j ACCEPT
保存退出
重启防火墙：
service iptables restart
5 启动tracker服务器
[root@localhost fastdfs-master]# /etc/init.d/fdfs_trackerd start
初次启动，会在/fastdfs/tracker目录下生成logs、data两个目录
[外链图片转存失败(img-L1DMe1cS-1563207367765)(mdpic/10.png)]
检查FastDFS Tracker Server是否启动成功：`
ps -ef | grep fdfs_trackerd
[外链图片转存失败(img-bMYJYYB8-1563207367766)(mdpic/11.png)]
三、配置storage服务器
1.复制storage样例配置文件，并重命名
[root@localhost fastdfs-master]# cp /etc/fdfs/storage.conf.sample /etc/fdfs/storage.conf
2.编辑配置文件
[root@localhost fastdfs-master]# vi /etc/fdfs/storage.conf
修改部分内容如下
disabled=false # 启用配置文件
port=23000 # storage服务端口
base_path=/fastdfs/storage # 数据和日志文件存储根目录
store_path0=/fastdfs/storage # 第一个存储目录
tracker_server=10.0.31.189:22122 # tracker服务器IP和端口,此处是上面预定好的 ip
http.server_port=80 # http访问文件的端口,此处需要和后面 nginx 监听端口保持一致
3.创建基础数据目录
[root@localhost fastdfs-master]# mkdir -p /fastdfs/storage #此处上面配置的 base path 和store_path0路径,因为上面的路径可能不存在
4.防火墙中打开storage服务器端口（ 默认为 23000）
[root@localhost fastdfs-master]# vi /etc/sysconfig/iptables
添加如下端口行：
-A INPUT -m state --state NEW -m tcp -p tcp --dport 23000 -j ACCEPT
保存退出
重启防火墙：
[root@localhost fastdfs-master]# service iptables restart
5.启动storage服务器
[root@localhost fastdfs-master]# /etc/init.d/fdfs_storaged start
初次启动，会在/fastdfs/storage目录下生成logs、data两个目录。
检查FastDFS Tracker Server是否启动成功：
ps -ef | grep fdfs_storaged
[外链图片转存失败(img-qkcFnWLo-1563207367767)(mdpic/12.png)]
四、文件上传测试（10.0.31.189,此处仅为测试,后续会用代码上传）
1.修改Tracker服务器客户端配置文件
[root@localhost fastdfs-master]# cp /etc/fdfs/client.conf.sample /etc/fdfs/client.conf
[root@localhost fastdfs-master]# vi /etc/fdfs/client.conf
# 修改以下配置，其它保持默认
base_path=/fastdfs/tracker
tracker_server=10.0.31.189:22122 #修改为tracker_server地址和端口
2.执行文件上传命令
[root@localhost fastdfs-master]# /usr/bin/fdfs_upload_file /etc/fdfs/client.conf /root/logo.png
返回内容 返回文件ID号：/group1/M00/00/00/CgAfvVnMWOiAaxm0AAA5ilsiE-g844.png
如果返回类似内容,则上传成功
五、在所有storage节点安装fastdfs-nginx-module
1. fastdfs-nginx-module 作用说明
FastDFS 通过 Tracker 服务器，将文件放在 Storage 服务器存储，但是同组存储服务器之间需要进入文件复制，有同步延迟的问题。假Tracker 服务器将文件上传到了 10.0.31.201，上传成功后文件ID已经返回给客户端。此时 FastDFS 存储集群机制会将这个文件同步到同组存储 10.0.31.202，在文件还没有复制完成的情况下，客户端如果用这个文件 ID 在 10.0.31.126 上取文件，就会出现文件无法访问的错误。而 fastdfs-nginx-module 可以重定向文件连接到源服务器取文件，避免客户端由于复制延迟导致的文件无法访问错误
2.解压fastdfs-nginx-module-master.zip
[root@localhost fastdfs-master]# cd /usr/local
[root@localhost local]# unzip fastdfs-nginx-module-master.zip
3.安装Nginx
Nginx安装请参考Nginx源码安装文档
注意：在执行./configure配置nginx参数的时候，需要将fastdfs-nginx-moudle源码作为模块编译进去：
./configure --prefix=/usr/local/nginx --sbin-path=/usr/bin/nginx --add-module=/usr/local/fastdfs-nginx-module-master/src
4.复制 fastdfs-nginx-module 源码中的配置文件到/etc/fdfs 目录， 并修改
[root@localhost local]# cp /usr/local/fastdfs-nginx-module-master/src/mod_fastdfs.conf /etc/fdfs/
[root@localhost local]# vi /etc/fdfs/mod_fastdfs.conf
#修改以下配置 其他配置默认即可
connect_timeout=10 # 客户端访问文件连接超时时长（单位：秒）
base_path=/tmp # 临时目录
tracker_server=10.0.31.189:22122 # tracker服务IP和端口
storage_server_port=23000 # storage服务端口
group_name=group1 # 组名
url_have_group_name=true # 访问链接前缀加上组名
store_path0=/fastdfs/storage # 文件存储路径
5.复制 FastDFS 的部分配置文件到/etc/fdfs 目录
root@localhost local]# cd /usr/local/fastdfs-master/conf
root@localhost local]# cp http.conf mime.types /etc/fdfs/
6 在/fastdfs/storage文件存储目录下创建软连接，将其链接到实际存放数据的目录
root@localhost local]# ln -s /fastdfs/storage/data/ /fastdfs/storage/data/M00
7配置nginx访问storage文件
root@localhost local]# vi /usr/local/nginx/conf/nginx.conf
注意下面的 user root此处打开前面注释并修改为 root 防止后面运行出错
user root;
worker_processes 1;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;
server {
##此处和前面storage.conf配置的 http.server 保持一致
listen 80;
server_name localhost;
##配置通配符,将/group 开头的地址映射到 fastdfs 的项目,如果#只有一个 group1 可以直接写 group1
location ~/group([0-9])/M00 {
ngx_fastdfs_module;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
}
8防火墙中打开 Nginx 的 80 端口
为了防止出现问题,最好在防火墙中放行80端口,放行方式和上面放行其他的一致,修改完成后保存重启防火墙
9 启动Nginx
root@localhost local]# /usr/bin/nginx
ngx_http_fastdfs_set pid=xxx
nginx重启命令为：/usr/sbin/nginx -s reload
启动nginx后，如果打印出ngx_http_fastdfs_set pid=xxx，表示fastdfs-nginx-module模块加载成功了，xxx表示模块的进程ID。
10通过浏览器访问测试时上传的文件
测试上传后返回的文件ID为：group1/M00/00/00/CgAfvVnMWOiAaxm0AAA5ilsiE-g844.png，用浏览访问的地址为：http://10.0.31.189/group1/M00/00/00/CgAfvVnMWOiAaxm0AAA5ilsiE-g844.png
fastdfs 文件上传 java 代码
一.添加依赖
1.下载依赖
下载地址:https://github.com/happyfish100/fastdfs-client-java
2.安装依赖
将项目导入到 IDE 中,或者直接使用 maven 指令将依赖安装到仓库中
如何能把 fastdfs的jar包安装到本地的仓库中（因为中央仓库没有FASTDFS的jar包地址）
1，首先去github上下载下来fastdfs的压缩包
然后直接解压出来
2，使用cmd命令行 使用cd命令走到到你自己下载到的目录下，然后使用mvn clean install直接打包到本地的maven仓库
3，然后添加到pom.xml文件中就不会报错了
3.项目中添加依赖
<dependency>
<groupId>org.csourcegroupId>
<artifactId>fastdfs-client-javaartifactId>
<version>1.27-SNAPSHOTversion>
dependency>
4.配置文件
4.1 conf 格式
connect_timeout = 2
network_timeout = 30
charset = UTF-8
http.tracker_http_port = 80
http.anti_steal_token = no
http.secret_key = FastDFS1234567890
tracker_server = 10.0.11.247:22122
tracker_server = 10.0.11.248:22122
tracker_server = 10.0.11.249:22122
#注1：tracker_server指向您自己IP地址和端口，1-n个
#注2：除了tracker_server，其它配置项都是可选的
4.2 properties 格式
fastdfs.connect_timeout_in_seconds = 5
fastdfs.network_timeout_in_seconds = 30
fastdfs.charset = UTF-8
fastdfs.http_anti_steal_token = false
fastdfs.http_secret_key = FastDFS1234567890
fastdfs.http_tracker_http_port = 80
fastdfs.tracker_servers = 10.0.11.201:22122,10.0.11.202:22122,10.0.11.203:22122
#注1：properties 配置文件中属性名跟 conf 配置文件不尽相同，并且统一加前缀"fastdfs."，便于整合到用户项目配置文件
#注2：fastdfs.tracker_servers 配置项不能重复属性名，多个 tracker_server 用逗号","隔开
#注3：除了fastdfs.tracker_servers，其它配置项都是可选的
5.加载配置示例(后面用)
加载原 conf 格式文件配置：
ClientGlobal.init("fdfs_client.conf");
ClientGlobal.init("config/fdfs_client.conf");
ClientGlobal.init("/opt/fdfs_client.conf");
ClientGlobal.init("C:\\Users\\James\\config\\fdfs_client.conf");
加载 properties 格式文件配置：
ClientGlobal.initByProperties("fastdfs-client.properties");
ClientGlobal.initByProperties("config/fastdfs-client.properties");
ClientGlobal.initByProperties("/opt/fastdfs-client.properties");
ClientGlobal.initByProperties("C:\\Users\\James\\config\\fastdfs-client.properties");
加载 Properties 对象配置：
Properties props = new Properties();
props.put(ClientGlobal.PROP_KEY_TRACKER_SERVERS, "10.0.11.101:22122,10.0.11.102:22122");
ClientGlobal.initByProperties(props);
加载 trackerServers 字符串配置：
String trackerServers = "10.0.11.101:22122,10.0.11.102:22122";
ClientGlobal.initByTrackers(trackerServers);
6.检查加载配置结果：
System.out.println("ClientGlobal.configInfo(): " + ClientGlobal.configInfo());
ClientGlobal.configInfo(): {
g_connect_timeout(ms) = 5000
g_network_timeout(ms) = 30000
g_charset = UTF-8
g_anti_steal_token = false
g_secret_key = FastDFS1234567890
g_tracker_http_port = 80
trackerServers = 10.0.11.101:22122,10.0.11.102:22122
}
二. 测试方式演示
1.直接测试
package com.cd.fastdfs_demo.Test;
import org.csource.common.MyException;
import org.csource.fastdfs.ClientGlobal;
import org.csource.fastdfs.StorageClient;
import org.csource.fastdfs.TrackerClient;
import org.csource.fastdfs.TrackerServer;
import java.io.File;
import java.io.IOException;
public class FastdfsTest {
public static void main(String[] args) throws IOException, MyException {
//加载配置文件
ClientGlobal.init("fastdsf.conf");
//创建于tracker交互的客户端
TrackerClient trackerClient = new TrackerClient();
//通过客户端与tracker建立连接
TrackerServer trackerServer = trackerClient.getConnection();
//通过tracker服务端获取一个可以使用的storage客户端
StorageClient storageClient = new StorageClient(trackerServer, null);
//上传文件，只需要一个文件路径
File file = new File("F:" + File.separator + "logo.png");
System.err.println(file);
//上传文件,只需要文件路径，第二个参数是文件扩展名，第三个参数是元数据
String[] strings = storageClient.upload_appender_file(file.getPath(), null, null);
System.out.println(strings);
//0成功 2失败
int res = storageClient.delete_file(strings[0], strings[1]);
System.out.println(res);
}
}
2.封装简单工具类
/**
工具类中只封装了部分方法,更多方法请自己封装
*/
public class FastDFSClient {
private TrackerClient trackerClient;
private TrackerServer trackerServer;
private StorageClient1 storageClient;
private StorageServer storageServer;
public FastDFSClient(String conf) throws Exception {
if (conf.startsWith("classpath")) {//如果配置文件是 classpath 开头的,则代表是在类路径中,去掉 classpath: 然后拼接类路径
conf=conf.replace("classpath:", getClass().getResource("/").getPath());
}
ClientGlobal.init(conf);//加载路径
trackerClient=new TrackerClient();
trackerServer=trackerClient.getConnection();
storageClient=new StorageClient1(trackerServer, storageServer);
}
/**
上传文件,参数是文件的路径,后缀名和元数据
*/
public String upload_file(String fileName,String ext_name,NameValuePair[] pairs) throws Exception {
return storageClient.upload_file1(fileName, ext_name, pairs);
}
public String upload_file(String fileName) throws Exception{
return upload_file(fileName, null, null);
}
public String upload_file(String fileName,String ext_name) throws Exception{
return upload_file(fileName, ext_name, null);
}
public String upload_file(String fileName,NameValuePair[] pairs) throws Exception{
return upload_file(fileName, null, pairs);
}
/**
上传二进制数据,需要将文件先转换为二进制
*/
public String upload_file(byte[]source,String ext_name,NameValuePair[] pairs) throws Exception{
return storageClient.upload_file1(source, ext_name, pairs);
}
}
3. 测试工具类
@Test
public void test2() throws Exception{
FastDFSClient fastDFSClient =new FastDFSClient("/home/jackiechan/文档/workspace/gp1701/testfastdfs/src/main/resources/server.conf");
String upload_file = fastDFSClient.upload_file("/home/jackiechan/12333.jpg");
System.err.println(upload_file);
}
三. SpringMvc 中使用
环境配置和前面四步一致
代码
@Controller
public class FileUploadController {
/**
* MultipartFile的形参的名字和form表单中文件的域name一致
* @param file
* @return
*/
@ResponseBody
@RequestMapping(value="/upload",produces= {"text/plain;charset=utf-8"})
public String upLoad(MultipartFile file) {
String path=null;
Map<String, Object> map=new HashMap<>();//用于返回 json 数据的map 对象
try {
//file是用户上传的文件
//需要将文件转存到文件服务器
//file.transferTo(dest); 存储到本地文件
/*file.getOriginalFilename()
file.getName()*/
FastDFSClient fastDFSClient=new FastDFSClient("classpath:server.conf");//此处应当注入对象过来
path= fastDFSClient.upload_file(file.getBytes(), "jpg", null);
map.put("error", 0);//设置返回内容
map.put("url", "http://jiaoxue.chenjunbo.xin/"+path);
} catch (Exception e) {
map.put("error", 1);
map.put("message", "发斯蒂芬斯蒂芬斯蒂芬");
e.printStackTrace();
}
return JsonUtils.objectToJson(map);//将数据转成 json 数据返回,此处可以自己写或者直接返回map
}
}