gnzsnz/apt-cacher-ng

APT-Cacher-ng Docker镜像

概述

本Docker镜像用于在本地运行https://www.unix-ag.uni-kl.de/~bloch/acng/%E6%9C%8D%E5%8A%A1%EF%BC%8C%E4%B8%BA%E5%AE%B9%E5%99%A8%E5%92%8C%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%8F%90%E4%BE%9BAPT%E7%BC%93%E5%AD%98%E5%8A%9F%E8%83%BD%E3%80%82%E5%AE%B9%E5%99%A8%E4%BC%9A%E6%AF%8F%E6%97%A5%E8%BF%90%E8%A1%8Ccron%E4%BB%BB%E5%8A%A1%E6%B8%85%E7%90%86%E7%BC%93%E5%AD%98%E3%80%82

核心功能和特性

• 提供本地APT缓存服务，加速Debian/Ubuntu系统的软件包下载
• 内置cron任务，每日自动清理缓存
• 支持通过UID/GID映射主机用户，确保数据卷权限兼容
• 构建时可配置APT代理，加速镜像构建过程

使用场景和适用范围

• 需要加速多个Debian/Ubuntu系统或容器的APT更新和软件安装
• 本地网络内多台设备共享APT缓存，减少重复下载，节省带宽
• 开发环境中统一管理APT缓存，提高容器构建效率

使用方法和配置说明

构建镜像

1. 复制环境变量示例文件并编辑配置：

   bash
   cp .env-dist .env
   nano .env
   

2. 配置环境变量：

   • UID: 容器内apt-cacher-ng用户的UID，建议与主机用户UID一致
   • GID: 容器内apt-cacher-ng用户的GID，建议与主机用户GID一致
   • APT_PROXY (可选): 构建镜像时使用的APT代理，仅用于加速镜像构建

   示例配置：

   UID=1000
   GID=1000
   APT_PROXY=http://apt_proxy:3142
   

3. 检查配置并构建镜像：

   使用docker compose构建：

   bash
   docker compose config  # 检查配置
   docker compose build
   

   或使用docker build命令：

   bash
   docker build --build-arg UID="$(id -u)" \
               --build-arg GID="$(id -g)" \
               --build-arg APT_PROXY="http://apt_proxy:3142" \
               -t gnzsnz/apt-cacher-ng:latest .
   

   注意：UID和GID用于将主机用户映射到容器内的apt-cacher-ng用户，镜像的数据卷将使用此UID和GID。

运行apt-cacher-ng

使用docker compose运行（推荐）：

bash
docker compose up -d

可根据需求修改docker-compose.yml文件调整配置。

使用docker run运行：

bash
docker run -it -p 3142:3142 docker.xuanyuan.run/gnzsnz/apt-cacher-ng:latest aptcacher

服务启动后，apt-cacher-ng将在 http://<主机名>:3142/ 可用。

客户端设置

物理机/服务器客户端配置

在需要使用APT缓存的客户端上执行以下命令：

bash
echo 'Acquire::http { Proxy "http://<apt-cacher-ng主机IP>:3142"; }' | sudo tee /etc/apt/apt.conf.d/02proxy
sudo apt update

Docker容器客户端配置

在Dockerfile中添加APT代理配置：

dockerfile
ARG APT_PROXY
RUN echo 'Acquire::http { Proxy "'$APT_PROXY'"; }' \
    | tee /etc/apt/apt.conf.d/02proxy &&\
    apt-get update && apt-get -y install <需要安装的软件>

构建镜像时传递APT缓存地址：

bash
docker build \
  --build-arg APT_PROXY="http://<apt-cacher-ng容器IP或服务名>:3142" -t your/image .

清理

停止并清理所有相关资源：

bash
docker compose down --rmi all -v