visionpsn/seaweedfs

SeaweedFS 分布式文件系统镜像

镜像概述

SeaweedFS是一个Apache许可的开源分布式文件系统，核心目标是存储数十亿文件和快速服务文件。它摒弃了完整的POSIX语义，采用Key-File映射模式（类似NoSQL的"NoFS"），将元数据分散到卷服务器而非集中管理，从而实现低延迟访问（仅需一次磁盘读取）。

核心功能

• 灵活复制策略：支持无复制或多级别复制，支持机架/数据中心感知。
• 高可用性：主服务器自动故障转移，无单点故障（SPOF）。
• 性能优化：自动Gzip压缩（基于文件类型）、后台自动压缩回收磁盘空间。
• 扩展能力：添加/移除服务器无需数据重平衡，支持不同配置的节点混合部署。
• 附加功能：可选filer服务提供目录结构、JPEG图片方向自动修复、Etag/Range支持、多存储引擎（内存/LevelDB/BoltDB等）。

使用场景

• 大规模用户文件上传存储（如社交平台、内容管理系统）。
• 低延迟媒体文件服务（如图片、视频CDN）。
• 分布式应用的数据存储层（如日志、备份文件）。

配置与部署示例

Docker快速部署

1. 启动主服务器

bash
docker run -d --name seaweedfs-master -p 9333:9333 visionpsn/seaweedfs master

2. 启动卷服务器

bash
# 卷服务器1（挂载本地目录/tmp/data1）
docker run -d --name seaweedfs-volume-1 -p 8080:8080 -v /tmp/data1:/data \
  visionpsn/seaweedfs volume -dir=/data -max=5 -mserver=seaweedfs-master:9333 -port=8080

# 卷服务器2（挂载本地目录/tmp/data2）
docker run -d --name seaweedfs-volume-2 -p 8081:8081 -v /tmp/data2:/data \
  visionpsn/seaweedfs volume -dir=/data -max=10 -mserver=seaweedfs-master:9333 -port=8081

3. 文件操作示例

分配文件ID

bash
curl -X POST http://localhost:9333/dir/assign
# 响应示例：{"count":1,"fid":"3,01637037d6","url":"127.0.0.1:8080","publicUrl":"localhost:8080"}

上传文件

bash
curl -X PUT -F file=@/path/to/your/file.jpg http://127.0.0.1:8080/3,01637037d6

读取文件

bash
# 直接访问（添加扩展名可选）
curl http://127.0.0.1:8080/3,01637037d6.jpg

# 图片缩放（可选参数：height/width/mode）
curl http://127.0.0.1:8080/3,01637037d6.jpg?height=200&width=200&mode=fit

删除文件

bash
curl -X DELETE http://127.0.0.1:8080/3,01637037d6

注意事项

• 卷服务器的-dir参数需映射到持久化存储目录，避免容器重启数据丢失。
• 生产环境建议配置多主服务器实现故障转移，确保高可用性。
• 根据业务需求选择合适的复制策略（如001表示同机架复制，100表示跨数据中心复制）。
• 可通过filer服务（docker run ... filer）提供标准目录结构访问。