konstruktoid/apt-cacher-ng

Apt-Cacher NG

官网

Apt-Cacher NG 是一款针对 Debian/Ubuntu 系统的软件包缓存工具，通过缓存软件包下载请求，加速多台主机的软件安装与更新过程，有效节省网络带宽。以下是其 Docker 镜像的部署与使用指南。

手动构建

构建镜像

使用以下命令构建本地镜像：

sh
docker build --no-cache --tag apt-cacher-ng:latest -f Dockerfile .

运行容器

构建完成后启动容器，映射默认服务端口 3142：

sh
docker run -d --cap-drop=all --name apt-cacher-ng -p 3142:3142 apt-cacher-ng VerboseLog=1 Debug=7 ForeGround=1 PassThroughPattern=.*

• --cap-drop=all：移除容器不必要的 Linux 权限，增强安全性
• VerboseLog=1 Debug=7：启用详细日志与调试模式
• ForeGround=1：使服务前台运行，便于容器进程管理
• 访问缓存状态报告：http://DOCKERCONTAINERIP:3142/acng-report.html（替换 DOCKERCONTAINERIP 为容器实际 IP）

AppArmor 安全配置

./apparmor/ 目录提供 AppArmor 安全策略文件，运行时可添加安全选项：

sh
docker run -d --security-opt="apparmor:docker-aptcacherng" --name apt-cacher-ng -p 3142:3142 apt-cacher-ng VerboseLog=1 Debug=7 ForeGround=1 PassThroughPattern=.*

自动构建

直接使用预构建镜像 konstruktoid/apt-cacher-ng 快速部署，适合生产环境：

sh
docker run -d --restart=always --cap-drop=all --name apt-cacher-ng -p 3142:3142 konstruktoid/apt-cacher-ng VerboseLog=1 Debug=7 ForeGround=1 PassThroughPattern=.*

• --restart=always：配置容器退出后自动重启，确保服务持续可用

客户端配置

Debian/Ubuntu 客户端需配置 apt 代理以使用缓存服务，方法如下：

手动配置

创建或编辑 /etc/apt/apt.conf.d/01proxy 文件，添加代理设置（替换 172.17.0.2 为容器 IP）：

sh
Acquire::ftp { Proxy "http://172.17.0.2:3142"; }
Acquire::http { Proxy "http://172.17.0.2:3142"; }
Acquire::https { Proxy "http://172.17.0.2:3142"; }

自动配置脚本

通过以下脚本自动获取容器 IP 并生成代理配置：

sh
#!/bin/bash

set -eu
set -o pipefail

PROTO="ftp http https"

CIP=$(docker inspect -f '{{.NetworkSettings.IPAddress}}' apt-cacher-ng)

for p in $PROTO; do
  PROXY_ACQUIRE="Acquire::$p { Proxy \"http://$CIP:3142\"; }"
  if [[ -d /etc/apt/apt.conf.d ]]; then
    echo "${PROXY_ACQUIRE}" | \
      sudo tee --append /etc/apt/apt.conf.d/01proxy
  else
    echo "${PROXY_ACQUIRE}"
  fi
done

• 脚本通过 docker inspect 获取容器 IP（CIP），为 ftp、http、https 协议生成 apt 代理配置
• 若客户端存在 /etc/apt/apt.conf.d 目录，配置将追加至 01proxy 文件，否则直接输出配置内容