Docker 管理 · Free / Go
镜像
管理镜像拉取、导入、标签更新以及 Docker 构建空间。
可以做什么
- 拉取或导入容器镜像
- 检查多标签镜像更新
- 查看镜像占用与构建缓存
这个页面解决什么问题
镜像页管理本地镜像库存：拉取、导入导出、打标签、删除、更新检测、构建缓存与 Docker 磁盘占用。它与容器页的衔接是——镜像更新完成后现有容器不会自动重建，需要到容器页执行更新或重置。
同一镜像 ID 的多个标签作为一项资源展示，系统标签紧跟名称；列表显示的 Docker Hub 前缀只是展示层简化，操作始终使用后端返回的真实引用。镜像大小包含共享层，只能作为占用参考，不等于删除后可释放的空间。
页面同时承担两项加速配置：Docker Hub 镜像源候选（勾选后手动保存）与 GHCR 加速（显式启用并保存后由本机后端替换拉取地址），两者都不需要重启 Docker。
开始前准备
- 拉取与导入操作作用于当前选中的目标设备。
- 更新检测仅支持本机；远程设备不显示该入口。
如何操作
查找与筛选镜像
确认某个镜像是否已在本机、有哪些标签。
- 使用搜索定位名称；用更新状态（全部／有更新／无更新）与使用状态（已使用／未使用）分段筛选组合查询。
- 查看标签、大小、创建时间（yyMMdd-HH:mm）与状态；同一镜像的多标签默认全部显示。
- 点击行查看详情：摘要、标签、大小、创建时间、历史与关联容器（名称、短 ID、运行状态）。
结果检查：明确镜像的标签分布与是否被容器引用。
拉取镜像
需要把一个镜像拉到本机供部署使用。
- 点击「拉取镜像」打开拉取弹窗，填写镜像引用。
- 提交后按时间、层 ID 与状态稳定展示进度，结构化错误直接可见。
- 任务提交后可关闭弹窗在后台继续；重新进入页面可恢复进度。
- 拉取完成后在列表确认镜像与标签。
结果检查：镜像进入本地库存；失败时错误信息保留在弹窗与任务记录中。
导入、导出与打标签
离线环境搬运镜像，或为本地镜像增加标签。
- 使用「导入镜像」从本地文件导入镜像包。
- 使用导出操作把镜像保存为可传输的文件。
- 使用编辑操作为镜像打标签；同一镜像的标签操作在后端串行执行，避免冲突。
结果检查：镜像在目标设备就位并带有预期标签。
检测并执行镜像更新
想知道哪些本地镜像有新版本。
- 点击「检测更新」：每次都重新查询远端（force），绕过失败退避，结果与失败明细保存到系统通知。
- 在列表按“有更新”筛选，查看哪些镜像可更新。
- 明确执行“更新镜像”后走 Compose 安全更新的临时引用机制清理旧镜像；仍被引用的镜像由 Docker 保留。
- 到容器页对使用该镜像的容器执行更新或重置，完成版本切换。
结果检查：可更新集合清晰；检测只读不改动任何容器。
管理构建缓存与磁盘占用
Docker 磁盘占用偏高，需要定位与清理。
- 在镜像页签切换到「构建缓存」：查看缓存条目与采样时间，区分“使用中／空闲”，共享缓存另有标记。
- 按需执行“清理悬空”（保守范围）或“清理全部未使用”；两者都不能强制删除正在使用的缓存。
- 结合磁盘占用汇总判断清理收益；构建缓存与镜像页签不互相参与框选。
结果检查：清理后重新读取 Docker 真实列表，结果以 Docker 回报为准。
配置镜像加速
拉取 Docker Hub 或 GHCR 镜像速度慢。
- 在镜像源列表查看候选：Docker Hub 使用现有预设与已配置地址；两组都包含 1ms 免费通道。
- 勾选候选后需手动保存才生效；可对候选做连通性检测（只验证后端直连的 Registry 响应，不拉取镜像）。
- GHCR 加速显式启用并保存后写入本机后端设置：运行时把 ghcr.io 替换为所选仓库，保留路径、tag 与 digest。
- 私有镜像应关闭 GHCR 加速——凭证不会转发到加速源，也不会自动回退官方源。
结果检查：本机手动拉取与共享的 Compose／AppStore／AI 部署均走加速；远程设备不继承本机配置。
弹窗与高级功能
拉取镜像
打开入口：工具栏「拉取镜像」。
提交并跟踪一个镜像拉取任务。
- 进度：按时间、层 ID 与状态稳定排版，结构化错误直接展示。
- 后台：关闭弹窗任务继续，重进页面恢复进度。
提交或关闭后：镜像拉取完成或失败原因明确保留。
导入镜像
打开入口：工具栏导入入口。
从本地镜像文件导入。
- 来源：本地导出的镜像包文件。
- 目标：导入到当前选中的设备。
提交或关闭后：镜像与标签进入本地库存。
编辑（打标签）与清理确认
打开入口：行内编辑操作，或删除／清理入口。
维护镜像标签与执行删除类操作。
- 标签：为镜像增加标签；同一镜像的标签操作串行执行。
- 删除：使用中的镜像由后端拒绝；多标签镜像不带 force 会被拒绝，需先删除多余标签；删除被引用镜像前显示关联关系并要求确认。
- 缓存：构建缓存清理提供悬空与全部未使用两档保守范围。
提交或关闭后：按确认执行并逐项汇总失败原因。
注意：批量删除失败不阻塞后续项，但不会自动重试；确认前核对关联容器列表。
注意事项
- “检测更新”只读取远端状态，真正的更新必须通过明确操作执行。
- 镜像大小含共享层，空间收益估算以空间清理页的重新评估结果为准。
- 镜像源检测结果只证明该地址的 Registry 响应，不能证明具体镜像可用或供应链可信。