# sjqzhang/go-fastdfs

go-fastdfs 是一个简单的分布式文件系统(私有云存储)，具有无中心、高性能，高可靠，免维护等优点，支持断点续传，分块上传，小文件合并，自动同步，自动修复。Go-fastdfs is a simple distributed file system (private cloud storage), with no center, high performance, high reliability, maintenance free and other advantages, support breakpoint continuation, block upload, small file merge, automatic synchronization, automatic repair.(similar fastdfs).

Repository: https://github.com/sjqzhang/go-fastdfs
Canonical: https://ross.abutalabs.com/products/go-fastdfs
Homepage: https://gitee.com/sjqzhang/go-fastdfs
Language: Go
License: Unlicense
License Family: permissive
Topics: storage-servers, distributed-file-storage, distributed-file-system, godfs, file-system, go-fastdfs, fastdfs, breakpoint-resume, small-file-merge, tus, fileserver, sync, rsync, go, storage, cloudnative, cloud-storage, filesystem, oss, object-storage-service
Last push: 2026-07-11T15:20:17+00:00

## Health v2 (maintenance only)
Score: 64/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 8, longevity 100
- inputs: {"age_days": 2796, "days_push": 53, "days_rel": 712, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4135, forks 767 (observed 2026-08-28T04:08:36.195370+00:00)

## What it is
go-fastdfs is a decentralized, HTTP-based distributed file system (private cloud storage) written in Go, similar to FastDFS but with a single peer-to-peer role instead of tracker/storage separation. It supports resumable uploads (tus), chunked upload, small-file merging, automatic sync and repair, instant upload (dedup), and Docker deployment.

## Use cases
- self-host a private cloud file storage cluster
- replace FastDFS with a simpler maintenance-free file server
- store and serve images and files over HTTP with curl or browser uploads
- resumable large file uploads from the web
- reduce inode usage by merging small files
- set up a multi-node file store with automatic sync and repair
- migrate files from an existing file system to a distributed cluster

## When to choose
- you want a FastDFS-like system with far simpler operations (single role, no tracker)
- you need all cluster nodes to read and write simultaneously with automatic sync and repair
- you want plain HTTP access with standard tools like curl and wget, no special client
- you handle many small files and need merging, dedup, and instant upload
- you want Docker deployment and built-in monitoring with email alerts

## When to avoid
- you need S3-compatible APIs or rich object-storage features like lifecycle policies and versioning
- you need strong consistency guarantees or erasure coding like Ceph/MinIO provide
- you require POSIX file system semantics or mounting as a local filesystem
- you need a large community and frequent updates - development is mostly maintenance releases

## Facets
- artifact type: application
- maturity: stable
- function: object-storage, file-system, file-upload, http-server, monitoring, alerting, self-hosted
- domain: files, self-hosted, microservices, cloud-computing, developer-tools
- platform: windows, self-hosted, go
- tags: distributed-file-system, fastdfs, private-cloud-storage, tus-resumable-upload, file-sync, peer-to-peer-cluster, instant-upload, small-file-merge, linux, macos, docker, web-server

## Member repositories
- sjqzhang/go-fastdfs (main) score 64

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:36.195370+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:23:01.704538+00:00, confidence not recorded.
  - readme: https://github.com/sjqzhang/go-fastdfs (fetched 2026-08-28T04:08:36.195370+00:00, sha 701cb15a5c57)
  - homepage: https://gitee.com/sjqzhang/go-fastdfs (fetched 2026-08-29T09:14:51.014576+00:00, sha be4b9541e2bf)
  - site_page: https://gitee.com/about_us (fetched 2026-08-29T09:14:51.024443+00:00, sha 061b862ef0b5)
  - site_page: https://compass.gitee.com/docs/dimensions-define (fetched 2026-08-29T09:14:51.031512+00:00, sha d40c21975690)
  - site_page: https://gitee.com/all-about-git (fetched 2026-08-29T09:14:51.032935+00:00, sha fb606340594e)
  - site_page: https://gitee.com/features/gitee-go (fetched 2026-08-29T09:14:51.034546+00:00, sha bfa2599dcb24)
  - site_page: https://gitee.com/sjqzhang/go-fastdfs/releases (fetched 2026-08-29T09:14:51.028010+00:00, sha 0126fe110142)
  - site_page: https://gitee.com/sjqzhang/go-fastdfs/releases/tag/v1.4.7 (fetched 2026-08-29T09:14:51.029929+00:00, sha f89df599f768)
- Data as of 2026-08-30T08:39:29.467469+00:00.