映像檔

映像檔是容器的範本，包含了執行應用程式所需的所有檔案與設定。 透過映像檔管理頁面，你可以拉取、檢視及刪除本機映像檔。

映像檔清單

進入 容器 > 映像檔 標籤頁檢視本機映像檔清單。

清單會顯示以下資訊：

• 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

私有倉庫

如果你有私有映像檔倉庫，可以直接使用完整的映像檔位址拉取。