seterrychen/apt-mirror-http-server

apt-mirror-http-server镜像说明

镜像概述

本镜像基于Docker构建APT（Advanced Packaging Tools）镜像HTTP服务器，帮助用户快速搭建本地软件包镜像服务，实现软件包的缓存与分发，减少外部网络依赖，提升软件安装效率。

核心功能

1. 提供APT镜像的HTTP访问服务，支持客户端通过APT工具获取软件包；
2. 允许自定义mirror.list配置文件，替换默认的Ubuntu镜像源；
3. 可设置自动同步周期（默认12小时），保持镜像内容更新；
4. 支持数据持久化，将镜像数据存储到本地目录。

使用场景

1. 企业内部环境：构建本地APT镜像源，降低外部网络带宽消耗，加速内部服务器的软件安装与更新；
2. 开发测试环境：快速搭建软件包镜像服务，提升开发人员依赖安装速度；
3. 教育/科研机构：共享软件包资源，方便内部用户访问常用软件包。

配置说明

基础部署命令

bash
docker run -d \
           -v /本地数据路径:/var/spool/apt-mirror \
           -p 8080:80 docker.xuanyuan.run/seterrychen/apt-mirror-http-server

• -v /本地数据路径:/var/spool/apt-mirror：将本地目录挂载到容器内，用于持久化存储APT镜像数据；
• -p 8080:80：将容器的80端口映射到主机的8080端口，通过主机8080端口访问镜像服务。

自定义配置选项

1. 替换镜像源列表：

   bash
   docker run -d \
              -v /本地数据路径:/var/spool/apt-mirror \
              -v /本地mirror.list路径:/etc/apt/mirror.list \
              -p 8080:80 docker.xuanyuan.run/seterrychen/apt-mirror-http-server
   

   替换/本地mirror.list路径为您自定义的镜像源配置文件路径。

2. 设置同步周期：

   bash
   docker run -d \
              -v /本地数据路径:/var/spool/apt-mirror \
              -e RESYNC_PERIOD=18h \
              -p 8080:80 docker.xuanyuan.run/seterrychen/apt-mirror-http-server
   

   通过RESYNC_PERIOD环境变量设置同步周期（支持h、m等单位，如18h表示18小时），默认值为12小时。

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  apt-mirror:
    image: docker.xuanyuan.run/seterrychen/apt-mirror-http-server
    volumes:
      - ./apt-mirror-data:/var/spool/apt-mirror
      - ./mirror.list:/etc/apt/mirror.list
    environment:
      - RESYNC_PERIOD=24h
    ports:
      - "8080:80"
    restart: always

执行docker-compose up -d启动服务。

更新日志

• 2017-04-27（版本0.1）：
  • 基础镜像更新为Ubuntu 16.04；
  • 移除MIRROR_URL选项；
  • 将环境变量TIMEOUT重命名为RESYNC_PERIOD；
  • 修复setup.sh中HTTPS处理不正确的问题（#1）。