如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
arm64v8/alpine 是基于 Alpine Linux 的极小 Docker 镜像,专为 arm64v8 架构优化。Alpine Linux 是一款围绕 musl libc 和 BusyBox 构建的轻量级 Linux 发行版,该镜像体积仅 5MB,同时提供完整的包索引,是构建轻量级应用的理想基础镜像。
musl libc(轻量级 C 标准库)和 BusyBox(集成核心 Unix 工具),减少冗余依赖。apk 包管理器,可访问 Alpine 包仓库,提供丰富的预编译软件包。arm64v8 架构优化,同时 Alpine 官方镜像支持多架构(如 amd64、arm32v6、ppc64le 等,各架构有独立仓库)。作为基础镜像构建小型 CLI 工具、脚本运行环境等。
适用于微服务架构,减少容器启动时间和资源占用。
可作为生产级应用的基础(需确保应用兼容 musl libc),尤其适合资源受限场景。
在持续集成/部署流程中作为临时任务环境,降低环境准备时间。
适合边缘计算场景,满足低存储、低内存环境需求。
| 标签 | 对应 Dockerfile 链接 |
|---|---|
20250108, edge | https://github.com/alpinelinux/docker-alpine/blob/c1f1de232c970df2285c03050ab3747b8563164f/aarch64/Dockerfile |
3.22.2, 3.22, 3, latest | https://github.com/alpinelinux/docker-alpine/blob/4dc13cbc7caffe03c98aa99f28e27c2fb6f7e74d/aarch64/Dockerfile |
3.21.5, 3.21 | https://github.com/alpinelinux/docker-alpine/blob/2c30d5daeebb5090b1b6363a9e97dd88bf08a642/aarch64/Dockerfile |
3.20.8, 3.20 | https://github.com/alpinelinux/docker-alpine/blob/f5ce8f036ef8a57481ae6f3f1cf7f2300cff8d29/aarch64/Dockerfile |
3.19.9, 3.19 | https://github.com/alpinelinux/docker-alpine/blob/ee939d52345248420cf62d4606ccc7152bc5a107/aarch64/Dockerfile |
作为 Dockerfile 基础镜像
直接在 Dockerfile 中引用该镜像,通过 apk 安装所需依赖:
dockerfile# 使用指定版本(推荐生产环境) FROM arm64v8/alpine:3.22.2 # 安装示例:安装 mysql-client RUN apk add --no-cache mysql-client # 设置入口命令 ENTRYPOINT ["mysql"]
镜像体积对比:上述示例构建的镜像体积约 36.8MB,而基于 Ubuntu 20.04 的同类镜像体积约 145MB。
交互式运行
通过 docker run 启动交互式 shell,用于临时测试或调试:
bashdocker run -it --rm arm64v8/alpine:latest sh
-it:启用交互式终端--rm:退出后自动删除容器sh:Alpine 默认 shell(BusyBox 提供)docker-compose 配置示例
在 docker-compose.yml 中使用该镜像作为服务基础:
yamlversion: '3' services: app: image: arm64v8/alpine:3.22 command: sh -c "apk add --no-cache curl && curl https://example.com"
Alpine 通过 apk 工具管理软件包,常用命令如下:
| 命令 | 说明 |
|---|---|
apk update | 更新本地包索引缓存(建议安装前执行) |
apk add --no-cache <pkg> | 安装指定包,--no-cache 避免缓存索引 |
apk del <pkg> | 卸载指定包 |
apk search <keyword> | 搜索包仓库中的包 |
apk info <pkg> | 查看已安装包的详细信息 |
最佳实践:安装包时始终使用 --no-cache,避免缓存占用镜像空间(如 RUN apk add --no-cache python3)。
由 Alpine Linux 维护者 https://github.com/alpinelinux/docker-alpine 维护。
镜像中包含的软件(如 Alpine Linux 组件、musl libc、BusyBox 等)许可证信息可通过 Alpine 包仓库 查询。
Docker 镜像可能包含第三方软件,其许可证可能与基础软件不同。用户需自行确保对镜像的使用符合所有包含软件的许可证要求。更多自动检测的许可证信息可参考 https://github.com/docker-library/repo-info/tree/master/repos/alpine%E3%80%82
以下是 arm64v8/alpine 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

来自真实用户的反馈,见证轩辕镜像的优质服务