FastDFS安装需先装gcc、make、libevent-devel（CentOS）或libevent-dev（Ubuntu）及libpcre3-dev，确认/usr/include/event.h存在；tracker/storage的base_path和store_path0须手动创建并设正确权限与属主；storage.conf中tracker_server必须用IP:22122，禁用localhost；启动失败优先查trackerd.log、storaged.log和系统日志；Nginx需重启（非reload）以加载mod_fastdfs.conf变更，且url_have_group_name=true、store_path0路径须严格匹配。
FastDFS服务端安装前必须确认的依赖项
FastDFS 6.x 版本不再自带 libfastcommon，必须单独编译安装，否则 make 会报 libfastcommon.so: cannot open shared object file。CentOS 7/8 和 Ubuntu 20.04+ 都需提前装好 gcc、make、libevent-devel（或 libevent-dev），Ubuntu 还要额外装 libpcre3-dev。
常见漏掉的是 libevent 的开发包——只装 libevent 运行时库不够，fastdfs-nginx-module 编译时会卡在 event.h: No such file or directory。
- CentOS：运行
yum install -y gcc make libevent-devel pcre-devel - Ubuntu：运行
apt-get install -y build-essential libevent-dev libpcre3-dev - 确认
/usr/include/event.h存在，不存在说明libevent-devel没装对
tracker 和 storage 服务配置的关键路径与权限
FastDFS 默认不创建数据目录，启动失败十有八九是路径不存在或权限不对。tracker.conf 中的 base_path 和 storage.conf 中的 base_path、store_path0 必须手动 mkdir -p，且属主必须是运行 fastdfs 进程的用户（通常为 fdfs 或 root）。
特别注意：storage.conf 里的 tracker_server 必须写成 IP:22122 形式，不能用 localhost 或 127.0.0.1（storage 启动后要主动连 tracker，本地回环地址会导致跨机器部署失败）。
-
base_path建议统一设为/fastdfs/tracker和/fastdfs/storage，避免路径含空格或中文 - 执行
chown -R fdfs:fdfs /fastdfs（如果用fdfs用户运行），或确保run_by_group/run_by_user与实际一致 - 检查
storage.conf中group_name=group1与后续上传命令中的 group 名严格匹配，大小写敏感
启动失败时最该查的三个日志文件
FastDFS 不输出控制台错误，所有线索都在日志里。别急着重装，先看这三处：
-
/fastdfs/tracker/logs/trackerd.log：tracker 启动失败？重点搜ERROR和bind addr fail（端口被占） -
/fastdfs/storage/logs/storaged.log：storage 连不上 tracker？搜connect to tracker server failed，再确认tracker_server地址和防火墙（firewall-cmd --list-ports看 22122/23000 是否放行） -
/var/log/messages（CentOS）或/var/log/syslog（Ubuntu）：SELinux 或 systemd 报错，比如Permission denied却没开 SELinux 上下文
一个典型现象：storaged.log 里反复出现 network error, errno: 111，基本等于 tracker 没起来，或 IP/端口配错了。
测试上传时 curl 返回 500 或超时的直接原因
用 fdfs_upload_file 成功不代表 HTTP 访问通。如果你配了 nginx + fastdfs-nginx-module，但 curl http://ip/group1/M00/xx 返回 500 或连接拒绝，问题一定出在 nginx 配置上。
关键点：mod_fastdfs.conf 中的 tracker_server 必须和 storage 的配置一致；url_have_group_name=true 要开启（否则 Nginx 找不到 group 目录）；store_path0=/fastdfs/storage 必须和 storage.conf 里的 store_path0 完全相同（包括结尾斜杠与否）。
- Nginx 的
location ~/group[0-9]/M00块必须加载fastdfs-nginx-module，且放在server块内 - 改完
mod_fastdfs.conf后，必须重启nginx，不是 reload —— 模块参数只在启动时读取 - 上传后检查
/fastdfs/storage/data/00/00下是否有对应文件，没有说明 storage 没存进去，先别调 nginx
tracker 和 storage 是松耦合进程，Nginx 是另一层代理，三者日志互不相通，出问题必须分段验证：先确认 tracker/storaged 进程活着且日志无 ERROR，再确认文件真存到了磁盘，最后才查 Nginx 模块是否挂载成功。
