library/debian

Debian Docker 镜像介绍

快速参考

维护者

由 Debian 开发者 tianon 和 paultag 维护。

求助渠道

可通过以下途径获取帮助：

• Docker 社区 Slack
• Server Fault
• Unix & Linux
• Stack Overflow

支持的标签及对应 Dockerfile 链接

以下是当前支持的镜像标签及其 Dockerfile 源码链接：

• bookworm, bookworm-20250929, 12.12, 12
• bookworm-backports
• bookworm-slim, bookworm-20250929-slim, 12.12-slim, 12-slim
• bullseye, bullseye-20250929, 11.11, 11
• bullseye-slim, bullseye-20250929-slim, 11.11-slim, 11-slim
• experimental, experimental-20250929
• forky, forky-20250929
• forky-backports
• forky-slim, forky-20250929-slim
• oldoldstable, oldoldstable-20250929
• oldoldstable-slim, oldoldstable-20250929-slim
• oldstable, oldstable-20250929
• oldstable-backports
• oldstable-slim, oldstable-20250929-slim
• rc-buggy, rc-buggy-20250929
• sid, sid-20250929
• sid-slim, sid-20250929-slim
• stable, stable-20250929
• stable-backports
• stable-slim, stable-20250929-slim
• testing, testing-20250929
• testing-backports
• testing-slim, testing-20250929-slim
• trixie, trixie-20250929, 13.1, 13, latest
• trixie-backports
• trixie-slim, trixie-20250929-slim, 13.1-slim, 13-slim
• unstable, unstable-20250929
• unstable-slim, unstable-20250929-slim

快速参考（续）

问题反馈

可在 debuerreotype/docker-debian-artifacts 仓库的 issues 页面 提交问题。

支持的架构

支持多种架构，包括：
amd64、arm32v5、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x。

镜像详情

镜像元数据、传输大小等信息可在 repo-info 仓库的 repos/debian/ 目录 查看（含 历史记录）。

镜像更新

• 关注 official-images 仓库的 library/debian 标签 获取更新动态。
• 镜像定义文件位于 official-images 仓库的 library/debian 文件（含 历史记录）。

本文档来源

本文档内容源自 docs 仓库的 debian/ 目录（含 历史记录）。

什么是 Debian？

Debian 是一款主要由自由开源软件组成的操作系统，多数软件采用 GNU 通用公共许可证，由 Debian 项目团队开发。它是个人电脑和网络服务器中最受欢迎的 Linux 发行版之一，也是众多其他 Linux 发行版的基础。

更多信息：***.org/wiki/Debian

!Debian 标志

关于本镜像

本仓库的镜像旨在保持最小化（容器的不可变/分层特性决定了“添加比删除更容易”）。具体而言，镜像基于 “minbase” 变体 构建，仅包含“必要”软件包，以确保最小的 Debian 系统 footprint（由 Debian 项目的 发布和 FTP 团队 定义和管理）。

标签说明

• debian:latest 始终指向最新稳定版。稳定版也会通过版本号标签标识（如 debian:11 对应 debian:bullseye，debian:10 对应 debian:buster 等）。
• 滚动标签（如 debian:stable、debian:testing）在 /etc/apt/sources.list 中使用滚动套件名称（例如 deb [***] testing main）。

镜像源

默认使用 deb.debian.org CDN 重定向服务 作为软件源，以确保对大多数用户的可靠性（自 2016-10-20 起成为 debootstrap 的默认源）。详情可参考 deb.debian.org 主页。

EOL 版本

若需使用已终止支持（EOL）的 Debian 版本（仅可从 archive.debian.org 获取），可参考 debian/eol 镜像，其中包含早至 Potato（Debian 2.2，首个全面支持 APT 的版本）的标签。

locales 设置

默认镜像仅包含 C、C.UTF-8 和 POSIX 三种 locale。多数需 UTF-8 环境的场景下，C.UTF-8 已足够（可通过 -e LANG=C.UTF-8 或 ENV LANG C.UTF-8 设置）。

如需其他 locale，可通过 locales 包安装生成。以下是 PostgreSQL 项目的示例方法：

dockerfile
RUN apt-get update && apt-get install -y locales && rm -rf /var/lib/apt/lists/* \
	&& localedef -i en_US -c -f UTF-8 -A /usr/share/locale/locale.alias en_US.UTF-8
ENV LANG en_US.utf8

构建方式

镜像的 rootfs 压缩包通过 可重现 Debian 根文件系统工具 debuerreotype 构建，目标是透明且可重现——使用相同工具链可重新生成官方 Debian 镜像的压缩包。具体构建流程可参考该工具仓库中的 examples/debian.sh 脚本（及配套的 debian-all.sh 脚本）。

此外，debuerreotype/docker-debian-artifacts 仓库 中的脚本用于生成各标签的 Dockerfile，并将架构特定的压缩包收集到仓库的 dist-ARCH 分支，分支中还包含构建元数据（如基础镜像的软件包版本 rootfs.manifest、debuerreotype 调用时的 snapshot.debian.org 时间戳 rootfs.debuerreotype-epoch 等）。

各 rootfs.tar.xz artifact 的 SHA256 校验和及完整构建命令可在 docker.debian.net 查询。

镜像变体

debian:<suite>-slim

此类标签是精简版镜像的实验性尝试，移除了容器中通常非必需的文件（如 man 页、文档等），具体移除内容可参考 `