FastDFS安装部署

FastDFS 集群的安装、配置与使用

FastDFS-6.15.4 + libfastcommon-V1.0.84 + libserverframe-V1.2.12

1. 安装 libfastcommon

1.1 下载 libfastcommon

首先，你需要从 libfastcommon 的官方网站下载最新的 libfastcommon 源码包。

https://gitee.com/fastdfs100/libfastcommon

https://gitee.com/fastdfs100/libfastcommon/repository/archive/V1.0.84.tar.gz（最新，搭配FastDFS-6.15.4）

1.2 解压 libfastcommon

将下载的 libfastcommon-master.zip文件解压到你的工作目录中。

unzip libfastcommon-master.zip
或
tar -zxvf libfastcommon-V1.0.84.tar.gz

1.3 编译 libfastcommon-master.zip

进入 FastDFS 的源码目录，并使用 make 命令进行编译。

# 第一步：libfastcommon 
cd libfastcommon-V1.0.84 
./make.sh clean
./make.sh 
sudo ./make.sh install 
sudo ldconfig

2. 安装 libserverframe

FastDFS ≤ V6.07：只需要 libfastcommon，不需要 libserverframe；

FastDFS ≥ V6.08：必须先装 libfastcommon → 再装 libserverframe → 最后编译 FastDFS

2.1 下载 libserverframe
首先，你需要从 libserverframe的官方网站下载最新的 libserverframe源码包。

https://gitee.com/fastdfs100/libserverframe（最新，搭配FastDFS-6.15.4）

2.2 解压 libserverframe

将下载的 libserverframe-V1.2.12.tar.gz文件解压到你的工作目录中。

tar -zxvf libserverframe-V1.2.12.tar.gz

2.3 编译 libserverframe-V1.2.12.tar.gz

进入 libserverframe-V1.2.12 的源码目录，并使用 make 命令进行编译。

# 第二步：libserverframe 
cd ../libserverframe-V1.2.12 
./make.sh clean
./make.sh 
sudo ./make.sh install 
sudo ldconfig

3. 安装 FastDFS

3.1 下载 FastDFS

首先，你需要从 FastDFS 的官方网站下载最新的 FastDFS 源码包。访问 FastDFS 官网并下载最新的 fastdfs-master.zip 文件。

https://gitee.com/fastdfs100/fastdfs

3.2 解压 FastDFS

将下载的 fastdfs-master.zip 文件解压到你的工作目录中。

unzip fastdfs-V6.15.4.zip

3.3 编译 FastDFS

进入 FastDFS 的源码目录，并使用 make 命令进行编译。

cd fastdfs-master
./make.sh clean
./make.sh

唯一硬性命名规则（踩坑关键点）

只有下载 master 分支源码时才有强制名称要求：

master 分支解压必须叫 libfastcommon-master 和 fastdfs-master
带版本标签的正式发行包（V6.07/V1.0.50）无此限制，随便改名

清理残留

# 第一步：彻底删除旧库
sudo rm -f /lib/libfastcommon.so* /usr/lib/libfastcommon.so* /usr/lib64/libfastcommon.so* /usr/local/lib/libfastcommon.so*
sudo rm -f /lib/libserverframe.so* /usr/lib/libserverframe.so* /usr/lib64/libserverframe.so* /usr/local/lib/libserverframe.so*
sudo rm -rf /usr/include/fastcommon /usr/include/serverframe /usr/local/include/fastcommon /usr/local/include/serverframe

# 第二步：刷新缓存
sudo ldconfig

# 第三步：重新编译 libfastcommon
cd ~/deploy/fastdfs/libfastcommon-V1.0.84
./make.sh clean && ./make.sh && sudo ./make.sh install

# 第四步：重新编译 libserverframe
cd ~/deploy/fastdfs/libserverframe-V1.2.12
./make.sh clean && ./make.sh && sudo ./make.sh install

# 第五步：刷新缓存并验证
sudo ldconfig -v
ldconfig -p | grep -E 'fastcommon|serverframe'

# 第六步：重新编译 FastDFS
cd ~/deploy/fastdfs/fastdfs-V6.15.4
./make.sh clean && ./make.sh

FastDFS 编译完成后，需要安装配置文件和启动服务。按以下步骤操作：

1. 安装 FastDFS（复制配置文件和二进制文件）

cd ~/deploy/fastdfs/fastdfs-V6.15.4
sudo ./make.sh install

这会把：

可执行文件复制到 /usr/bin/
配置文件复制到 /etc/fdfs/
库文件复制到系统目录

2. 修改 Tracker 配置文件

