用Docker部署FastDFS需先创建fastdfs-net网络、拉取delron/fastdfs镜像；再依次启动tracker（映射22122端口）和storage（映射8888端口，通过-e TRACKER_SERVER=tracker:22122注册）；最后用fdfs_test验证上传下载。
用 Docker 部署 FastDFS 不难，关键在理清 tracker 和 storage 的协作逻辑，以及网络、配置、挂载三者的配合。只要步骤对，10 分钟内就能跑通基础上传下载。
准备专用网络与镜像
FastDFS 依赖 tracker（调度中心）和 storage（存储节点）通信，推荐用自定义 bridge 网络，避免 host 模式在 macOS/Windows 上的兼容问题：
- 创建网络：docker network create fastdfs-net
- 拉取主流镜像：docker pull delron/fastdfs（x86_64 环境直接可用；ARM 用户需自行构建或换用 season/fastdfs）
- 确认镜像支持 HTTP 服务：storage 默认监听 8888 端口提供文件下载，该端口需映射且 storage.conf 中 http.server_port=8888 必须生效
启动 tracker 容器（调度节点）
tracker 是无状态中心，负责注册 storage、分发上传请求。首次运行会自动生成配置和日志目录：
- 命令示例：docker run -d --name tracker --network=fastdfs-net -v /opt/fastdfs/tracker:/var/fdfs -p 22122:22122 -t delron/fastdfs tracker
- /opt/fastdfs/tracker 是宿主机持久化路径，保存 conf、data、logs；容器内路径固定为 /var/fdfs
- 检查是否就绪：docker logs tracker 出现 "server started" 即成功
启动 storage 容器（存储节点）并完成注册
storage 启动后必须主动向 tracker 注册，注册成功才可服务。Docker 内通过容器名通信，前提是共用同一网络：
- 命令示例：docker run -d --name storage --network=fastdfs-net -v /opt/fastdfs/storage:/var/fdfs -e TRACKER_SERVER=tracker:22122 -p 8888:8888 -t delron/fastdfs storage
- -e TRACKER_SERVER=tracker:22122 是核心环境变量，不能写成 IP（否则跨主机部署易失效）
- 等待约 5 秒后验证注册状态：docker exec -it tracker fdfs_monitor /etc/fdfs/storage.conf，看到 state = ACTIVE 表示已上线
- 若显示 OFFLINE，请检查 storage 容器日志：docker logs storage，常见原因是 tracker 地址不通或端口未开放
上传测试与客户端配置
验证系统可用性，不需要写代码，用官方命令行工具即可：
- 进入 tracker 容器安装客户端：docker exec -it tracker bash -c "apt update && apt install -y fdfs-tools"
- 编辑 client 配置：echo "tracker_server=tracker:22122" > /etc/fdfs/client.conf
- 准备一个测试文件（如 test.jpg），执行上传：fdfs_test /etc/fdfs/client.conf upload test.jpg
- 成功返回类似 http://172.18.0.3:8888/group1/M00/00/00/wKgBZl-xxx.jpg，说明文件已存入 storage，且可通过 storage 的 8888 端口访问
