存储源与存储组
存储源负责连接实际存储；存储组决定一次上传使用哪些存储源。即使只使用本地磁盘，也需要创建一个包含该源的存储组，再交给上传配置使用。
添加本地存储
在 配置 → 存储源 点击创建，选择 本地存储，填写名称和根目录后保存。
根目录可填写 ./images，相对于应用数据目录解析，保存时转换为绝对路径。使用仓库提供的 Docker Compose 时，对应宿主机 ./data/app/images，重建容器后仍会保留。也可以填写服务进程可读写的绝对路径。
根目录是服务器或容器内的路径。若要使用宿主机上的其他磁盘，需要先将目录挂载到容器，再填写挂载后的容器路径。
保存后确认存储源显示“就绪”。这表示插件初始化成功；还需要完成一次上传和访问，验证实际读写权限。
添加 S3 兼容存储
先在存储服务中创建桶并取得访问凭证，然后在 配置 → 存储源 选择 S3 兼容存储。
| 字段 | 填写说明 |
|---|---|
| 端点 | 服务商提供的 S3 API 地址，包含 https://；不是桶的公开访问域名。AWS S3 可留空，由 SDK 根据区域选择 |
| 区域 | 必填，按存储服务商要求填写，无默认值 |
| 存储桶 | 已创建的桶名称，不含 URL 或目录 |
| 访问密钥 ID、访问密钥 | 对应服务的凭证；读写、删除和导入所需权限应覆盖相应操作 |
| 路径寻址 | 默认开启。按服务商对 path-style / virtual-hosted-style 的要求设置 |
| 对象前缀 | 可选，例如 picloom；不带开头或结尾的 /。公开链接不会因此多出这一段 |
| 会话令牌 | 使用临时凭证时填写，普通长期凭证可留空 |
| 读取方式 | 默认应用转发；也可选择签名重定向或公开地址重定向，填写对应配置。详见 S3 配置说明 |
分片阈值、分片大小和并发数可先保留默认值。它们控制 Picloom 向 S3 写入，与浏览器向 Picloom 分片上传是两个环节。
保存后将该源加入存储组，上传一张图片，再打开返回链接。若要验证删除权限，使用测试图片执行删除，并查看副本是否完成删除。
选择签名重定向时仍应分享 Picloom 链接；浏览器跳转后的签名链接会过期。图片需要缩放或添加水印时，Picloom 仍需读取存储内容。
创建存储组
在 配置 → 存储组 点击创建，添加存储源并保存。两种常用配置如下：
| 用途 | 成员 | 存储选择策略 | 副本数 |
|---|---|---|---|
| 只存本地 | 本地图片 | 按优先级 | 1 |
| 本地与 S3 各存一份 | 本地图片在前，S3 在后 | 按优先级 | 2 |
按优先级时，成员顺序决定选择顺序；加权随机时，权重决定被选中的相对概率。上传目标选择与读取失败回退共用此策略，每次不重复选择同一存储源。读取仅从已有的可用副本中选择；图片处理和缩略图的原图下载中断时会尝试其他副本。
副本数表示总份数：1 保存一份，2 保存两份。每次上传选择对应数量的不同存储源；可用源不足时无法上传。
各目标在任务并发限制内同时写入，首份保存并发布后返回链接，其余继续执行。所有目标首轮写入都失败时，本次上传失败；已有一份成功后，其他副本按任务规则重试。到图片的操作详情中查看每份副本的状态。
调整或更换存储
修改存储组只影响后续上传，已有图片不会自动搬迁或补齐副本。已有副本仍依赖原存储源的配置，删除源前需要处理其配置引用与副本。
本地根目录、S3 桶等定位字段不可直接修改。要更换存储位置，应创建新存储源，再调整存储组。已有远端图片可通过 导入 登记；导入不会复制图片。
其他存储插件见 内置插件。
容量与删除配置
编辑存储源时可填写容量上限，留空表示不限。列表中的已用容量按全部未终结副本的文件大小计算：等待写入、写入失败和删除失败也计入，只有副本进入已删除状态才释放。容量上限在新副本登记时检查，下调上限不阻止已登记副本继续写入或重试。重试不会重复记账；重复远端对象或解除引用后保留的文件可能使账面容量与远端实际占用不同。
在 配置 → 存储源 点击「清理图片」。先从面板列出的存储组移除此源，链接可直接打开对应组编辑器；移出存储组只影响后续上传，已有图片仍在本次清理范围内。
面板显示当前已登记副本数及没有其他可用副本的数量，默认「删除文件并解除引用」，并包含没有其他可用副本的图片。操作方式和保留选项见删除图片。清理只处理 Picloom 已登记的副本，不扫描存储桶或目录中的未登记文件。
点击「开始清理」后，由后台按提交时的固定范围分批处理，后续上传、导入或配置修改不会扩展或取消本次清理。刷新页面或重启服务后可继续查看进度，逐项显示完成、保留和失败结果；错误结果可打开图片详情。修复问题后点击「重试失败项」，仅重试原任务的失败项，不重新扫描。要改用另一种操作方式，等待当前任务结束后发起新任务。
任务结束后，面板仍显示此源当前真实引用数；保留项、失败项和提交后的新副本都可能使引用数不为零。解除配置引用、结束所有副本管理并等待运行调用退出后，可单独确认删除源配置。删除配置不删除远端对象，也不清除仍在管理的图片及其副本、任务记录；图片详情显示已删除源的原标识，新建存储源不会接管旧副本。