全部文档
当前文档
最近更新时间：2026-10-13 23:31:07
为避免由于误删除KPFS文件系统中的文件导致业务受阻或数据丢失，推荐您使用文件系统时开启回收站功能。开启回收站后，被删除的文件或目录将暂存在回收站目录中，并在规定的保留时间之后彻底删除。
支持产品类型及地域
容量Ⅰ型、容量Ⅱ型：华北1（北京）、西北3区（宁夏）、西北4（海东）、西北1（庆阳）、西北2（自用）
标准型：华北1（北京）
费用说明：回收站功能不收费，但进入回收站内的文件会占用文件系统的购买容量。
数据进入回收站的条件
配置文件系统回收站保留时间≥1天。
在挂载KPFS文件系统的计算节点删除文件系统中文件。
文件将被移入.trash虚拟目录。
空目录不会进入回收站。
软链接（独立文件，有自己的inode） ，删除软链接针对的是 “软链接文件本身”，删除后会进入回收站。
硬链接（原文件的inode引用别名，没有自己的inode），删除硬链接本质是 “减少 inode 的引用计数”，而非删除文件数据，在“最后一个引用该inode的硬链接被删除”时，原文件数据会进入回收站。
数据进入回收站的格式
按|作为目录的标识，起首的数字是inode；如果被删除的文件与回收站中已有的项目路径相同，则会在回收站中同时保存多个版本，inode不同。
如果有同名文件，会在后面加时间戳数字格式来做区分。
回收站.trash目录的命令行读写操作：不允许任何读写操作。
删除回收站数据
手动删除
单个/批量删除：通过KPFS控制台、调用OpenAPI、命令行。
清空数据：通过KPFS控制台、调用OpenAPI。
自动删除
根据文件系统配置的回收站保留时长及文件删除时间进行自动删除。
文件保留时长定义：始终遵循回收站当前设置的保留时长。
恢复回收站数据
单个/批量恢复：通过KPFS控制台、调用OpenAPI、命令行。
全部恢复：暂不支持。
恢复时连带恢复原始目录路径，但无法保持先前的目录属性。
1. 如果文件所在目录存在，则恢复至已存在目录即可。
2. 如果文件所在的目录不存在，以 root 用户身份自动逐级创建（类似sudo mkdir -p）。
3. 如果文件系统在恢复中存在相同路径的文件，那么恢复的文件名后会加一个时间戳消除冲突，比如 /a/b/c.txt 会恢复成 /a/b/c.txt_175689143749。
软链接恢复后，若原文件路径未变，软链接可正常使用；若原文件已删除，恢复后的软链接仍为死链接。
登录文件存储KPFS控制台。
在文件系统列表页面，单击文件系统名称。
在回收站-回收站详情-回收站状态，点击编辑：
参数 | 说明 |
回收站状态 |
|
保留天数 | 仅回收站状态为开启时支持设置，范围为1-30天。 |
点击确定，完成回收站设置。
登录文件存储KPFS控制台。
在文件系统列表页面，单击文件系统名称。
在回收站-回收站详情及文件列表，可以查看回收站内的文件信息。
参数 | 说明 |
文件总数 | 回收站内的文件总数量。 |
文件总大小 | 回收站内的文件总大小。 |
原目录名称 | 删除前原文件的目录路径名称。比如：dir/subdir。 |
大小 | 文件大小。 |
原文件名称 | 删除前原文件的名称。比如：file。 |
删除时间 | 该文件的删除时间，即进入回收站的时间。 |
操作 | 恢复：参考恢复回收站文件。 删除：参考删除回收站文件。 |
搜索 | 支持根据目录名称或文件名称关键字进行搜索。 |
登录文件存储KPFS控制台。
在文件系统列表页面，单击文件系统名称。
在回收站-文件列表-操作，点击恢复，进行单个文件恢复。
在回收站-文件列表，选择多个要恢复的文件，点击列表上方的恢复，进行批量文件恢复。
在弹出的对话框中，点击恢复，完成文件恢复。
登录文件存储KPFS控制台。
在文件系统列表页面，单击文件系统名称。
在回收站-文件列表-操作，点击删除，进行单个文件删除。
在回收站-文件列表，选择多个要删除的文件，点击列表上方的删除，进行批量文件删除。
在弹出的对话框中，点击删除，完成文件删除。
登录文件存储KPFS控制台。
在文件系统列表页面，单击文件系统名称。
在回收站-文件列表，点击列表上方的清空。
在弹出的对话框中，点击清空，完成回收站内文件清空。
清空后回收站中的文件会彻底删除，将无法找回，请谨慎操作。
纯净模式
