FastDFS笔记(一): 安装

写在前面

这几天项目中用到了fastdfs，安装是个痛苦的过程，各种BUG，写篇文章纪念一下。

参考博客

• FastDFS安装步骤

1、安装 libfastcommon

• 解压libfastcommon文件

tar -xzf libfastcommonV1.0.7.tar.gz

• 进入文件夹目录

./make.sh && sudo ./make.sh install

• 最后，把生成的libfastcommon库拷贝到/usr/lib目录下

sudo cp /usr/lib64/* /usr/lib/

2、编译FastDFS

• 解压，然后编译安装FastDFS:

tar zxf FastDFS_v5.05.tar.gz
./make.sh
sudo ./make.sh install

• 安装成功后将目录conf内的文件拷贝到/etc/fdfs目录下：

sudo cp conf/* /etc/fdfs/

3、安装tracker

• 进入/etc/fdfs目录，修改tracker.conf文件。如果不存在，就拷贝tracker.conf.sample文件为tracker.conf，然后再修改：

base_path=/home/yuqing/fastdfs >>> base_path=/home/warmsirius/data/fastdfs

http.server_port=8080 >>> http.server_port=80

• 其中，/home/warmsirius/data/fastdfs目录如果不存在，就创建一个。

• 之后，就启动tracker，并查看是启动成功(出现如下提示，表示启动成功)：

$ fdfs_trackerd /etc/fdfs/tracker.conf start
$ netstat -unltp | grep tracker
(Not all processes could be identified, non-owned process info
 will not be shown, you would have to be root to see it all.)
tcp        0      0 0.0.0.0:22122           0.0.0.0:*               LISTEN      7281/fdfs_trackerd

4、安装storage

• 修改storage.conf文件。如果不存在，就拷贝storage.conf.sample文件为storage.conf，然后再修改：

base_path=/home/yuqing/fastdfs >>> base_path=/home/warmsirius/data/fastdfs/storage
store_path0=/home/yuqing/fastdfs >>> store_path0=/home/warmsirius/data/fastdfs/storage
tracker_server=192.168.209.121:22122 >>> tracker_server=192.168.2.231:22122
http.server_port=80 >>> http.server_port=8888

• 其中，如果/home/warmsirius/data/fastdfs/storage不存在，就创建该目录

• 然后，就启动storage，并查看是否成功（出现如下提示，表示启动成功）：

$ fdfs_storaged /etc/fdfs/storage.conf start
$ netstat -unltp | grep storage
(Not all processes could be identified, non-owned process info
 will not be shown, you would have to be root to see it all.)
tcp        0      0 0.0.0.0:23000           0.0.0.0:*               LISTEN      7348/fdfs_storaged

• 最后，查看tracker和storage是不是在通信：

$ fdfs_monitor /etc/fdfs/storage.conf
...
current trunk file id = 0

    Storage 1:
        id = 192.168.2.231
        ip_addr = 192.168.2.231  ACTIVE
...

如上提示，出现ACTIVE，表示二者均正常启动，至此就可以进行上传文件测试了。

5、mod_fastdfs.conf和client.conf配置

mod_fastdfs.conf

• 首先解压fastdfs-nginx-module_v1.16.tar.gz

tar -xvf fastdfs-nginx-module_v1.16.tar.gz;

• 将src目录下的mod_fastfds.conf文件复制到 /etc/fdfs/mod_fastdfs.conf

cp path_to_fdfsdfs-nginx-module/src/mod_fastdfs.conf /etc/fdfs/mod_fastdfs.conf

• 更改/etc/fdfs/mod_fastdfs.conf配置

base_path=/home/warmsirius/data/fastdfs
tracker_server=192.168.2.231:22122
url_have_group_name = true
store_path0=/home/warmsirius/data/fastdfs/storage

client.conf

$ sudo vi /etc/fdfs/client.conf
...
base_path=/home/warmsirius/data/fastdfs
tracker_server=192.168.2.231:22122
...

6、安装Nginx

• 首先解压fastdfs-nginx-module_v1.16.tar.gz，然后把解压后的文件目录整个拷贝到/usr/local/src目录下。

cp -r /home/warmsirius/fastdfs-nginx-module/ /usr/local/src

• 配置nginx，加入fastdfs-nginx-module模块：

$ sudo ./configure --add-module=/usr/local/src/fastdfs-nginx-module/src/

如果出现如下错误，

error: the HTTP rewrite module requires the PCRE library
请安装libpcre3和ssh的库

yum -y install zlib zlib-devel openssl openssl--devel pcre pcre-devel

之后再执行configure配置，完成后进行安装：

sudo make

如果出现如下错误：

root/fastdfs-nginx-module/src//common.c:21:25: fatal error: fdfs_define.h: No such file or directory
 #include "fdfs_define.h"

则需要再添加如下配置：

• 1.把/usr/lib64/libfdfsclient.so库拷贝到/usr/lib/目录下:

sudo cp /usr/lib64/libfdfsclient.so /usr/lib/

• 2.配置/usr/local/src/fastdfs-nginx-module/src/目录下的config文件，把CORE_INCS和CORE_LIBS的所有路径都修改为/usr/include和/usr/lib：

sudo vi /usr/local/src/fastdfs-nginx-module/src/config


...
CORE_INCS="$CORE_INCS /usr/include/fastdfs /usr/include/fastcommon/"
CORE_LIBS="$CORE_LIBS -L/usr/lib -lfastcommon -lfdfsclient"
...

之后就可以执行编译和安装了：

sudo make && sudo make install

完成之后，可以查看fastdfs-nginx-module是否配置成功(下面提示表示配置成功)：

/usr/local/nginx/sbin/nginx -V
nginx version: nginx/1.12.1
built by gcc 5.4.0 20160609 (Ubuntu 5.4.0-6ubuntu1~16.04.4)
configure arguments: --add-module=/usr/local/src/fastdfs-nginx-module/src

7、整合fastdfs-nginx-module 和 Nginx

• 首先到/usr/local/src/fastdfs-nginx-module-master/src/目录下，拷贝mod_fastdfs.conf文件到/etc/fdfs目录下，然后进行如下配置：

base_path=/home/warmsirius/data/fastdfs
tracker_server=192.168.2.231:22122
url_have_group_name = true
store_path0=/home/warmsirius/data/fastdfs/storage

然后配置Nginx，添加如下内容：

    server {
        listen       8888;# 注意这个端口要和storage.conf中的http.server_port一致
        server_name  localhost;

        ...

         # 配置fastdfs的访问路径
        location ~/group[0-9]/ {
            ngx_fastdfs_module;
        }
        ...
    }

• 之后启动nginx:

$ sudo /usr/local/nginx/sbin/nginx
ngx_http_fastdfs_set pid=23238

• 中止nginx

sudo /usr/local/nginx/sbin/nginx  -s stop

上传测试

然后，创建一个test.txt文件，随便输入一些内容，再进行上传：

$ echo HelloWorld > ~/test.txt
$ fdfs_test /etc/fdfs/client.conf upload ~/test.txt
...
[2017-09-23 20:12:00] DEBUG - base_path=/home/kelvin/data/fastdfs, connect_timeout=30, network_timeout=60, tracker_server_count=1, anti_steal_token=0, anti_steal_secret_key length=0, use_connection_pool=0, g_connection_pool_max_idle_time=3600s, use_storage_id=0, storage server id count: 0

tracker_query_storage_store_list_without_group:
    server 1. group_name=, ip_addr=192.168.2.231, port=23000

group_name=group1, ip_addr=192.168.2.231, port=23000
storage_upload_by_filename
group_name=group1, remote_filename=M00/00/00/wKgC51nHIoCACtpSAAAAC5KLpvs082.txt
source ip address: 192.168.2.231
file timestamp=2017-09-23 20:12:00
file size=11
file crc32=2458625787
example file url: http://192.168.2.231/group1/M00/00/00/wKgC51nHIoCACtpSAAAAC5KLpvs082.txt
...

最后，在浏览器里输入http://192.168.2.231/group1/M00/00/00/wKgC51nHIoCACtpSAAAAC5KLpvs082.txt，即可访问到test.txt的文件内容：

安装注意事项

• 分别查看/etc/fdfs/tracker.conf,storage.conf,mod_fastdfs.conf中的路径是否都对着，是否都存在，如果不存在，则需要创建

• 确定/etc/fdfs/storage.conf中http.server_port与/usr/local/nginx/conf/nginx.conf中的listen端口号一致，/etc/fdfs/storage.conf中默认的端口是8888，另外还需要对8888端口开启防火墙；（很有可能就是没有把storage的端口修改，导致storage和http.server_port及nginx.conf中的端口不一致，导致nginx无法读取storage中的图片）。