apt-mirror Docker镜像文档

镜像概述和主要用途

本镜像解决了Docker Hub上现有apt-mirror镜像基于旧基础镜像的问题，基于ubuntu:latest（当前为20.04 Focal Fosa）构建，并配置为在基础镜像更新时自动重建，确保始终保持最新。适用于镜像Ubuntu、Debian、Kali等apt仓库，通过nginx在本地网络提供仓库服务，并集成精确带宽控制机制。经测试，apt-mirror在Ubuntu 20.04上运行稳定。

核心功能和特性

预装软件及功能

• apt-mirror：核心工具，用于镜像Ubuntu、Debian、Kali等apt仓库
• wget：执行下载操作，作为apt-mirror的依赖项
• nginx：轻量级Web服务器，在本地网络中提供镜像仓库访问服务
• cron：初始下载完成后，每日自动重新运行镜像同步脚本
• iproute2：提供比wget更精确的带宽限制功能，通过tc命令实现带宽控制

使用场景和适用范围

• 需要在本地网络建立apt仓库镜像，减少外部网络依赖的环境
• 需为多台设备提供本地apt源，提升软件安装效率的场景
• 对镜像同步过程有带宽限制需求，需避免占用过多网络资源的场景
• 适用于管理Ubuntu、Debian、Kali等基于apt包管理系统的发行版仓库

详细使用方法和配置说明

部署步骤

1. 创建数据卷（推荐）

建议先创建数据卷，便于管理配置脚本，确保容器重建或升级时脚本可访问：

bash
docker volume create apt-mirror-config

2. 启动容器

使用以下命令启动容器，挂载数据卷并配置基本参数：

bash
docker run -d -it \
--name=apt-mirror \
-e TZ=Europe/London \
-v apt-mirror-config:/var/spool/apt-mirror \
--restart unless-stopped \
-p 9090:80 \
gregewing/apt-mirror

参数说明：

• -e TZ=Europe/London：设置时区（根据实际需求调整，如Asia/Shanghai）
• -v apt-mirror-config:/var/spool/apt-mirror：挂载数据卷，存储配置文件和脚本
• --restart unless-stopped：除非手动停止，否则容器自动重启
• -p 9090:80：将容器内nginx的80端口映射到宿主机9090端口，通过[***]访问仓库

配置方法

仓库镜像配置

镜像同步的仓库列表由/etc/apt/mirror.list控制，该文件在容器内持久化存储。修改后需重启容器使配置生效。

操作步骤：

1. 编辑数据卷中的配置文件（宿主机路径通常为/var/lib/docker/volumes/apt-mirror-config/_data/mirror.list），添加或调整需镜像的仓库
2. 重启容器使配置生效：

bash
docker restart apt-mirror

带宽管理

机制说明

带宽控制通过以下组件实现：

• get_adapter.id：容器启动时执行，将容器内网络适配器ID写入/var/spool/apt-mirror/adapter.id
• limit_bw：位于数据卷中，由宿主机cron任务定期执行，基于adapter.id通过tc命令应用带宽限制

配置步骤

1. 宿主机依赖准备
   确保宿主机已安装iproute2（提供tc命令），且具有执行权限（可能需要sudo权限）。

2. 配置宿主机cron任务
   在宿主机添加cron任务，定期执行limit_bw脚本（建议每60秒执行一次，确保带宽配置实时更新）：

bash
* * * * * sudo /var/lib/docker/volumes/apt-mirror-config/_data/limit_bw

3. 调整带宽参数
   编辑数据卷中的limit_bw脚本，修改以下参数控制带宽：
   • ratelimit=1mbit：设置持续速率限制
   • burstlimit=1mbit：设置突发速率限制

带宽单位说明（基于tc命令规范）

支持的速率单位：

• 比特单位：bit（比特/秒）、kbit（千比特/秒）、mbit（兆比特/秒）、gbit（吉比特/秒）、tbit（太比特/秒）
• 字节单位：bps（字节/秒）、kbps（千字节/秒）、mbps（兆字节/秒）、gbps（吉字节/秒）、tbps（太字节/秒）
  （注：IEC单位可使用ki-、mi-等前缀，如kibit、mibps）

注意事项

• 带宽控制依赖宿主机的iproute2和cron服务，需确保宿主机已正确配置并具有执行权限
• 修改mirror.list后必须重启容器，配置才能生效
• 宿主机cron任务的执行间隔建议设为60秒，以确保带宽参数变更后及时应用
• 容器启动时会自动开始仓库同步，如需调整同步计划，可修改容器内cron配置（路径/etc/crontab）