ustcmirror/aptsync

aptsync 镜像文档

概述

aptsync镜像是一个基于apt-mirror工具的Docker镜像，专为同步Debian、Ubuntu及其衍生发行版的APT软件仓库设计。通过容器化部署简化了apt-mirror的配置与运行流程，用户无需在主机系统直接安装依赖，即可快速搭建本地APT镜像源，适用于需要本地缓存软件包以减少外部带宽依赖或提高软件安装速度的场景。

核心功能与特性

• 基于apt-mirror工具构建，支持标准APT仓库同步协议
• 容器化设计，隔离运行环境，避免对主机系统的依赖污染
• 支持自定义同步规则，包括发行版版本（如Ubuntu 22.04 Jammy）、架构（如amd64、arm64）及软件组件（main、contrib、non-free）
• 可配置同步周期、线程数及日志输出，优化同步效率与可观测性
• 兼容官方APT仓库及第三方PPA（Personal Package Archive），需正确配置源地址

使用场景

• 企业/机构内部网络：搭建本地APT镜像源，减少外部网络带宽消耗，提升内部软件安装速度
• 开发/测试环境：缓存稳定版本软件包，避免外部仓库更新或网络波动对环境一致性的影响
• 教育/科研机构：为实验室或校园网络提供本地化软件仓库，支持离线环境下的软件部署
• 旧版本系统维护：同步特定历史版本的APT仓库（如Ubuntu 18.04 Bionic），满足旧系统的软件更新需求

使用方法

基本部署（docker run）

bash
docker run -d \
  --name aptsync \
  -v /path/to/local/mirror.list:/etc/apt/mirror.list \
  -v /path/to/local/storage:/var/spool/apt-mirror \
  -e SYNC_INTERVAL=24h \
  ustclug/aptsync

参数说明：

• -v /path/to/local/mirror.list:/etc/apt/mirror.list：挂载本地apt-mirror配置文件（必选）
• -v /path/to/local/storage:/var/spool/apt-mirror：挂载本地目录用于存储同步的仓库文件（必选，需预留足够存储空间）
• -e SYNC_INTERVAL=24h：设置同步周期（可选，默认24h，格式支持1h/30m/7d等，设为0时仅执行单次同步）

docker-compose 配置示例

yaml
version: '3'
services:
  aptsync:
    image: ustclug/aptsync
    container_name: aptsync
    volumes:
      - ./mirror.list:/etc/apt/mirror.list  # 本地配置文件路径
      - ./apt-mirror-storage:/var/spool/apt-mirror  # 本地存储路径
    environment:
      - SYNC_INTERVAL=12h  # 每12小时同步一次
      - LOG_LEVEL=info  # 日志级别：info/debug/warn
    restart: unless-stopped  # 异常退出后自动重启

配置说明

核心配置文件（mirror.list）

mirror.list是apt-mirror的核心配置文件，用于定义同步规则，需通过挂载传入容器。典型配置示例：

conf
# 基础路径配置（容器内固定路径，不可修改）
set base_path    /var/spool/apt-mirror
set mirror_path  $base_path/mirror
set skel_path    $base_path/skel
set var_path     $base_path/var
set cleanscript $var_path/clean.sh
set defaultarch  amd64  # 默认架构
set postmirror_script $var_path/postmirror.sh
set run_postmirror 0
set nthreads     20  # 同步线程数，根据网络带宽调整
set _tilde 0

# 同步规则示例（Ubuntu 22.04 Jammy）
deb http://archive.ubuntu.com/ubuntu jammy main restricted universe multiverse
deb http://archive.ubuntu.com/ubuntu jammy-updates main restricted universe multiverse
deb http://archive.ubuntu.com/ubuntu jammy-backports main restricted universe multiverse
deb http://security.ubuntu.com/ubuntu jammy-security main restricted universe multiverse

# 同步规则示例（Debian 12 Bookworm）
# deb http://deb.debian.org/debian bookworm main contrib non-free non-free-firmware
# deb http://deb.debian.org/debian bookworm-updates main contrib non-free non-free-firmware
# deb http://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware

注意：base_path必须设为/var/spool/apt-mirror，与容器内存储路径保持一致。

环境变量

存储管理

• 同步后的仓库文件存储于/var/spool/apt-mirror/mirror目录，需通过持久化卷挂载至本地磁盘
• 建议根据同步的仓库大小预留足够空间（基础Ubuntu发行版完整同步通常需要数十GB至数百GB）
• 可通过配置cleanscript定期清理过期软件包，减少存储空间占用

注意事项

• 初次同步耗时较长，取决于网络带宽及同步仓库大小，建议在非高峰时段启动
• 若同步第三方PPA，需确保源地址格式正确（通常为deb http://ppa.launchpadcontent.net/<user>/<repo>/ubuntu <dist> main）
• 容器运行用户为非root用户，挂载的本地目录需确保有读写权限（建议设置权限为755）
• 如需通过Web服务器（如Nginx）对外提供镜像服务，需将/var/spool/apt-mirror/mirror目录映射至Web服务的根目录下