mbentley/apt-cacher-ng

镜像概述

基于Debian（trixie/bookworm/bullseye）的apt-cacher-ng Docker镜像，主要用途是作为APT包缓存服务器，通过缓存Debian/Ubuntu系统的软件包，减少重复下载，加速软件包安装过程，降低网络带宽消耗。

镜像标签

多架构标签

以下标签支持amd64和arm64架构，系统会根据主机架构自动拉取对应版本：

• latest
• trixie
• bookworm
• bullseye

也可使用架构特定标签显式指定架构：

• latest-amd64, trixie-amd64
• latest-arm64, trixie-arm64
• bookworm-amd64, bookworm-arm64
• bullseye-amd64, bullseye-arm64

日期特定标签

latest、trixie、bookworm和bullseye标签每日生成唯一清单，格式为<tag>-YYYYMMDD（如latest-20220215），可在Docker Hub查看。这些标签为时间点快照，保留6个月且不接收安全更新，建议仅需固定镜像摘要时使用，否则优先选择常规标签。

核心功能与特性

• 基于Debian稳定版：构建于Debian trixie/bookworm/bullseye，确保系统稳定性
• 多架构支持：同时兼容amd64和arm64硬件平台
• 持久化缓存：通过数据卷挂载实现缓存数据持久化，容器重启不丢失
• 灵活配置：支持通过环境变量设置运行用户（PUID/PGID）及时区（TZ）
• 完整服务组件：集成cron和rsyslogd，保障计划任务执行和日志记录功能
• 默认HTTPS穿透：已启用443端口PassThroughPattern，支持HTTPS仓库访问

使用场景

适用于需管理多个Debian/Ubuntu系统的环境：

• 开发/测试环境：加速多台开发机的软件包安装与更新
• 服务器集群：减少集群内重复下载，降低外部带宽依赖
• 网络受限环境：在带宽有限场景下提升软件部署效率

使用方法与配置说明

基本运行命令

docker run -d \
  --name apt-cacher-ng \
  -p 3142:3142 \
  -e TZ="US/Eastern" \
  -e PUID=0 \
  -e PGID=0 \
  -v /data/apt-cacher-ng:/var/cache/apt-cacher-ng \
  mbentley/apt-cacher-ng

参数说明：

• -d：后台运行容器
• --name apt-cacher-ng：指定容器名称
• -p 3142:3142：映射容器3142端口（apt-cacher-ng默认端口）到宿主机
• -e TZ：设置时区（如"Asia/Shanghai"）
• -e PUID/PGID：设置运行用户/组ID（默认0即root，可改为非root值）
• -v：挂载宿主机目录到容器缓存目录，实现缓存数据持久化

环境变量配置

客户端配置

在Debian/Ubuntu客户端创建或修改/etc/apt/apt.conf文件，添加代理配置：

Acquire::http::Proxy "http://<docker-host>:3142";

将<docker-host>替换为运行容器的宿主机IP或域名。

绕过缓存配置

客户端级别绕过

在客户端/etc/apt/apt.conf中为特定仓库设置直接连接：

Acquire::HTTP::Proxy::<repo-url> "DIRECT";

示例（绕过Docker和VirtualBox仓库）：

Acquire::HTTP::Proxy::get.docker.com "DIRECT";
Acquire::HTTP::Proxy::download.virtualbox.org "DIRECT";

服务端级别绕过

修改容器内/etc/apt-cacher-ng/acng.conf，添加PassThroughPattern规则：

PassThroughPattern: get\.docker\.com
PassThroughPattern: download\.virtualbox\.org

建议：通过数据卷挂载持久化配置文件（如-v /path/to/acng.conf:/etc/apt-cacher-ng/acng.conf），避免容器重启后配置丢失。

服务验证

服务启动后，访问http://<docker-host>:3142/acng-report.html可查看缓存状态报告，确认服务运行正常。