进阶 docs.cloudreve.org 2026-10-17 18:46:57 · 25 阅读

第38章 File URI 规范解析

第38章 File URI

File URI Cloudreve 使用 File URI 来定位、操作文件,或描述文件搜索条件。

结构 Cloudreve 使用的 File URI 符合传统 URL 标准。将 File URI 解析为标准 URL 时,会得到以下组成部分: 该 URI 的含义是:使用密码 2rje2bdj 访问共享 ID 为 VoMFL 的共享链接,并列出所有文件名包含 my file 的文件夹/子目录下的文件。

协议 固定为 cloudreve。

Host - 文件系统类型 定义文件所在文件系统的类型。 my: 我的文件;默认指向当前认证用户的文件。你也可以填入其他用户的 ID 以访问他们的文件,例如 cloudreve://luPa@my。只有管理员可以通过 my 访问其他用户的文件。 shared_with_me: 与我共享; trash: 回收站;

User - 文件系统 ID Cloudreve 使用 User 部分指定文件系统 ID。 对于 my 文件系统,User 为用户 ID;若留空,则默认为当前认证用户的 ID。 对于 shared_with_me 文件系统,User 不能为空,且应为共享链接 ID。

Password - 文件系统密码 目前仅共享文件系统使用 Password 部分。当共享链接非公开时,需通过 Password 部分指定访问密码。Cloudreve 会生成密码,并直接将其包含在创建者获得的共享链接中。

Path - 文件路径 文件路径,用于指定文件在文件系统中的位置。

Query - 搜索条件 文件搜索条件,用于指定文件搜索条件,仅适用于列出文件的 API。对于操作特定文件(删除、更新等)的 API,此部分将被忽略。可用的 Query 参数:

Query 参数 | 描述 name | 搜索文件名,可指定多个关键词,例如 name=mp3&name=op6。 name_op_or | 当 name 查询参数存在且包含多个关键词时,可指定 name_op_or=true,表示文件名包含任意一个关键词。 use_or | 与 name_op_or 相同。 case_folding | 当 name 查询参数存在时,可指定 case_folding=true,表示搜索忽略大小写。 category | 使用预设搜索条件查询文件类型,可用值为 image、video、audio、document。设置此查询后,其他查询条件将被忽略。 type | 可用值为 file 或 folder,用于过滤文件类型。 meta_ | 使用文件 Metadata 查询文件, 为 Metadata 键,例如 meta_music:album=Deluxe,其中 Metadata 键精确匹配 music:album,且值包含 Deluxe(不区分大小写)。也可使用空值 meta_= 查询拥有指定 Metadata 键的所有文件。 exact_meta_ | 使用文件 Metadata 查询文件, 为 Metadata 键,例如 exact_meta_music:album=Deluxe,其中 Metadata 键精确匹配 music:album,且值必须精确匹配 Deluxe。 size_gte | 文件大小下限,仅在大于 0 时有效。 size_lte | 文件大小上限,仅在大于 0 时有效。 created_gte | 文件创建时间下限,Unix 秒级时间戳。 created_lte | 文件创建时间上限,Unix 秒级时间戳。 updated_gte | 文件更新时间下限,Unix 秒级时间戳。 updated_lte | 文件更新时间上限,Unix 秒级时间戳。

评论 (0)