一、核心概念
| 概念 | 说明 |
| 挂载点配置（Config） | 集群级别的配置模板，定义挂载点的运行参数 |
| 配置 ID | 配置的唯一标识符，创建时系统自动生成 |
| 名称 / 描述 | 用户自定义的配置名称和描述 |
| 配置项 | Key-Value 配置参数列表，用于控制挂载点行为 |
| 配置方案 | 系统预置的配置模板方案（默认配置、归档写入方案、混合读写均衡方案） |
二、前提条件
已 创建 MountPoint 集群。
三、创建挂载点配置
1. 登录 GooseFS MountPoint 控制台，在左侧导航栏选择 MountPoint > 集群管理，点击目标集群名称，进入详情页。
2. 在左侧导航栏选择客户端挂载，切换到配置管理标签页。
3. 在配置管理页面，单击新建配置。
4. 在新建配置弹窗中填写如下配置信息。
5. 如需添加自定义配置项，单击添加配置项。
6. 单击创建完成操作。
7. 创建成功后可查看配置 ID，后续创建挂载点时可引用此配置。
四、更新挂载点配置
1. 在配置列表中找到目标配置。
2. 单击操作列的编辑。
3. 修改配置名称、描述或配置项。
4. 单击保存完成更新。
注意：更新配置后，已引用该配置的运行中挂载点不会自动生效，需重启挂载点实例才能应用新配置。
五、查看配置列表
1. 登录 GooseFS MountPoint 控制台，进入目标集群详情页。
2. 在左侧导航栏选择客户端挂载，切换到配置管理标签页。
3. 页面展示该集群下所有挂载点配置，包括配置 ID、名称 / 描述、绑定挂载点数、更新时间、操作等信息。
六、删除挂载点配置
1. 在配置列表中找到目标配置。
2. 单击操作列的删除。
3. 在确认弹窗中单击确定，完成挂载点配置删除。
注意：如果有挂载点实例正在引用该配置（绑定挂载点数 > 0），删除将失败，请先解绑或删除相关挂载点实例。
七、常用配置项
以下为默认配置方案中的常用配置项：
| 配置项 | 类型 | 是否必选 | 说明 | 示例值 |
| app-name | String | 是 | 应用名称，用于标识挂载点所属的业务应用 | my-app |
| logging.file-path | String | 是 | 日志文件输出路径 | /var/log/goosefs/ |
| logging.format | String | 是 | 日志输出格式，可选值：text / json | json |
| logging.severity | String | 是 | 日志级别，可选值：DEBUG（调试） / INFO（信息） / WARN （告警）/ ERROR（错误） | INFO |
| file-cache.cache-dir | String | 是 | 本地缓存目录路径 | /data/cache |
| file-cache.max-size-mb | Integer | 是 | 本地缓存大小上限，单位为 MB。取值范围：>= -1（-1 表示不限制空间大小） | 10240 |
| file-system.temp-dir | String | 是 | 临时文件目录路径 | /tmp/goosefs |
| file-system.fuse-options | String | 是 | FUSE 挂载选项，多个选项以逗号分隔 | allow_other |
| foreground | Boolean | 是 | 是否前台运行，设为 true 时进程不会后台守护 | false |
八、归档写入方案配置项
归档写入方案适用于大规模数据归档场景（如日志归档、冷数据沉降），优化写入吞吐并降低缓存占用。在默认配置基础上，该方案调整了以下配置项：
| 配置项 | 类型 | 是否必选 | 说明 | 示例值 |
| write-buffer.size-mb | Integer | 是 | 写入缓冲区大小，单位为MB。增大可提升顺序写入吞吐。取值范围：>= 1 | 128 |
| write-buffer.flush-interval-ms | Integer | 是 | 写入缓冲区刷新间隔，单位为毫秒。控制数据持久化频率。取值范围：>= 1 | 5000 |
| file-cache.enabled | Boolean | 是 | 是否启用本地读缓存。归档场景以写入为主，可关闭以节省磁盘 | false |
| write-buffer.concurrent-uploads | Integer | 是 | 并发上传数，控制同时向后端存储写入的并行度。取值范围：[1, 10000] | 4 |
| file-system.write-type | String | 是 | 写入类型，可选值：THROUGH（直写）/ BACK（回写）/ ARCHIVE（归档写入） | ARCHIVE |
| file-system.kernel-list-cache-ttl-secs | Integer | 是 | 操作系统内核目录 entry 在 page cache 中的缓存时长，超过后在下次 opendir 请求时重新校验。-1 表示不过期。单位：秒。取值范围：>= 0 或 -1 | 60 |
| process.runtime.memory-limit-mb | Integer | 是 | 进程内存软上限（非硬上限），超过该阈值会加速内存垃圾回收。-1 表示不设置上限。单位：MB。取值范围：>= 256 或 -1 | 2048 |
| file-system.enable-streaming-writes | Boolean | 是 | 是否采用内存流式写入模式。true 表示使用内存流式写入（性能高效但不支持随机写），false 表示采用磁盘文件写入模式 | true |
九、混合读写均衡方案配置项
混合读写均衡方案适用于读写混合型工作负载（如 AI 训练数据读取 + checkpoint 写入），在读缓存和写入性能之间取得平衡。在默认配置基础上，该方案调整了以下配置项：
| 配置项 | 类型 | 是否必选 | 说明 | 示例值 |
| file-cache.enabled | Boolean | 是 | 是否启用本地读缓存，开启后热数据可从本地磁盘读取 | true |
| file-cache.max-size-mb | Integer | 是 | 本地缓存大小上限，单位为 MB。根据磁盘容量和数据集大小配置。取值范围：>= -1（-1 表示不限制空间大小） | 51200 |
| file-cache.eviction-policy | String | 是 | 缓存淘汰策略，可选值：LRU（最近最少使用）/ LFU（最不经常使用） | LRU |
| write-buffer.size-mb | Integer | 是 | 写入缓冲区大小，单位为 MB。平衡读写场景下适当调大。取值范围：>= 1 | 64 |
| file-system.read-type | String | 是 | 读取类型，可选值：CACHE（优先缓存读）/ NO_CACHE（直读后端） | CACHE |
| file-system.write-type | String | 是 | 写入类型，可选值：THROUGH（直写）/ BACK（回写） | THROUGH |
| file-system.kernel-list-cache-ttl-secs | Integer | 是 | 操作系统内核目录 entry 在 page cache 中的缓存时长，超过后在下次 opendir 请求时重新校验。-1 表示不过期。单位：秒。取值范围：>= 0 或 -1 | 60 |
| process.runtime.memory-limit-mb | Integer | 是 | 进程内存软上限（非硬上限），超过该阈值会加速内存垃圾回收。-1 表示不设置上限。单位：MB。取值范围：>= 256 或 -1 | 2048 |
| mem-cache.capacity-blocks | Integer | 是 | 内存缓存（mem-cache）占用缓存块的最大数量，0 代表不启用 mem-cache。单位：个。取值范围：[0, 65536] | 256 |
十、相关接口
| 接口名称 | 功能 |
| CreateClusterNodeMountPointConfig | 创建集群挂载点配置 |
| ListClusterNodeMountPointConfigs | 列出集群下所有挂载点配置 |
| DescribeClusterNodeMountPointConfig | 查询配置详情 |
| UpdateClusterNodeMountPointConfig | 更新挂载点配置 |
| DeleteClusterNodeMountPointConfig | 删除挂载点配置 |