镜像

镜像是容器的模板，包含了运行应用所需的所有文件和配置。 通过镜像管理页面，你可以拉取、查看和删除本地镜像。

镜像列表

进入 容器 > 镜像 标签页查看本地镜像列表。

列表显示以下信息：

• ID：镜像 ID
• 容器数量：使用该镜像的容器数量
• 镜像：镜像名称和标签
• 大小：镜像占用的磁盘空间
• 创建时间：镜像创建时间
• 操作：删除等

拉取镜像

1. 点击 拉取镜像 按钮
2. 输入镜像名称，例如 docker.io/php:8.3-fpm、mysql:8.4
3. （可选）启用 身份验证 并填写 用户名 和 密码，以便从需要登录的私有仓库拉取
4. 点击 提交 开始拉取

提交后会实时显示拉取进度，展示每个镜像层的下载状态和整体进度。 你可以随时点击 取消 中止拉取。

镜像名称格式：[仓库地址/]镜像名[:标签]

• nginx - 拉取官方 nginx 镜像的 latest 标签
• nginx:1.28 - 拉取指定版本
• mysql:8.4 - 拉取 MySQL 8.4 版本
• registry.cn-hangzhou.aliyuncs.com/xxx/yyy:latest - 从阿里云镜像仓库拉取

提示

国内服务器拉取 Docker Hub 镜像可能较慢， 建议配置镜像加速器或使用国内镜像源。

创建容器时拉取

除了在本页面手动拉取镜像外，AcePanel 还可以在你创建容器时自动拉取镜像。 当你提交 创建容器 表单时，面板会先检查你指定的镜像是否已存在于本地：

• 如果镜像已存在，则立即创建容器。
• 如果镜像不存在，则会打开拉取对话框并自动下载，显示与手动拉取相同的实时逐层进度。 拉取完成后即创建容器。

这意味着在创建使用某镜像的容器之前，你无需提前拉取该镜像。

删除镜像

点击 操作 列中的 删除 按钮可删除单个镜像。 你也可以勾选多个镜像，点击顶部的 删除 按钮进行批量删除。

注意

删除为强制删除，因此即使镜像被已停止的容器引用，也可以将其删除。 如果有 运行中 的容器仍在使用该镜像，则需要先删除该容器，才能删除镜像。

清理镜像

点击 清理镜像 可删除所有未使用的镜像，释放磁盘空间。

清理操作会删除所有未被任何容器使用的镜像，包括悬空镜像。 由 AcePanel 创建和管理的镜像会被保留，不会被删除。

镜像来源

Docker Hub

Docker 官方镜像仓库，包含大量官方和社区镜像。

常用官方镜像：

• nginx - Web 服务器
• mysql / mariadb - 数据库
• redis - 缓存
• postgres - PostgreSQL 数据库
• node - Node.js 运行环境
• python - Python 运行环境

国内镜像源

• 阿里云：registry.cn-hangzhou.aliyuncs.com
• 腾讯云：ccr.ccs.tencentyun.com
• 华为云：swr.cn-north-4.myhuaweicloud.com

私有仓库

如果你有私有镜像仓库，可以直接使用完整的镜像地址拉取。