amd64/debian

Debian Docker 镜像文档

快速参考

• 维护者：
  Debian 开发者 https://qa.debian.org/developer.php?login=tianon 和 https://qa.debian.org/developer.php?login=paultag

• 获取帮助：
  https://dockr.ly/comm-slack%E3%80%81Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic

• 提交 issue：
  https://github.com/debuerreotype/docker-debian-artifacts/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/debian/%E3%80%81https://hub.docker.com/r/arm32v5/debian/%E3%80%81https://hub.docker.com/r/arm32v7/debian/%E3%80%81https://hub.docker.com/r/arm64v8/debian/%E3%80%81https://hub.docker.com/r/i386/debian/%E3%80%81https://hub.docker.com/r/mips64le/debian/%E3%80%81https://hub.docker.com/r/ppc64le/debian/%E3%80%81https://hub.docker.com/r/riscv64/debian/%E3%80%81https://hub.docker.com/r/s390x/debian/

• 镜像元数据：
  https://github.com/docker-library/repo-info/blob/master/repos/debian%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/debian%EF%BC%89
  （包含镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fdebian
  https://github.com/docker-library/official-images/blob/master/library/debian%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/debian%EF%BC%89

• 文档来源：
  https://github.com/docker-library/docs/tree/master/debian%EF%BC%88https://github.com/docker-library/docs/commits/master/debian%EF%BC%89

支持的标签及对应 Dockerfile 链接

镜像概述和主要用途

Debian 是一款主要由自由开源软件组成的操作系统，遵循 GNU 通用公共许可证，由 Debian 项目社区开发维护。作为最流行的 Linux 发行版之一，Debian 广泛用于个人计算机和网络服务器，并作为众多其他 Linux 发行版的基础。

本镜像为 amd64 架构的 Debian 官方镜像，旨在提供最小化、可靠的基础环境，适用于构建容器化应用、开发环境或作为其他应用镜像的基础层。

核心功能和特性

1. 最小化基础构建

基于 Debian 的 minbase 变体构建（仅包含“必需”软件包），确保最小化镜像体积，同时保留 Debian 系统的核心功能。

2. 多版本与变体支持

• 稳定版：如 bookworm（12.x）、bullseye（11.x），提供长期支持和稳定性。
• 滚动更新版：如 stable、testing、unstable，使用滚动套件名称（如 deb http://deb.debian.org/debian testing main）。
• 精简版（-slim）：移除手册页、文档等非必要文件，进一步减小镜像体积，适合资源受限场景。

3. 可靠的软件源

默认使用 https://deb.debian.org CDN 镜像源，确保全球用户的访问可靠性（自 2016-10-20 起成为 debootstrap 的默认镜像源）。

4. 可重现构建

通过工具 https://github.com/debuerreotype/debuerreotype 构建，确保镜像透明可重现，支持基于相同工具链重新生成一致的 rootfs tarball。

5. 多架构支持

除 amd64 外，还支持 arm32v5、arm64v8、i386、ppc64le 等多种架构（详见“快速参考”部分）。

使用场景和适用范围

1. 应用基础镜像

作为容器化应用的基础层，提供稳定的 Debian 运行环境，适用于 Python、Node.js、Java 等各类应用。

2. 开发与测试环境

快速搭建隔离的 Debian 开发环境，支持安装特定版本的依赖包，便于开发和测试。

3. 服务器环境

用于部署轻量级服务（如 Nginx、MySQL、Redis 等），利用-slim 变体可减少资源占用。

4. CI/CD 流水线

在持续集成/部署流程中作为构建或测试阶段的基础环境，确保环境一致性。

5. 学习与实验

用于学习 Linux 命令、Debian 系统管理或测试跨版本兼容性。

详细的使用方法和配置说明

基本使用

1. 运行交互式终端

bash
docker run --rm -it docker.xuanyuan.run/amd64/debian:latest bash

• --rm：容器退出后自动删除
• -it：交互式终端模式
• amd64/debian:latest：使用最新稳定版镜像
• bash：启动 bash 终端

2. 运行自定义命令

bash
docker run --rm docker.xuanyuan.run/amd64/debian:bookworm-slim cat /etc/os-release

输出 Debian 版本信息。

3. 挂载本地目录

bash
docker run --rm -it -v $(pwd):/app docker.xuanyuan.run/amd64/debian:trixie-slim bash

将当前目录挂载到容器内 /app 目录，便于文件交互。

Docker Compose 配置示例

yaml
version: '3'
services:
  debian-app:
    image: docker.xuanyuan.run/amd64/debian:bookworm
    container_name: debian-demo
    tty: true  # 保持终端运行
    environment:
      - LANG=C.UTF-8  # 设置默认编码
    volumes:
      - ./data:/data  # 挂载数据卷
    command: bash  # 启动命令

启动命令：docker-compose up -d