Garage¶
将 Garage 集群——轻量级自建 S3 存储——上的存储桶挂载为 Windows 驱动器。
准备工作¶
请提前准备以下内容：
- 您 Garage 集群的 S3 服务端点 URL。
- 一对被授予目标存储桶访问权限的 访问密钥 ID 和秘密访问密钥。
- 为该集群配置的区域（Garage 的默认值为
garage）。
如何获取密钥——在管理该集群的机器上：
garage key create raidrive-key
garage bucket allow --read --write YOUR-BUCKET --key raidrive-key
第一条命令会打印出 Key ID 和 Secret key。
来自 Garage 的帮助
连接¶
- 点击工具栏上的添加。
- 选择Enterprise → Garage。
- 输入端点 URL、区域、访问密钥 ID 和秘密访问密钥，然后点击存储桶字段旁的刷新按钮。
- 选择存储桶并点击连接。
手动输入存储桶
如果您的密钥不允许列出存储桶，请勾选存储桶字段左侧的复选框，直接输入存储桶名称。
设置¶
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 端点 | Garage S3 API 的 URL | — |
| 区域 | 集群的区域值（请求签名所需） | — |
| 访问密钥 ID / 秘密访问密钥 | Garage 密钥对 | — |
| 存储桶 | 要挂载的存储桶（列表选择或手动输入） | — |
| 只读 | 阻止对已挂载驱动器的写入 | 关闭 |
行为与限制¶
- 连接使用路径风格寻址，并接受私有或自签名的 TLS 证书—— 适用于局域网和 homelab 部署。
故障排除¶
| 症状 | 原因 | 解决方法 |
|---|---|---|
| 签名错误 | 区域与集群配置不一致 | 将区域字段设置为集群的 s3_region 值 |
| 存储桶列表为空 | 该密钥未被授予该存储桶的权限 | 使用 garage bucket allow 授权该密钥，或手动输入存储桶名称 |