概述

目录策略是一种面向特定目录及其子文件的统一精细化管理机制，可按规则对目录内文件进行统一管控与观测。当前支持配置：

• 元数据缓存策略：可通过设置缓存模式，实现元数据访问时过期刷新或永不过期。
• 缓存可用性策略：可通过设置缓存副本数，提升数据读写的命中率与稳定性。

在极速文件缓存RapidFS中，以对象存储BOS中的数据为持久化存储底座，RapidFS作为缓存层提升数据访问性能。但在实际场景中，BOS数据可能被频繁更新，同一桶下不同路径的数据更新节奏差异较大，且数据常由其他系统或客户端直接写入BOS，容易导致缓存侧与后端状态不一致。若一味强调性能或一致性，都会带来元数据访问开销过高或缓存长期过期的问题。为此，RapidFS目录策略支持元数据缓存策略：可根据业务需求选择“缓存定期更新”或“缓存永不过期”两种模式。前者在达到设定更新时间后，会在下一次访问时自动从BOS拉取最新元数据，在性能与元数据新鲜度之间取得平衡；后者则不再自动更新元数据，适用于更新极少、对实时性要求不高的目录，以进一步降低后端访问与刷新开销。

在极速文件缓存RapidFS中，可依托计算节点本地高速存储介质，将BOS数据预热至节点本地以提升读取性能。但当计算节点作为缓存节点时，可能面临以下问题：节点频繁移入移出导致命中率波动；节点间网络质量不稳定甚至掉线断连导致命中率下降；以及本地缓存容量有限带来的容量压力。为此，RapidFS目录策略支持按目录配置副本数：同一份数据可在多个缓存节点保存副本，从而在节点变更或网络异常场景下，提高数据读写命中率与整体稳定性。同时，可依据数据访问频率对不同目录差异化设置副本数（热点目录提高副本数、非热点目录降低副本数），在性能与容量开销之间取得平衡。

注意事项

1. 在2026年9月1号之前创建的RapidFS实例中，其数据源不支持设置目录策略。
2. 每个数据源下的单个目录，只能添加一条自定义策略。

操作步骤

创建目录策略

1. 登录极速文件缓存RapiFS控制台。
2. 可通过以下任一方式进入“目录策略”页面，点击添加自定义策略：

• 在左侧导航栏选择实例，点击目标实例名称进入“实例详情页”，在“数据源管理”列表中找到目标数据源，于其操作栏中点击目录策略。
• 在左侧导航栏选择数据源，在“数据源”列表中找到目标数据源，于其操作栏中点击目录策略。
• 在左侧导航栏选择目录策略，选择目标实例和数据源。

3. 在“添加自定义策略”对话框中，配置如下参数。

参数	说明
数据源	显示当前添加自定义策略目录所在的数据源名称和数据源ID。
目录	请输入绝对路径，以 / 开头且 / 结尾的路径，中间路径使用 / 分隔，路径总长度不超过1024个字符。
策略描述	请输入策略描述信息，字符限制为65个。
元数据缓存策略	支持继承自父目录或自定义策略。 继承自父目录：继承自父目录的缓存模式。 自定义策略：文件元数据可能发生变更，可自行设置缓存模式。 1.若设置为“缓存定期更新”，到达更新时间后，RapidFS会在下一次访问时自动拉取最新元数据（目前暂不支持通过readdir触发刷新）；定期更新时间最小可设置1分钟，最大可设置1年。 2.若设置为“缓存永不过期”，元数据将不再自动更新，如需更新，请前往「数据流转 - 元数据同步」手动发起同步。
读缓存可用性策略	支持继承自父目录或自定义策略。 继承自父目录：继承自父目录的副本数。 自定义策略：可自行设置副本数，范围为1至3个副本。

4. 点击确认。

查询目录策略

在“目录策略”页面，可以按实例和数据源查询其下设置的全部自定义策略，并支持按配置策略进行筛选。查询到对应自定义策略后，可以查看数据源名称、数据源ID、自定义策略目录、自定义策略描述、策略概览等信息。

编辑目录策略

在“目录策略”页面，点击目标目录即可查看策略详情。可以编辑策略描述、设置读缓存可用性策略或恢复默认策略。

说明：

1. 恢复默认策略，是将当前目录设置的自定义策略清除，并重新继承父目录的策略。完成恢复默认策略或设置为继承自父目录后，该目录将不再保留自定义策略，也不再显示在目录策略页面中。
2. 若某个目录策略下所有子目录策略皆继承自父目录，那么该自定义目录策略将不再显示在目录策略页面中。

常见问题

1. 为什么自定义目录策略未操作“恢复默认策略”，自定义目录策略不见了？

答：若一目录策略下所有子策略皆设置为继承自父目录，此自定义目录策略将不再展示