apt-source Docker镜像文档

镜像概述

apt-source是一个轻量级Docker镜像，专为Debian/Ubuntu系统设计，用于快速搭建和管理本地APT源。通过该镜像，用户可以轻松配置、同步和维护APT软件源，实现软件包的本地缓存和快速分发，有效解决网络环境限制导致的软件安装缓慢问题。

核心功能与特性

• 支持主流Debian和Ubuntu发行版的APT源同步
• 提供灵活的源配置选项，支持多种架构(x86_64, arm64等)
• 增量同步功能，减少带宽占用和同步时间
• 内置Web服务，可作为本地网络的APT源服务器
• 支持自定义源配置和过滤规则
• 轻量级设计，资源占用低，部署简单

适用场景

• 企业内部网络环境中搭建本地APT源，加速多台服务器的软件安装
• 网络带宽有限或访问外部源受限的环境
• 需要频繁部署相同系统环境的开发或测试场景
• 对软件包下载速度有较高要求的生产环境
• 教学或实验环境中需要离线使用APT源的场景

快速开始

基本使用

使用以下命令快速启动apt-source容器：

bash
docker run -d \
  --name apt-source \
  -p 80:80 \
  -v /path/to/local/repo:/var/www/html \
  -e APT_MIRROR="[***]" \
  -e APT_DISTRIBUTION="focal" \
  -e APT_COMPONENTS="main universe multiverse restricted" \
  wise2c/apt-source:latest

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  apt-source:
    image: wise2c/apt-source:latest
    container_name: apt-source
    restart: always
    ports:
      - "80:80"
    volumes:
      - ./repo_data:/var/www/html
      - ./config:/etc/apt-source
    environment:
      - APT_MIRROR=[***]
      - APT_DISTRIBUTION=focal
      - APT_COMPONENTS=main universe multiverse restricted
      - SYNC_SCHEDULE=0 1 * * *
      - MAX_RETRIES=3

启动服务：

bash
docker-compose up -d

配置参数

环境变量配置

卷挂载

高级配置

自定义源列表

在/etc/apt-source/sources.list.d/目录下创建自定义源配置文件，容器会自动识别并同步这些源。

同步周期调整

通过修改SYNC_SCHEDULE环境变量设置同步周期，使用标准crontab格式。例如：

• 每6小时同步一次: 0 */6 * * *
• 每天凌晨3点同步: 0 3 * * *

架构支持

通过APT_ARCHITECTURES环境变量指定支持的架构，多个架构用空格分隔，例如: APT_ARCHITECTURES="amd64 arm64 i386"

维护与管理

手动触发同步

bash
docker exec -it apt-source /usr/local/bin/sync-apt-source

查看同步日志

bash
docker logs -f apt-source

更新镜像

bash
docker pull wise2c/apt-source:latest
docker-compose down
docker-compose up -d

常见问题

同步速度慢怎么办？

• 尝试更换APT_MIRROR为距离更近的***镜像源
• 减少同步的发行版或组件数量
• 调整同步周期，避开网络高峰期

如何添加自定义PPA源？

在/etc/apt-source/sources.list.d/目录下创建.list文件，添加PPA源地址，容器会自动处理GPG密钥和同步。

存储空间不足如何处理？

• 清理不再需要的旧版本软件包
• 增加存储卷的大小
• 配置更严格的过滤规则，减少同步的软件包数量