mbentley/apt-cacher-ng

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），可在https://hub.docker.com/repository/docker/mbentley/apt-cacher-ng/tags?page=1&ordering=last_updated&name=latest-20%E6%9F%A5%E7%9C%8B%E3%80%82%E8%BF%99%E4%BA%9B%E6%A0%87%E7%AD%BE%E4%B8%BA%E6%97%B6%E9%97%B4%E7%82%B9%E5%BF%AB%E7%85%A7%EF%BC%8C%E4%BF%9D%E7%95%996%E4%B8%AA%E6%9C%88%E4%B8%94%E4%B8%8D%E6%8E%A5%E6%94%B6%E5%AE%89%E5%85%A8%E6%9B%B4%E6%96%B0%EF%BC%8C%E5%BB%BA%E8%AE%AE%E4%BB%85%E9%9C%80%E5%9B%BA%E5%AE%9A%E9%95%9C%E5%83%8F%E6%91%98%E8%A6%81%E6%97%B6%E4%BD%BF%E7%94%A8%EF%BC%8C%E5%90%A6%E5%88%99%E4%BC%98%E5%85%88%E9%80%89%E6%8B%A9%E5%B8%B8%E8%A7%84%E6%A0%87%E7%AD%BE%E3%80%82

核心功能与特性

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

使用场景

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

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

使用方法与配置说明

基本运行命令

bash
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 \
  docker.xuanyuan.run/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可查看缓存状态报告，确认服务运行正常。