注意：这是debian官方镜像的riscv64架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“除amd64外的架构？”和官方镜像FAQ中的“Git中镜像的源代码已更改，现在该怎么办？”。

快速参考

• 维护者：
  Debian开发者 tianon 和 paultag

• 获取帮助的地方：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

• experimental, experimental-20251020

• forky, forky-20251020

• forky-backports

• forky-slim, forky-20251020-slim

• rc-buggy, rc-buggy-20251020

• sid, sid-20251020

• sid-slim, sid-20251020-slim

• stable, stable-20251020

• stable-backports

• stable-slim, stable-20251020-slim

• testing, testing-20251020

• testing-backports

• testing-slim, testing-20251020-slim

• trixie, trixie-20251020, 13.1, 13, latest

• trixie-backports

• trixie-slim, trixie-20251020-slim, 13.1-slim, 13-slim

• unstable, unstable-20251020

• unstable-slim, unstable-20251020-slim

快速参考（续）

• 问题提交地址：
  [***]

• 支持的架构：(更多信息)
  amd64, arm32v5, arm32v7, arm64v8, i386, mips64le, ppc64le, riscv64, s390x

• 镜像 artifact 详情：
  repo-info 仓库的 repos/debian/ 目录 (历史记录)
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/debian 标签
  official-images 仓库的 library/debian 文件 (历史记录)

• 本描述的来源：
  docs 仓库的 debian/ 目录 (历史记录)

什么是 Debian？

Debian 是一个主要由自由开源软件组成的操作系统，其中大部分软件遵循 GNU 通用公共许可证，由名为 Debian 项目的团队开发。Debian 是个人电脑和网络服务器中最受欢迎的 Linux 发行版之一，并且被用作其他多个 Linux 发行版的基础。

***.org/wiki/Debian

!logo

关于本镜像

本仓库中的镜像旨在尽可能精简（由于容器的不可变/分层特性，添加内容比删除更容易）。具体而言，它们基于“minbase”变体构建，该变体仅安装“必需”软件包，从而创建仍为“Debian”（由项目内发布和 FTP 团队定义/管理）的最小可能占用空间。

riscv64/debian:latest 标签将始终指向最新稳定版本。稳定版本也会使用其版本号进行标记（例如，riscv64/debian:11 是 riscv64/debian:bullseye 的别名，riscv64/debian:10 是 riscv64/debian:buster 的别名等）。

滚动标签（riscv64/debian:stable、riscv64/debian:testing 等）在其 /etc/apt/sources.list 文件中使用滚动套件名（即 deb [***] testing main）。

这些镜像使用的默认镜像是 deb.debian.org CDN 指针/重定向器，以确保对大多数用户尽可能可靠（并且自 2016-10-20 起成为 debootstrap 的默认镜像）。有关更多信息，请参见 deb.debian.org 主页。

如果需要 EOL（生命周期结束）的 Debian 版本（因此只能从 archive.debian.org 获取），可以查看 debian/eol 镜像，其中包含回溯到 Potato（Debian 2.2）的 Debian 版本标签，这是第一个完全使用 APT 的版本。

本地化（Locales）

由于这是 Debian 的忠实“minbase”安装，此镜像默认仅包含 C、C.UTF-8 和 POSIX 本地化。对于大多数需要 UTF-8 本地化的用途，C.UTF-8 可能已足够（通过 -e LANG=C.UTF-8 或 ENV LANG C.UTF-8 设置）。

如果这不够，其他本地化可以通过 locales 软件包安装/生成。PostgreSQL 提供了一个很好的示例，复制如下：

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 tarball 使用 可重现 Debian rootfs 工具 debuerreotype 构建，其明确目标是透明且可重现。使用相同的工具链，应该可以重新生成（干净地！）用于构建官方 Debian 镜像的相同 tarball。debuerreotype 仓库中的 examples/debian.sh 脚本（及其配套/包装器 debian-all.sh）是用于创建本镜像中发布的 artifact 的标准入口点（通过类似于该仓库根目录中包含的 docker-run.sh 的过程）。

此外，[***] 中的脚本用于创建每个标签的 Dockerfile，并将特定架构的 tarball 收集到同一仓库的 dist-ARCH 分支中，这些分支还包含每个构建中包含的 artifact 的额外元数据，例如基础镜像中包含的明确软件包版本（rootfs.manifest）、debuerreotype 调用时使用的确切 snapshot.debian.org 时间戳（rootfs.debuerreotype-epoch）、镜像中的 sources.list（rootfs.sources-list）以及镜像创建过程中使用的 sources.list（rootfs.sources-list-snapshot）等。

为方便起见，每个主要 rootfs.tar.xz artifact 的 SHA256 校验和（以及完整构建命令）也发布在 docker.debian.net。

镜像变体

riscv64/debian:<suite>-slim

这些标签是提供更精简基础镜像的实验性版本（删除了容器中通常不需要的一些额外文件，如手册页和文档），并且可能会发生变化。

有关“精简”过程中删除内容的更多详细信息，请参见 debuerreotype-slimify 脚本（上文链接的 debuerreotype）。

许可协议

查看此镜像中包含的软件的许可信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他受其他许可协议约束的软件（例如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可信息可能位于 repo-info 仓库的 debian/ 目录中。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用都符合其中包含的所有软件的相关许可协议。