library/buildpack-deps
包含常用构建依赖项，用于安装各种模块（如gems）的Docker镜像
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
buildpack-deps 镜像文档
概述
buildpack-deps 镜像在设计理念上类似于 https://github.com/heroku/stack-images/blob/master/bin/cedar.sh%EF%BC%8C%E5%8C%85%E5%90%AB%E5%A4%A7%E9%87%8F%E5%BC%80%E5%8F%91%E6%89%80%E9%9C%80%E7%9A%84%22%E5%A4%B4%E6%96%87%E4%BB%B6%22%E5%8C%85%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E Ruby Gems、PyPI 模块等各类依赖的编译安装。例如，使用 buildpack-deps 可以在任意应用目录中执行 bundle install，而无需预先知晓构建依赖模块是否需要 ssl.h 等头文件。
!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/buildpack-deps/logo.png
核心功能与特性
完整版本（主标签）
包含大量开发依赖包，支持绝大多数 gem install、npm install、pip install 等命令无需额外安装头文件即可成功执行。
curl 变体
基于基础镜像，仅包含 curl、wget 和 ca-certificates 包。适用于需下载文件但无需版本控制的场景（如 Java JRE 环境下载 JAR 包）。
scm 变体
基于 curl 变体，额外包含多种版本控制工具：bzr、git、hg 和 svn（不含 cvs）。适用于需下载文件且需版本控制的场景（如 Java JDK 环境中检出代码）。
支持的标签
Debian 系列
| 基础版本 | 完整版本标签 | curl 变体标签 | scm 变体标签 | Dockerfile 链接 |
|---|---|---|---|---|
| Trixie (stable) | trixie, stable, latest | trixie-curl, stable-curl, curl | trixie-scm, stable-scm, scm | https://github.com/docker-library/buildpack-deps/blob/1f4fe499c668d9a2e1578aa8db4f0b2d***cf5/debian/trixie/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/1f4fe499c668d9a2e1578aa8db4f0b2d***cf5/debian/trixie/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/1f4fe499c668d9a2e1578aa8db4f0b2d***cf5/debian/trixie/scm/Dockerfile |
| Bookworm (oldstable) | bookworm, oldstable | bookworm-curl, oldstable-curl | bookworm-scm, oldstable-scm | https://github.com/docker-library/buildpack-deps/blob/d0ecd4b7313e9bc6b00d9a4fe62ad5787bc197ae/debian/bookworm/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/3e18c3af1f5dce6a48abf036857f9097b6bd79cc/debian/bookworm/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/d0ecd4b7313e9bc6b00d9a4fe62ad5787bc197ae/debian/bookworm/scm/Dockerfile |
| Bullseye (oldoldstable) | bullseye, oldoldstable | bullseye-curl, oldoldstable-curl | bullseye-scm, oldoldstable-scm | https://github.com/docker-library/buildpack-deps/blob/d0ecd4b7313e9bc6b00d9a4fe62ad5787bc197ae/debian/bullseye/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/93d6db0797f91ab674535553b7e0e762941a02d0/debian/bullseye/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/d0ecd4b7313e9bc6b00d9a4fe62ad5787bc197ae/debian/bullseye/scm/Dockerfile |
| Forky (testing) | forky, testing | forky-curl, testing-curl | forky-scm, testing-scm | https://github.com/docker-library/buildpack-deps/blob/6fbd1fd6aa***b10f11a97c31b9da1ac09db76/debian/forky/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/6fbd1fd6aa***b10f11a97c31b9da1ac09db76/debian/forky/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/6fbd1fd6aa***b10f11a97c31b9da1ac09db76/debian/forky/scm/Dockerfile |
| Sid (unstable) | sid, unstable | sid-curl, unstable-curl | sid-scm, unstable-scm | https://github.com/docker-library/buildpack-deps/blob/2b3a8b7d1f8875865034be3bab98ddd737e37d5e/debian/sid/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/2b3a8b7d1f8875865034be3bab98ddd737e37d5e/debian/sid/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/2b3a8b7d1f8875865034be3bab98ddd737e37d5e/debian/sid/scm/Dockerfile |
Ubuntu 系列
| 基础版本 | 完整版本标签 | curl 变体标签 | scm 变体标签 | Dockerfile 链接 |
|---|---|---|---|---|
| Noble (24.04) | noble, 24.04 | noble-curl, 24.04-curl | noble-scm, 24.04-scm | https://github.com/docker-library/buildpack-deps/blob/60dc5f9555c521de086b2f5770514faf69ee2cc4/ubuntu/noble/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/60dc5f9555c521de086b2f5770514faf69ee2cc4/ubuntu/noble/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/60dc5f9555c521de086b2f5770514faf69ee2cc4/ubuntu/noble/scm/Dockerfile |
| Jammy (22.04) | jammy, 22.04 | jammy-curl, 22.04-curl | jammy-scm, 22.04-scm | https://github.com/docker-library/buildpack-deps/blob/d0ecd4b7313e9bc6b00d9a4fe62ad5787bc197ae/ubuntu/jammy/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/93d6db0797f91ab674535553b7e0e762941a02d0/ubuntu/jammy/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/d0ecd4b7313e9bc6b00d9a4fe62ad5787bc197ae/ubuntu/jammy/scm/Dockerfile |
| Plucky (25.04) | plucky, 25.04 | plucky-curl, 25.04-curl | plucky-scm, 25.04-scm | https://github.com/docker-library/buildpack-deps/blob/ab3ae04e943ecb240a9691dfa1de219b4a3e32a0/ubuntu/plucky/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/ab3ae04e943ecb240a9691dfa1de219b4a3e32a0/ubuntu/plucky/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/ab3ae04e943ecb240a9691dfa1de219b4a3e32a0/ubuntu/plucky/scm/Dockerfile |
| Questing (25.10) | questing, 25.10 | questing-curl, 25.10-curl | questing-scm, 25.10-scm | https://github.com/docker-library/buildpack-deps/blob/99e7dc24c50c0a7be371ea9e6aed6134ce4cbfeb/ubuntu/questing/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/99e7dc24c50c0a7be371ea9e6aed6134ce4cbfeb/ubuntu/questing/curl/Dockerfile%E3%80%81https://github.com/docker-library/buildpack-deps/blob/99e7dc24c50c0a7be371ea9e6aed6134ce4cbfeb/ubuntu/questing/scm/Dockerfile |
使用场景与适用范围
- 语言栈基础镜像：作为 Ruby、Python、Node.js 等语言栈镜像的基础，提供编译依赖。
- 模块安装场景：需执行
gem install、npm install、pip install等命令，且预先未知依赖的开发头文件时。 - 精简需求场景：仅需下载功能（curl 变体）或版本控制功能（scm 变体）时，减少镜像体积。
使用方法
基础使用
该镜像设计为语言栈镜像的基础层，通常作为 FROM 指令的基础镜像：
dockerfile# 使用完整版本作为 Ruby 镜像基础 FROM docker.xuanyuan.run/buildpack-deps:latest RUN apt-get update && apt-get install -y ruby && rm -rf /var/lib/apt/lists/*
变体使用示例
curl 变体：下载文件
bashdocker run --rm docker.xuanyuan.run/buildpack-deps:curl wget https://example.com/file.tar.gz
scm 变体：克隆代码仓库
bashdocker run --rm docker.xuanyuan.run/buildpack-deps:scm git clone https://github.com/example/repo.git
完整版本：安装 Ruby Gems
bashdocker run -v $(pwd):/app --rm docker.xuanyuan.run/buildpack-deps:latest sh -c "cd /app && gem install bundler && bundle install"
维护与支持
- 维护者：https://github.com/docker-library/buildpack-deps
- 获取帮助：https://dockr.ly/comm-slack%E3%80%81Server Fault、https://unix.stackexchange.com/help/on-topic%E3%80%81https://stackoverflow.com/help/on-topic
- 支持架构：
amd64、arm32v5、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x - 镜像更新：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fbuildpack-deps
- 问题反馈：https://github.com/docker-library/buildpack-deps/issues
许可证
镜像中软件的许可证信息请参见 https://www.debian.org/social_contract#guidelines%E3%80%82
Docker 镜像可能包含其他软件（如 Bash 等基础发行版组件），其许可证可能不同。
额外许可证信息可在 https://github.com/docker-library/repo-info/tree/master/repos/buildpack-deps 中找到。
使用前请确保遵守所有包含软件的许可证要求。
更多相关 Docker 镜像与资源
以下是 buildpack-deps 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- library/python Docker 镜像说明（Python 运行时，适合数据科学和 Web 开发）
- demisto/python Docker 镜像说明（Python 运行时，Demisto 安全自动化平台）
- chainguard/python Docker 镜像说明（Python 运行时，Chainguard 安全加固版本）
- intel/python Docker 镜像说明（Python 运行时，Intel 优化版本，适合高性能计算）
- cimg/python Docker 镜像说明（Python 运行时，CI/CD 优化版本）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 buildpack-deps 镜像标签
docker pull docker.xuanyuan.run/buildpack-deps:<标签>
DockerHub 原生拉取命令
docker pull buildpack-deps:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"