# 编辑 tracker 配置
sudo cp /etc/fdfs/tracker.conf.sample /etc/fdfs/tracker.conf
sudo vi /etc/fdfs/tracker.conf

sudo vi /etc/fdfs/tracker.conf

主要修改项：

# 数据和日志目录（确保目录存在）
base_path=/home/fastdfs/tracker

# HTTP 端口（默认 22122，一般不用改）
port=22122

如果不存在目录则创建

sudo mkdir -p /home/fastdfs/tracker

3. 修改 Storage 配置文件

# 编辑 storage 配置
sudo cp /etc/fdfs/storage.conf.sample /etc/fdfs/storage.conf
sudo vi /etc/fdfs/storage.conf

主要修改项：

# 数据和日志目录
base_path=/home/fastdfs/storage

# 存储路径（可以多个） 这里会自动创建data文件夹用了存储文件，路径上不需要加data
# store_path0=/home/fastdfs/storage/data
store_path0=/home/fastdfs/storage

# Tracker 服务器地址（改成你的 IP，可以多个）
tracker_server=192.168.1.100:22122
#tracker_server=192.168.1.100:22122

# HTTP 端口
http.server_port=8888

如果不存在目录则创建

sudo mkdir -p /home/fastdfs/storage/data

sudo chmod -R 777 fastdfs

更换store_path0地址后报错（这步需要完成“快速测试上传”步骤后才能进行测试上传）：

# 1. 删除旧的标记文件
sudo rm /home/fastdfs/storage/data/.fastdfs_vars

# 2. 重启 storage
sudo fdfs_storaged /etc/fdfs/storage.conf start

# 3. 等待注册到 tracker
sleep 10

# 4. 确认状态
fdfs_monitor /etc/fdfs/storage.conf

# 5. 测试上传
fdfs_upload_file /etc/fdfs/client.conf /tmp/test.txt

4. 启动 Tracker 服务

# 启动 tracker
sudo fdfs_trackerd /etc/fdfs/tracker.conf start

# 查看是否启动成功
ps aux | grep fdfs_trackerd
netstat -tlnp | grep 22122

5. 启动 Storage 服务

# 启动 storage
sudo fdfs_storaged /etc/fdfs/storage.conf start

# 其他命令
sudo fdfs_storaged /etc/fdfs/storage.conf restart
sudo fdfs_storaged /etc/fdfs/storage.conf stop

# 查看是否启动成功
ps aux | grep fdfs_storaged
netstat -tlnp | grep 23000

6. 验证服务状态

# 查看 tracker 日志
tail -f /home/fastdfs/tracker/logs/tracker.log

# 查看 storage 日志
tail -f /home/fastdfs/storage/logs/storage.log

# 测试连接（应该能看到 storage 列表）
fdfs_monitor /etc/fdfs/storage.conf

7. （可选）配置开机自启

如果使用 systemd：

# 检查是否有 systemd 服务文件
ls /usr/lib/systemd/system/fdfs_*

# 启用开机自启
sudo systemctl enable fdfs_trackerd
sudo systemctl enable fdfs_storaged

# 启动服务
sudo systemctl start fdfs_trackerd
sudo systemctl start fdfs_storaged

# 查看状态
sudo systemctl status fdfs_trackerd
sudo systemctl status fdfs_storaged

快速测试上传

# 复制客户端配置
sudo cp /etc/fdfs/client.conf.sample /etc/fdfs/client.conf
sudo vi /etc/fdfs/client.conf

# 修改 client.conf
base_path=/tmp/fdfs_client
tracker_server=192.168.1.100:22122

# 创建临时目录
mkdir -p /tmp/fdfs_client

# 测试上传（准备一个测试文件）
echo "test content" > /tmp/test.txt
fdfs_upload_file /etc/fdfs/client.conf /tmp/test.txt

# 如果返回类似 group1/M00/00/00/xxx.txt，说明成功

常见问题排查
如果启动失败：
1、检查端口是否被占用

netstat -tlnp | grep -E '22122|23000'

2、检查防火墙

   sudo ufw allow 22122/tcp
   sudo ufw allow 23000/tcp
   sudo ufw allow 8888/tcp

3、查看详细错误日志

   tail -100 /home/fastdfs/tracker/logs/tracker.log
   tail -100 /home/fastdfs/storage/logs/storage.log

4、确认配置文件路径正确

   ls -la /etc/fdfs/*.conf

先执行 sudo ./make.sh install，然后按上面的步骤配置和启动即可。

posted @ 2026-06-22 09:17 show-code 阅读(46) 评论(0) 收藏举报

刷新页面返回顶部

show-code