Debian (arm64v8) Docker镜像文档

镜像概述

关于Debian

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

***: Debian

!Debian logo

本镜像说明

注意：本仓库是debian镜像的arm64v8架构专用仓库。更多信息请参见镜像文档中的“非amd64架构说明”和***镜像FAQ中的“镜像源码在Git中变更后如何处理？”。

本镜像旨在提供最小化的Debian环境（容器的不可变/分层特性决定了添加内容比删除更简单）。具体而言，镜像基于“minbase”变体构建，仅包含“必需”软件包，在保持“Debian”特性（由Debian发布团队和FTP团队定义管理）的同时实现最小镜像体积。

核心功能与特性

最小化基础镜像：基于minbase变体构建，仅包含运行Debian所需的核心组件，减少镜像体积
多架构支持：除arm64v8外，还支持amd64、arm32v5、arm32v7、i386等多种架构
可重现构建：使用debuerreotype工具构建，确保镜像生成过程透明可重现
***镜像源：默认使用deb.debian.org CDN镜像源，兼顾可靠性与访问速度
滚动更新支持：提供stable、testing、unstable等滚动发布版本标签，满足不同稳定性需求
变体选择：提供标准版与slim版（移除文档、man pages等非必要文件），适应不同场景需求

支持的标签及Dockerfile链接

标签	Dockerfile链接
`bookworm`, `bookworm-20250929`, `12.12`, `12`	Dockerfile
`bookworm-backports`	Dockerfile
`bookworm-slim`, `bookworm-20250929-slim`, `12.12-slim`, `12-slim`	Dockerfile
`bullseye`, `bullseye-20250929`, `11.11`, `11`	Dockerfile
`bullseye-slim`, `bullseye-20250929-slim`, `11.11-slim`, `11-slim`	Dockerfile
`experimental`, `experimental-20250929`	Dockerfile
`forky`, `forky-20250929`	Dockerfile
`forky-backports`	Dockerfile
`forky-slim`, `forky-20250929-slim`	Dockerfile
`oldoldstable`, `oldoldstable-20250929`	Dockerfile
`oldoldstable-slim`, `oldoldstable-20250929-slim`	Dockerfile
`oldstable`, `oldstable-20250929`	Dockerfile
`oldstable-backports`	Dockerfile
`oldstable-slim`, `oldstable-20250929-slim`	Dockerfile
`rc-buggy`, `rc-buggy-20250929`	Dockerfile
`sid`, `sid-20250929`	Dockerfile
`sid-slim`, `sid-20250929-slim`	Dockerfile
`stable`, `stable-20250929`	Dockerfile
`stable-backports`	Dockerfile
`stable-slim`, `stable-20250929-slim`	Dockerfile
`testing`, `testing-20250929`	Dockerfile
`testing-backports`	Dockerfile
`testing-slim`, `testing-20250929-slim`	Dockerfile
`trixie`, `trixie-20250929`, `13.1`, `13`, `latest`	Dockerfile
`trixie-backports`	Dockerfile
`trixie-slim`, `trixie-20250929-slim`, `13.1-slim`, `13-slim`	Dockerfile
`unstable`, `unstable-20250929`	Dockerfile
`unstable-slim`, `unstable-20250929-slim`	Dockerfile

使用场景

开发环境

作为本地开发环境的基础镜像，提供标准化的Debian系统环境，确保开发与生产环境一致性。

应用部署基础

作为各类应用（如Web服务、数据库、中间件）的基础镜像，通过Dockerfile构建包含应用依赖的定制镜像。

CI/CD流程

在持续集成/持续部署流程中作为构建或测试环境，提供轻量、一致的运行时环境。

学***与测试

用于学***Debian系统操作、测试软件在不同Debian版本上的兼容性。

嵌入式系统

针对arm64v8架构，适合作为嵌入式设备（如树莓派、边缘计算设备）的应用容器基础。

使用方法与配置说明

基本操作

拉取镜像

bash
docker pull arm64v8/debian:latest  # 拉取最新稳定版
docker pull arm64v8/debian:12-slim  # 拉取Debian 12 slim版
docker pull arm64v8/debian:testing  # 拉取测试版

运行交互式容器

bash
docker run -it --rm arm64v8/debian:latest bash  # 启动临时交互式shell

运行后台容器

bash
docker run -d --name debian-base arm64v8/debian:stable  # 后台运行容器
docker exec -it debian-base bash  # 进入运行中的容器

配置 locales

本镜像默认仅包含C、C.UTF-8和POSIX三种locales。对于大多数UTF-8需求，C.UTF-8已足够，可通过环境变量配置：

bash
docker run -it --rm -e LANG=C.UTF-8 arm64v8/debian:latest bash

如需其他locale（如en_US.UTF-8），需手动安装并生成：

dockerfile
# Dockerfile示例
FROM arm64v8/debian:latest

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

Dockerfile示例：构建应用镜像

以构建一个包含Python的应用镜像为例：

dockerfile
FROM arm64v8/debian:12-slim

# 更新apt源并安装Python
RUN apt-get update && apt-get install -y --no-install-recommends \
    python3 \
    python3-pip \
    && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /app

# 复制应用代码并安装依赖
COPY requirements.txt .
RUN pip3 install --no-cache-dir -r requirements.txt

COPY . .

# 运行应用
CMD ["python3", "app.py"]

docker-compose配置示例

yaml
version: '3'

services:
  app:
    build: .
    image: arm64v8/debian:12-slim
    container_name: my-debian-app
    environment:
      - LANG=C.UTF-8
    volumes:
      - ./app:/app
    command: bash -c "cd /app && python3 app.py"