---
title: "快照仓库路径配置"
date: 2026-03-14
lastmod: 2026-03-14
description: "控制快照仓库存储路径的配置说明"
tags: ["路径配置", "快照", "仓库"]
summary: "配置项作用 #  path.repo 配置项指定共享文件系统仓库的位置，用于存储快照数据。
是否可选 #  是
默认值 #  [] (空列表) 配置项类型 #  静态配置 - 需要重启节点才能生效
配置格式 #  # 单个仓库路径 path.repo: - /backup/easysearch # 多个仓库路径 path.repo: - /backup/easysearch - /mnt/backup/easysearch - /data/snapshots 工作原理 #  快照仓库存储位置：
┌─────────────────────────────────────────────────────────┐ │ 快照仓库 │ └─────────────────────────────────────────────────────────┘ path.repo 配置的路径 │ ├── 存储快照文件 ├── 存储元数据 └── 存储索引信息 │ ▼ 创建快照仓库 PUT _snapshot/backup_repo { "type": "fs", "settings": { "location": "/backup/easysearch/backup_repo" } } 推荐设置 #     环境 推荐值 说明     生产环境 专用备份路径 独立存储   高可用 共享存储路径 多节点访问   测试环境 临时路径 开发测试    使用示例 #  单路径配置："
---


## 配置项作用

`path.repo` 配置项指定共享文件系统仓库的位置，用于存储快照数据。

## 是否可选

是

## 默认值

```
[] (空列表)
```

## 配置项类型

**静态配置** - 需要重启节点才能生效

## 配置格式

```yaml
# 单个仓库路径
path.repo:
  - /backup/easysearch

# 多个仓库路径
path.repo:
  - /backup/easysearch
  - /mnt/backup/easysearch
  - /data/snapshots
```

## 工作原理

快照仓库存储位置：

```
┌─────────────────────────────────────────────────────────┐
│                   快照仓库                                │
└─────────────────────────────────────────────────────────┘

path.repo 配置的路径
    │
    ├── 存储快照文件
    ├── 存储元数据
    └── 存储索引信息
        │
        ▼
    创建快照仓库
    PUT _snapshot/backup_repo
    {
      "type": "fs",
      "settings": {
        "location": "/backup/easysearch/backup_repo"
      }
    }
```

## 推荐设置

| 环境 | 推荐值 | 说明 |
|------|--------|------|
| 生产环境 | 专用备份路径 | 独立存储 |
| 高可用 | 共享存储路径 | 多节点访问 |
| 测试环境 | 临时路径 | 开发测试 |

## 使用示例

**单路径配置：**

```yaml
path.repo:
  - /backup/easysearch
```

**多路径配置：**

```yaml
path.repo:
  - /backup/easysearch
  - /mnt/nfs/backup
```

## 创建仓库

```json
// 创建快照仓库
PUT _snapshot/backup_repo
{
  "type": "fs",
  "settings": {
    "location": "/backup/easysearch/backup_repo"
  }
}
```

## 配置验证

```bash
# 查看当前配置
GET /_nodes/settings?filter_path=nodes.*.path.repo

# 验证仓库路径
POST _snapshot/backup_repo/_verify
```

## 安全建议

1. **权限设置**：确保 Easysearch 有读写权限
2. **磁盘空间**：确保有足够空间存储快照
3. **备份策略**：制定定期快照计划
4. **路径隔离**：使用独立路径存储快照

## 注意事项

1. **静态配置**：修改需要重启节点
2. **必须设置**：使用快照功能前必须配置
3. **路径存在**：确保路径存在且可访问
4. **多节点**：集群节点都应配置相同路径
5. **共享存储**：建议使用共享存储系统

## 相关配置项

| 配置项 | 默认值 | 说明 |
|-------|-------|------|
| `path.data` | [] | 数据存储路径 |
| `path.logs` | logs | 日志存储路径 |

## 完整配置示例

```yaml
# easysearch.yml

# 路径配置
path.data:
  - /data/easysearch
path.logs: /var/log/easysearch
path.repo:
  - /backup/easysearch
```