sjqzhang/go-fastdfs

go-fastdfs 分布式文件系统

镜像概述和主要用途

go-fastdfs 是一个基于 HTTP 协议的分布式文件系统，秉持"大道至简"的设计理念，一切从简设计，使其运维及扩展更加简单。它具有高性能、高可靠、无中心、免维护等优点，可作为企业级文件存储解决方案，适用于各类文件管理场景。

愿景：为用户提供最简单、可靠、高效的分布式文件系统。

核心功能和特性

核心功能

• 支持 curl 命令上传
• 支持浏览器上传
• 支持 HTTP 下载
• 支持多机自动同步
• 支持断点下载
• 支持配置自动生成
• 支持小文件自动合并（减少 inode 占用）
• 支持秒传
• 支持跨域访问
• 支持一键迁移（搬迁）
• 支持异地备份（特别是 1M 以下小文件）
• 支持并行体验
• 支持断点续传（基于 tus 协议）
• 支持 Docker 部署
• 支持自监控告警
• 支持图片缩放
• 支持 Google 认证码
• 支持自定义认证
• 支持集群文件信息查看
• 使用通用 HTTP 协议，无需专用客户端（支持 wget、curl 等工具）
• 类 FastDFS 架构
• 高性能（使用 LevelDB 作为 KV 库）
• 高可靠（设计简单，使用成熟组件）
• 无中心设计（所有节点可同时读写）

主要优点

• 无依赖（单一可执行文件）
• 自动同步，失败自动修复
• 按天分目录，方便维护
• 支持不同场景需求
• 文件自动去重
• 支持目录自定义
• 支持保留原文件名或自动生成唯一文件名
• 支持集群监控邮件告警
• 极低资源开销
• 支持 token 下载（token=md5(file_md5+timestamp)）
• 运维简单（仅单一角色，配置自动生成，无需 FastDFS 的 Tracker Server、Storage Server、Client 三个角色）
• 每个节点对等，简化运维
• 所有节点可同时读写

使用场景和适用范围

适用于需要分布式文件存储的各类场景，包括但不限于：

• 企业文件管理系统
• 图片、视频等媒体文件存储
• 日志文件集中存储
• 应用系统附件存储
• 对运维简单性、高可用性有需求的文件存储场景

使用方法和配置说明

极速体验（一分钟上手）

启动服务器

1. 下载已编译版本（https://github.com/sjqzhang/fastdfs/releases%EF%BC%89
2. 启动服务：

   bash
   ./fileserver  # 注意：线上环境请使用项目的 [control](https://github.com/sjqzhang/go-fastdfs/blob/master/control) 文件管理，直接运行关闭终端会退出
   

命令行上传

bash
curl -F file=@本地文件路径 http://服务器IP:8080/group1/upload

浏览器上传

在浏览器中打开：http://服务器IP:8080（注意：不要使用 127.0.0.1 上传）

详细文档和资源

• https://sjqzhang.github.io/go-fastdfs/#character
• 视频教程

注意事项

• 生产环境使用前建议运行单元测试和压力测试（项目自带测试用例）
• 如需技术交流，可加入 ***：964274270（go-fastdfs 技术交流群）
• 程序相关问题请直接提交 issues，不接受邮件、微信或 QQ 私信求助
• 如觉得项目有价值，欢迎点击项目顶部的 star 按钮关注项目