dromara/x-file-storage
一行代码将文件存储到 本地、FTP、SFTP、WebDAV、谷歌云存储、阿里云OSS、华为云OBS、七牛云Kodo、腾讯云COS、百度云 BOS、又拍云USS、MinIO、 AWS S3、FastDFS、 Azure Blob Storage、金山云 KS3、美团云 MSS、京东云 OSS、天翼云 OOS、移动云 EOS、沃云 OSS、 网易数帆 NOS、Ucloud US3、青云 QingStor、平安云 OBS、首云 OSS、IBM COS、其它兼容 S3 协议的平台。后续即将支持 Samba、NFS observed · 2026-08-28
Health v2 · maintenance only
59/100
- Activity 81
- Release rhythm 8
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-02. Adoption (stars, forks) is never an input.
- gap_med: n/a
- age_days: 2086
- days_rel: 437
- days_push: 118
- n_releases_24m: 1
Adoption not part of the score
2213 stars · 328 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
A Java library (part of the Dromara ecosystem) that lets developers store files to local disk, FTP/SFTP, WebDAV, and dozens of cloud object storage platforms (Alibaba OSS, Tencent COS, AWS S3, MinIO, Azure Blob, etc.) with a single line of code. It provides a unified API over heterogeneous storage backends and supports migrating files between platforms.
Use cases
- upload files to aliyun oss from a spring boot app
- switch between s3 and minio without changing code
- store uploaded files to ftp or webdav in java
- migrate files between cloud storage providers
- unified file storage api for multiple cloud providers
- save files to tencent cos with one line of code
When to choose
- you're building a Java/Spring application that needs to support multiple or swappable storage backends
- you want one consistent API over local disk, FTP, WebDAV, and S3-compatible clouds
- you need to migrate files between storage platforms
When to avoid
- you're not on the JVM (this is a Java library)
- you only ever target a single storage provider and prefer its official SDK directly
- you need streaming or very large-file handling features beyond what the library exposes
Facets
library · maturity active
file-upload object-storage sdk developer-tools files backend web-development cloud-computing developer-tools jvm cross-platform file-storage abstraction-layer s3-compatible spring-boot multi-cloud dromara spring
2 sources
- readme: https://github.com/dromara/x-file-storage · fetched 2026-08-28 · c9edf492d836
- homepage: https://x-file-storage.xuyanwu.cn/ · fetched 2026-08-29 · a700e9023392
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| dromara/x-file-storage | main | 59 |
For agents
markdown · JSON · MCP: product_card(name="dromara/x-file-storage")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem