浏览文档目录 +

Docker 管理 · Free / Go

数据卷

统一管理持久化数据卷、卷内文件和备份目标。

数据卷真实界面,敏感信息已打码
真实产品界面 · 敏感信息已打码

可以做什么

  • 创建数据卷并浏览卷内文件
  • 配置定时卷备份
  • 使用 S3 兼容存储或 WebDAV

这个页面解决什么问题

卷页管理 Docker named volume 的创建、浏览与删除,并提供与设置页共用的卷备份能力(本地归档、S3/WebDAV 远程、Cron 计划)。它只面向 named volume——bind 挂载不在卷页的管理范围内。

每个卷的“文件浏览器”是一个嵌入式 Dufs 视图:左右分栏、目录每页 200 项、文本文件 1MB 内可直接编辑;它运行在临时容器里,靠心跳维持会话,不接收 TRADIS 面板的任何凭据。

开始前准备

  • 文件浏览器依赖设置中启用的服务开关;在设置→服务切换只影响新会话,已打开的会话不受影响。
  • S3/WebDAV 远程备份需要已保存的目标凭据(在设置页维护)。

如何操作

创建与查找卷

为新服务准备数据卷,或确认某个已有卷的挂载情况。

  1. 点击「新建卷」打开创建对话框;创建时只提交 driverOpts,不额外写入其他字段。
  2. 在列表按名称查找,查看大小与关联容器。
  3. 结合容器页的挂载信息确认该卷被哪些服务使用。

结果检查:卷就位且关联关系清楚。

浏览卷内文件

需要直接查看或修改卷里的配置与数据文件。

  1. 在卷行打开文件浏览器(嵌入式 Dufs 视图):左右分栏浏览目录,每页 200 项。
  2. 文本文件 1MB 以内可直接在线编辑;编辑中的版本冲突会保留草稿。
  3. 同一卷内的移动(MOVE)不会覆盖同名目标,需要覆盖时先删除目标。
  4. 上传有总预算(约 10 分钟);关闭浏览器即撤销会话,helper 容器 90 秒内回收。

结果检查:卷内文件可查看与安全编辑;会话结束后临时容器自动回收。

删除与批量清理

清理不再使用的卷。

  1. 确认卷未被容器使用:使用中的卷会被后端拒绝删除。
  2. 单个删除走确认;批量删除由三个 worker 有界并发执行,逐条隔离失败并汇总原因。
  3. 删除后在列表确认结果。

结果检查:未使用卷被清除;使用中的卷保持原样并说明原因。

配置卷备份

为数据卷建立本地或远程备份。

  1. 在卷备份配置中选择目标:本地目录、S3 或 WebDAV(模板只更新备份容器的环境变量,不触碰面板其他配置)。
  2. 按需设置 Cron 自动计划;执行由备份容器完成。
  3. 在设置页维护远程目标凭据;卷备份属于 Free 能力。

结果检查:卷按计划或手动触发备份到所选目标。

弹窗与高级功能

新建卷

打开入口:工具栏「新建卷」。

创建一个 named volume。

  • 字段:卷名与 driverOpts;创建只提交 driverOpts。
  • 边界:不创建 bind,不预设挂载。

提交或关闭后:新卷出现在列表,可在容器或 Compose 中引用。

卷文件浏览器

打开入口:卷行的文件浏览入口。

在面板内直接管理卷内文件。

  • 形态:嵌入式 Dufs 视图,左右分栏,目录每页 200 项。
  • 编辑:文本文件 1MB 内可编辑,版本冲突保留草稿;同卷 MOVE 不覆盖同名。
  • 会话:心跳维持,关闭即撤销;helper 容器 90 秒回收,最多同时两个并按条件复用。
  • 安全:不接收面板凭据;上传总预算约 10 分钟。

提交或关闭后:文件查看与编辑完成;会话结束后不留常驻容器。

注意:浏览器中的删除与移动直接作用于卷内数据,无回收站。

注意事项

  • named volume 不会被改写为 bind;Compose 里的卷引用语义保持不变。
  • 设置→服务中的浏览器开关只影响新会话;已打开的会话继续有效。
  • 卷备份与应用保护(项目备份)是两套独立能力,互不迁移。