leaon/fastdfs

leaon/fastdfs 镜像文档

镜像概述

leaon/fastdfs是一个用于快速部署FastDFS分布式文件系统的Docker镜像。FastDFS是一款轻量级分布式文件系统，主要解决文件存储和访问问题。该镜像集成了FastDFS的Tracker（跟踪器）、Storage（存储节点）组件以及Nginx（用于HTTP文件访问），支持单节点部署，并提供数据目录挂载功能以实现数据持久化。

核心功能和特性

• 组件集成：包含Tracker、Storage和Nginx，可单独或同时启动
• 数据持久化：支持主机目录挂载，确保容器重启后数据不丢失
• 网络配置：通过环境变量PUBLICNET指定访问IP，适应本地或远程服务器环境
• 网络共享：使用--net=host模式共享宿主机网络，无需额外端口映射
• 灵活部署：支持仅启动Tracker、仅启动Storage或同时启动所有组件

使用场景

适用于需要轻量级分布式文件存储的应用场景，例如：

• 图片、文档等静态资源的存储与访问
• 开发或测试环境中的文件存储服务
• 对部署便捷性有较高要求的单节点文件存储需求

使用方法

1. 安装镜像

bash
docker pull leaon/fastdfs:0.0.5

2. 创建Tracker

Tracker是FastDFS的跟踪器，负责调度文件上传和下载。

默认创建

bash
docker run -di --name=tracker --net=host leaon/fastdfs:0.0.5 tracker

挂载目录创建（数据持久化）

bash
docker run -di -v /home/fdfs/tracker/:/home/fastdfs/tracker --name=tracker --net=host leaon/fastdfs:0.0.5 tracker

参数说明：

• -e PUBLICNET: 可选，远程服务器使用时需指定外网IP，本地使用时指定宿主机IP
• --net=host: 宿主机与容器共享网络，Tracker默认使用22122端口，Storage使用23000端口
• --restart=always: 可选，配置容器开机自动启动
• -v: 挂载主机目录到容器，实现数据持久化（示例中主机目录为/home/fdfs/tracker/）
• tracker: 启动Tracker服务的命令

注意：仅创建Tracker时，容器不会启动Storage和Nginx服务

3. 创建Tracker+Storage+Nginx

同时启动Tracker、Storage和Nginx服务，构成完整的文件存储与访问系统。

默认创建

bash
docker run -di -e PUBLICNET=192.168.211.3 --name=fdfs --net=host leaon/fastdfs:0.0.5 start

挂载目录创建（数据持久化）

bash
docker run -di -e PUBLICNET=192.168.211.3 -v /home/fdfs/storage/:/home/fastdfs/storage -v /home/fdfs/tracker/:/home/fastdfs/tracker --name=fdfs --net=host leaon/fastdfs:0.0.5 start

参数说明：

• start: 启动Tracker、Storage和Nginx服务的命令
• 192.168.211.3: 需替换为实际宿主机或服务器IP

4. 创建Storage

Storage是FastDFS的存储节点，负责实际文件存储，需配合Tracker使用。

默认创建

bash
docker run -di -e PUBLICNET=192.168.211.3 --name=storage --net=host leaon/fastdfs:0.0.5 storage

挂载目录创建（数据持久化）

bash
docker run -di -e PUBLICNET=120.27.2.108 -v /home/fdfs/tracker/:/home/fastdfs/storage --name=storage --net=host leaon/fastdfs:0.0.5 storage

参数说明：

• storage: 启动Storage和Nginx服务的命令
• 192.168.211.3/120.27.2.108: 需替换为实际宿主机或服务器IP

注意事项

• 单节点配置：上述命令均为单节点Storage配置，适用于简单场景
• 自定义配置：如需自定义配置或多节点部署，需将本地配置文件目录映射到容器的/etc/fdfs目录，命令示例：

  bash
  docker run -di -v <Your profile directory>:/etc/fdfs ... leaon/fastdfs:0.0.5 [tracker|storage|start]
  

  其中<Your profile directory>需替换为本地配置文件目录的绝对路径
• 必要配置文件：自定义配置时需包含以下文件：
  • client.conf
  • http.conf
  • mime.types
  • mod_fastdfs.conf
  • storage.conf
  • tracker.conf