---
title: "规则数据库路径配置"
date: 2026-02-19
lastmod: 2026-02-19
description: "ruledb_path.repo 配置项用于定义规则数据库仓库目录的路径。"
tags: ["规则引擎", "路径配置", "插件配置"]
summary: "配置项作用 #  ruledb_path.repo 配置项用于定义规则数据库仓库目录的路径。
配置项属性 #   配置路径: ruledb_path.repo 数据类型: String（字符串路径） 默认值: {pluginsDir}/rules/output_db（插件目录下的 rules/output_db） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 是（可以动态更新，无需重启）  配置建议 #  默认配置 #  ruledb_path.repo: "${plugins.path}/rules/output_db" # 默认值 自定义路径 #  ruledb_path.repo: "/data/easysearch/rules/db" 独立存储路径 #  ruledb_path.repo: "/mnt/easysearch-storage/rules/repositories" 注意事项 #    动态更新: 此配置可以动态更新，更改后将影响新解析的数据库路径。
  路径解析: 系统会将实际数据库路径解析为 {repoPath}/{repoId}：
 repoPath: 显式配置的路径或自动检测的插件目录 repoId: 特定的仓库标识符    目录权限:
 确保 Easysearch 进程用户对配置的目录具有读写权限 目录必须预先创建或确保进程有创建权限    存储规划建议:"
---


## 配置项作用

`ruledb_path.repo` 配置项用于定义**规则数据库仓库目录的路径**。

## 配置项属性

- **配置路径**: `ruledb_path.repo`
- **数据类型**: `String`（字符串路径）
- **默认值**: `{pluginsDir}/rules/output_db`（插件目录下的 rules/output_db）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 是（可以动态更新，无需重启）

## 配置建议

## 默认配置

```yaml
ruledb_path.repo: "${plugins.path}/rules/output_db"  # 默认值
```

## 自定义路径

```yaml
ruledb_path.repo: "/data/easysearch/rules/db"
```

## 独立存储路径

```yaml
ruledb_path.repo: "/mnt/easysearch-storage/rules/repositories"
```

## 注意事项

1. **动态更新**: 此配置可以动态更新，更改后将影响新解析的数据库路径。

2. **路径解析**: 系统会将实际数据库路径解析为 `{repoPath}/{repoId}`：
   - `repoPath`: 显式配置的路径或自动检测的插件目录
   - `repoId`: 特定的仓库标识符

3. **目录权限**:
   - 确保 Easysearch 进程用户对配置的目录具有读写权限
   - 目录必须预先创建或确保进程有创建权限

4. **存储规划建议**:
   - 考虑使用独立于主插件目录的路径，便于管理和备份
   - 选择具有足够存储空间的磁盘位置
   - 在多节点集群中，可以使用共享存储或独立存储

5. **插件依赖**: 此配置由 Rules 插件使用，确保插件已正确安装和启用。

6. **路径格式**: 支持相对路径和绝对路径，建议使用绝对路径以避免歧义。