配置FastDFS的Nginx访问，一下就通了（三）

一、环境信息

• Linux：CentOS / Rocky / RHEL 系列

• Nginx：1.24.0

• FastDFS：5.05

• fastdfs-nginx-module：1.16

• fastcommon：1.0.38

fastdfs-nginx-module下载地址，下载后切换代码历史版本至最开始1.16代码位置：

https://github.com/happyfish100/fastdfs-nginx-module

然后修改config配置如下：

目录 /usr/local/src/fastdfs-nginx-module/src

ngx_addon_name=ngx_http_fastdfs_module ​ HTTP_MODULES="$HTTP_MODULES ngx_http_fastdfs_module" ​ NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_fastdfs_module.c" ​ CORE_INCS="$CORE_INCS /usr/local/include" ​ CORE_LIBS="$CORE_LIBS -lfastcommon -lfdfsclient" ​ CFLAGS="$CFLAGS -D_FILE_OFFSET_BITS=64 -DFDFS_OUTPUT_CHUNK_SIZE='256*1024' -DFDFS_MOD_CONF_FILENAME='\"/etc/fdfs/mod_fastdfs.conf\"'"

源码目录：

/usr/local/src

安装目录：

/usr/local/nginx /etc/fdfs

二、编译安装 Nginx + FastDFS 模块

进入 nginx 源码目录：

cd /usr/local/src/nginx-1.24.0

编译配置：

./configure \ --prefix=/usr/local/nginx \ --add-module=/usr/local/src/fastdfs-nginx-module/src

编译安装：

make make install

验证：

/usr/local/nginx/sbin/nginx -V

输出包含：

--add-module=/usr/local/src/fastdfs-nginx-module/src

说明模块编译成功。

三、Nginx 配置

编辑：

/usr/local/nginx/conf/nginx.conf

server 配置：

server { listen 80; server_name localhost; location / { root html; index index.html index.htm; } location ~/group([0-9])/M00 { ngx_fastdfs_module; } }

四、配置 mod_fastdfs.conf

复制模板：

cp /usr/local/src/fastdfs-nginx-module/src/mod_fastdfs.conf /etc/fdfs/

修改：

/etc/fdfs/mod_fastdfs.conf

关键参数：

tracker 地址

tracker_server=192.168.2.237:22122

storage 路径

store_path0=/data/fastdfs/storage

URL 是否包含 group

url_have_group_name = true

group 数量

group_count = 1

添加 group 配置：

[group1] group_name=group1 storage_server_port=23000 store_path_count=1 store_path0=/data/fastdfs/storage

五、配置 http.conf 和 mime.types

FastDFS nginx 模块需要这两个文件。

查找：

find /usr/local/src -name http.conf

复制：

cp /usr/local/src/fastdfs-5.05/conf/http.conf /etc/fdfs/ cp /usr/local/src/fastdfs-5.05/conf/mime.types /etc/fdfs/

确认：

ls /etc/fdfs

结果：

client.conf http.conf mime.types mod_fastdfs.conf

六、创建 storage 软链接（非常关键）

FastDFS nginx 模块访问文件依赖M00目录。

创建：

ln -s /data/fastdfs/storage/data /data/fastdfs/storage/data/M00

目录结构：

/data/fastdfs/storage/data/M00

七、启动 Nginx

启动：

/usr/local/nginx/sbin/nginx

检查：

ps -ef | grep nginx

八、上传测试文件

创建测试文件：

echo "fastdfs test" > test.txt

上传：

/usr/bin/fdfs_upload_file /etc/fdfs/client.conf test.txt

返回：

group1/M00/00/00/wKgC7Wmz0KeAA-gQAAAADUid9Xg917.txt

九、浏览器访问测试

访问：

http://192.168.2.237/group1/M00/00/00/wKgC7Wmz0KeAA-gQAAAADUid9Xg917.txt

成功返回：

fastdfs test

说明FastDFS + Nginx 成功部署。

十、你遇到的主要问题总结

问题1

编译 nginx 报错

fatal error: common_define.h: No such file or directory

原因

FastDFS 头文件引用方式：

#include "common_define.h"

gcc 默认不会进入：

/usr/include/fastcommon

解决

复制头文件：

cp /usr/include/fastdfs/*.h /usr/include/ cp /usr/include/fastcommon/*.h /usr/include/

问题2

编译报错

fatal error: fdfs_define.h: No such file or directory

原因

FastDFS 头文件路径不在 gcc 默认路径。

解决

复制头文件：

cp /usr/include/fastdfs/*.h /usr/include/

问题3

浏览器访问 FastDFS 文件失败

原因：

/etc/fdfs/mod_fastdfs.conf 为空

nginx 模块无法读取配置。

解决

复制配置：

cp /usr/local/src/fastdfs-nginx-module/src/mod_fastdfs.conf /etc/fdfs/

并正确配置 tracker 和 storage。

问题4

nginx 访问文件 404

原因：

缺少 storage 软链接。

解决

ln -s /data/fastdfs/storage/data /data/fastdfs/storage/data/M00

问题5

nginx 启动后访问失败

原因：

缺少：

http.conf mime.types

解决

复制：

cp fastdfs/conf/http.conf /etc/fdfs/ cp fastdfs/conf/mime.types /etc/fdfs/

十一、最终目录结构

/usr/local/nginx /etc/fdfs /data/fastdfs

FastDFS 文件：

/data/fastdfs/storage/data/M00/00/00/xxx

访问地址：

http://服务器IP/group1/M00/00/00/xxx

十二、最终架构

浏览器 │ │ HTTP ▼ Nginx │ │ ngx_fastdfs_module ▼ FastDFS Storage │ ▼ 文件数据