.2 环境前置要求
本地虚拟机/云服务器:CentOS7.x 版本
将FastDFS 和 Nginx 相关的软件压缩包下载完成并上传到云服务器中,下载链接如下:
nginx-1.18.0.tar.gz
libfastcommon-1.0.38.tar.gz
fastdfs-5.11.tar.gz
fastdfs-nginx-module-1.20.tar.gz
下载完成后如图:
将下载的压缩文件通过Xftp 6 上传到云服务器指定路径下,我指定的路径是: /usr/local/src/software1.3 安装单节点的FastDFS
因为我这里只是用FastDFS 去做文件服务器,个人开发不需要用到集群的FastDFS,而且个人也没有多台服务器的环境!如果有需要,可以找一篇关于FastDFS集群环境搭建的文章阅读!
1.3.1 安装gcc 和nginx 依赖库
因为FastDFS 本身就是淘宝的大牛用C语言写的,所以其依赖于对C进行编译的环境 gcc,安装命令如下:
yum -y install gcc
除了gcc之外,还需要安装nginx 相关的依赖库,因为后续要安装 nginx :
yum install pcre pcre-devel
yum install zlib zlib-devel
yum install openssl openssl--devel
yum install libevent
注意:如果你本机安装的nginx压缩包不是
tar.gz
而是
zip
格式的,这时候需要自己下载一下解压
zip
格式文件的命令
unzip
,下载命令如下:
yum install -y unzip zip
1.3.2 安装libfastcommon
我们进入上传软件压缩包的路径:cd /usr/local/src/software
解压:
tar -zxvf libfastcommon-1.0.38
进入解压完成后的目录:
cd libfastcommon-1.0.38/
执行编译并且安装:
./make.sh
./make.sh install
1.3.3 安装fastdfs
解压:
tar -zxvf fastdfs-5.11.tar.gz
进入解压完成后的目录:
cd fastdfs-5.11/
执行编译并且安装:
./make.sh
./make.sh install
如果安装成功,会看到
/etc/init.d/下看到提供的脚本文件:
-
是tracker启动脚本fdfs_trackerd
-
是storage启动脚本fdfs_storaged
能够在
/etc/fdfs/目录下看到默认的配置文件模板:
ll /etc/fdfs/
结果如下:
-rw-r--r-- 1 root root 1461 Dec 9 20:26 client.conf.sample
-rw-r--r-- 1 root root 7927 Dec 9 20:26 storage.conf.sample
-rw-r--r-- 1 root root 7389 Dec 9 20:26 tracker.conf.sample
tarcker.conf.sample 是tracker的配置文件模板
storage.conf.sample 是storage的配置文件模板
client.conf.sample 是客户端的配置文件模板
1.3.4 配置并启动tracker服务
FastDFS 的 tracker 和 storage 在刚刚的安装过程中,都已经被安装了,因此我们安装这两种角色的方式是一样的。不同的是,两种需要不同的配置文件。
我们要启动tracker,就修改刚刚看到的tarcker.conf,并且启动fdfs_trackerd脚本即可:
1)首先将模板文件复制:
cp /etc/fdfs/tracker.conf.sample /etc/fdfs/tracker.conf
2)修改复制后的配置文件:
vim /etc/fdfs/tracker.conf
# 修改的内容如下:
base_path=/fastdfs_files/tracker # 自己指定的存储日志和数据的根目录
因为自己指定的目录默认是不存在的,所以修改过配置文件后,我们新建一下该目录:
mkdir -p /fastdfs_files/tracker
注意:如果使用的是本地虚拟机请关闭防火墙,云服务器记得开放安全组对应的端口!下面是我的云服务器开放的端口,FastDFS 默认需要23000 和 22122 两个端口:
4)启动和停止:
启动tracker服务器: /etc/init.d/fdfs_trackerd start
停止tracker服务器: /etc/init.d/fdfs_trackerd stop
不过安装过程中,fdfs 已经被设置为系统服务,我们可以采用熟悉的服务启动方式:
service fdfs_trackerd start # 启动fdfs_trackerd服务,停止用stop
检查FastDFS Tracker Server是否启动成功:
ps -ef | grep fdfs_trackerd
如果是本地虚拟机,不想每次开机都重新启动该服务,可以将其设置为开启自启动:
chkconfig fdfs_trackerd on
1.3.5 配置并启动storage服务
步骤类似于1.3.4:
cp /etc/fdfs/storage.conf.sample /etc/fdfs/storage.conf
vim /etc/fdfs/storage.conf
# 修改的内容如下:
base_path=/fastdfs_files/storage # 数据和日志文件存储根目录
store_path0=/fastdfs_files/storage # 第一个存储目录
tracker_server=本机ip:22122 # tracker服务器IP和端口
mkdir -p /fastdfs_files/storage
3)启动和停止:
- 启动storage服务器:
/etc/init.d/fdfs_storaged start
- 停止storage服务器:
/etc/init.d/fdfs_storaged stop
推荐使用如下方式启动:
service fdfs_storaged start # 启动fdfs_storaged服务,停止用stop
可以使用
ps -ef | grep fdfs
查看进程:
chkconfig fdfs_trackerd on
再次提醒:本地虚拟机关闭防火墙,云服务器开启安全组端口!
2. 使用nginx访问FastDFS
2.1 安装fastdfs-nginx-module
2.1.1 解压
tar -zxvf fastdfs-nginx-module-1.20.tar.gz
2.1.2 修改config文件
1)进入解压后的文件夹下的src目录
cd fastdfs-nginx-module-1.20/src/
2)编辑config
vim config
使用以下底行命令:
:%s+/usr/local/+/usr/+g
将所有的
/usr/local替换为
/usr,这个才是正确的目录:
2.1.3 配置nginx与FastDFS关联配置文件
复制 fastdfs-nginx-module-1.20 源码中的配置文件到
/etc/fdfs目录, 并修改:
cp /usr/local/src/software/fastdfs-nginx-module-1.20/src/mod_fastdfs.conf /etc/fdfs/
vim /etc/fdfs/mod_fastdfs.conf
修改以下配置:
connect_timeout=10 # 客户端访问文件连接超时时长(单位:秒)
tracker_server=本机ip:22122 # tracker服务IP和端口
url_have_group_name=true # 访问链接前缀加上组名
store_path0=/fastdfs_files/storage # 文件存储路径
复制 FastDFS 的部分配置文件到
目录:
cd /usr/local/src/software/fastdfs-5.11/conf/
cp http.conf mime.types /etc/fdfs/
2.2 安装Nginx的插件
因为文章 1.3.1 小节已经安装了 nginx 依赖库,所以这里不需要再安装:
# 如果前面没安装,这里就需要安装虚啊 nginx依赖库:
yum -y install gcc pcre pcre-devel zlib zlib-devel openssl openssl-devel
2.2.1 解压安装包
tar -zxvf nginx-1.18.0.tar.gz
2.2.2 配置nginx安装包并指定fastdfs-nginx-model
# 进入解压后的nginx-1.18.0 目录:
cd nginx-1.18.0/
# 执行以下命令:
./configure --prefix=/opt/nginx --sbin-path=/usr/bin/nginx --add-module=/usr/local/src/software/fastdfs-nginx-module-1.20/src/
注意:在执行
./configure
配置nginx 参数的时候,需要将 fastdfs-nginx-moudle 源码作为模块编译进去。
2.2.3 编译并安装
make && make install
2.2.4 启动nginx
配置nginx整合fastdfs-module模块,我们需要修改nginx配置文件,在
/opt/nginx/config/nginx.conf文件中:
vim /opt/nginx/conf/nginx.conf
将文件中,原来的
server 80{ ...}
部分代码替换为如下代码:
server {
listen 80;
server_name 你的域名;
# 监听域名中带有group的,交给FastDFS模块处理
location ~/group([0-9])/ {
ngx_fastdfs_module;
}
location / {
root html;
index index.html index.htm;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
启动命令:
nginx # 启动nginx
nginx -s stop # 停止nginx
nginx -s reload # 重新载入配置文件
可通过
ps -ef | grep nginx
查看nginx是否已启动成功:
3. 使用SpringBoot 整合FastDFS
3.1 相关依赖
<dependency>
<groupId>com.github.tobato</groupId>
<artifactId>fastdfs-client</artifactId>
</dependency>
3.2 相关配置参数
# fastDFS 相关配置
fdfs:
so-timeout: 1501 # 读取超时时间
connect-timeout: 601 # 连接超时时间
thumb-image: # 缩略图配置
width: 60
height: 60
tracker-list: # tracker地址:你的虚拟机服务器地址+端口(默认是22122)
- 你的服务器ip:22122
3.3 相关配置类
/**
* @Auther: csp1999
* @Date: 2020/12/10/11:29
* @Description: fastDFS 客户端配置类
*/
@Configuration
@Import(FdfsClientConfig.class)
// 解决jmx重复注册bean的问题
@EnableMBeanExport(registration = RegistrationPolicy.IGNORE_EXISTING)
public class FastDfsClientConfig {
}
3.4 测试类中进行测试
/**
* @Auther: csp1999
* @Date: 2020/12/10/11:33
* @Description: 测试FastDFS 文件上传
*/
@SpringBootTest
@RunWith(SpringRunner.class)
public class FastDFSTest {
// fastDFS 存储客户端
@Autowired
private FastFileStorageClient storageClient;
// 用于获取 fastDFS 图片缩略图
@Autowired
private ThumbImageConfig thumbImageConfig;
@Test
public void testUpload() throws FileNotFoundException {
// 获取本机要上传的文件
File file = new File("M:\\code\\IDEA\\leyou\\image\\lf.jpg");
/**
* 上传并保存图片
*
* 参数:
* 1-上传的文件流
* 2-文件的大小
* 3-文件的后缀
* 4-可以不管他
*/
StorePath storePath = this.storageClient.uploadFile(
new FileInputStream(file), file.length(), "jpg", null);
// 带分组的路径
System.out.println(storePath.getFullPath());
// 不带分组的路径
System.out.println(storePath.getPath());
}
@Test
public void testUploadAndCreateThumb() throws FileNotFoundException {
// 获取本机要上传的文件
File file = new File("M:\\code\\IDEA\\leyou\\image\\bz4.jpg");
/**
* 上传并保存图片并且生成缩略图
*
* 参数:
* 1-上传的文件流
* 2-文件的大小
* 3-文件的后缀
* 4-可以不管他
*/
StorePath storePath = this.storageClient.uploadImageAndCrtThumbImage(
new FileInputStream(file), file.length(), "png", null);
// 带分组的路径
System.out.println(storePath.getFullPath());
// 不带分组的路径
System.out.println(storePath.getPath());
// 获取缩略图路径
String path = thumbImageConfig.getThumbImagePath(storePath.getPath());
System.out.println(path);
}
}
先测试
testUpload()
方法,输出结果:
然后我们就可以通过
服务器ip地址/group1/M00/00/00/wKg4ZVsWl5eAdLNZAABAhya2V0c424.jpg,去访问图片:
同理我们测试
testUploadAndCreateThumb()
带缩略图的方法,输出结果如下:
group1/M00/00/00/rBHaFV_Rmq6AC7m3AAQvu4hOzN4945.png # 带分组的路径
M00/00/00/rBHaFV_Rmq6AC7m3AAQvu4hOzN4945.png # 不带分组的路径
M00/00/00/rBHaFV_Rmq6AC7m3AAQvu4hOzN4945_60x60.png # 缩略图路径
我们先看下不是缩略图的效果:
ip地址/group1/M00/00/00/rBHaFV_Rmq6AC7m3AAQvu4hOzN4945.png再看下缩略图的效果:
ip地址/group1/M00/00/00/rBHaFV_Rmq6AC7m3AAQvu4hOzN4945_60x60.png图片大小是我们在配置文件中配置的宽高60px! 我们可以到服务器
/fastdfs_files/storage/data/路径下查看上传的图片:
SpringBoot整合FastDFS完成!
扩展:除了FastDFS分布式文件上传,现在开发中基于OSS的文件上传也很常用,可以参考下面这篇文章学习: springboot操作阿里云OSS实现文件上传,下载,删除(附源码)