跳转到内容
主页 / 套件 / 文件
FilesFILES

每个文件都是一个 URL

统一 HTTP 接口,支持本地存储与 60+ 云服务商——Google Drive、S3、Dropbox 及更多。挂载一次,永久访问。

hoody-files · 通用存储访问

# Google Drive

$ curl /api/v1/files/Work/report.pdf \

?backend=backend_drive_abc

# Amazon S3

$ curl /api/v1/files/backups/data.zip \

?backend=backend_s3_xyz

# Dropbox

$ curl /api/v1/files/Photos/vacation.jpg \

?backend=backend_dropbox_123

# 相同 URL 模式

HTTP/1.1 200 OK

Content-Type: application/pdf

Content-Length: 524288

# 不同存储后端

HTTP/1.1 200 OK

Content-Type: application/zip

ETag: "a3f2bc..."

相同 URL 模式。不同存储后端。零复杂度。

主页 / 套件 / 文件 / 后端
60+ 服务商

连接任意存储,即刻生效

挂载 Google Drive、S3、Dropbox 及 60+ 服务商。每个后端只需认证一次,之后通过统一 HTTP 接口访问所有内容。

Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
主页 / 套件 / 文件 / 协议
文件协议

兼容所有存储协议

FTP、SFTP、SMB、WebDAV、HTTP 与 HDFS——使用基础设施已有的协议挂载网络存储。

FTP端口 21
SFTP端口 22
SMB端口 445
WebDAVNextcloud / SharePoint
HTTPWeb 文件服务器
HDFSHadoop 集群
主页 / 套件 / 文件 / 能力
能力

不止文件托管

流式传输、哈希校验、归档预览、压缩下载、日志记录、图像处理——全部通过统一 HTTP 接口,适用于所有后端。

读取与流式传输

通过 HTTP 从本地存储或任意挂载的云后端流式传输文件,支持 HTML、JSON 及纯文本响应格式。

GET /api/v1/files/[path]

SHA256 完整性校验

无需下载完整文件即可计算 SHA256 或 MD5 哈希值,适用于生产部署验证、备份核对与合规场景。

GET /api/v1/files/[path]?hash

归档预览

无需解压即可检视 .tar.gz 和 .zip 内容,即时列出条目、大小与路径。

GET /[path]?preview

目录打包为 .zip

按需将任意目录下载为 .zip 归档,本地存储与远程云后端均适用。

GET /[path]?zip

文件日志与历史记录

每次变更均记录内容可寻址的 blob 快照,可读取任意历史版本或时间戳的文件,并支持版本对比。

GET /api/v1/files/[path]?history

图像处理

对 JPEG、PNG、WebP、GIF 和 BMP 进行即时缩放、格式转换、模糊与灰度处理——支持所有存储后端。

GET /[image]?thumbnail&width=400
主页 / 套件 / 文件 / API
API 参考

21 个接口。统一界面。

读取、写入、管理后端、监控日志——全部通过简单 HTTP 暴露,无需 SDK。

读取与下载

[count, plural, =1 [# 个接口] other [# 个接口]]'

curl .../api/v1/files/Work/report.pdf?backend=backend_drive

GET
/api/v1/files/[path]读取或下载文件内容
GET
/[path]支持 HTML/JSON/简单格式的替代接口
HEAD
/api/v1/files/[path]无需下载即可获取元数据
GET
/api/v1/files/[path]?hash获取文件 SHA256 哈希值
GET
/[path]?preview预览归档内容(tar.gz、zip)
GET
/[path]?zip将目录下载为 .zip 归档

写入与变更

[count, plural, =1 [# 个接口] other [# 个接口]]'

POST .../api/v1/files/copy/[path]?copy_to=/backup/

PUT
/[path]上传文件至服务器存储
POST
/api/v1/files/[path]文件操作:mkdir、解压、移动、复制
POST
/api/v1/files/copy/[path]将文件或目录复制到新位置
POST
/api/v1/files/move/[path]移动或重命名文件至新路径
DELETE
/[path]删除文件或目录
GET
/[directory]?q搜索符合条件的文件

后端管理

[count, plural, =1 [# 个接口] other [# 个接口]]'

POST .../api/v1/backends/drive → [id: "backend_drive_abc"]

POST
/api/v1/backends/[type]挂载存储后端
GET
/api/v1/backends列出所有已挂载的后端
GET
/api/v1/backends/[id]获取后端详情
GET
/api/v1/backends/[id]/test测试后端连接
DELETE
/api/v1/backends/[id]断开后端连接

系统与日志

[count, plural, =1 [# 个接口] other [# 个接口]]'

GET .../api/v1/journal?path=src/&op=write

GET
/__hoody-files__/health服务健康状态
GET
/api/v1/downloads列出活跃下载任务
GET
/api/v1/extractions列出活跃解压任务
GET
/api/v1/journal查询文件变更日志
主页 / 套件 / 文件 / 后端矩阵
后端类型

覆盖所有后端类别

四大存储类别,统一 HTTP 接口。任意组合挂载,通过同一 URL 模式访问所有内容。

类别
服务商
挂载类型
认证方式
云存储
31 个服务商,包括 Google Drive、Dropbox、OneDrive、Box
虚拟文件系统
OAuth / API Key
对象存储
S3、Azure Blob、GCS、B2、Cloudflare R2 及 25+ S3 兼容服务商
Bucket 路径
IAM / Access Key
文件协议
FTP、SFTP、SMB、WebDAV、HTTP、HDFS
网络路径
密码 / 密钥 / 匿名
特殊
Cache、Chunker、Combine、Crypt、Compress
分层
继承自底层后端
主页 / 套件 / 文件 / 开始

每个文件都是一个 URL

通过统一 HTTP 接口,即刻开始读取、哈希校验和管理 60+ 服务商的文件。Files 随每个 Hoody 容器预装。

阅读文档