ustcmirror/archvsync

archvsync Docker镜像

概述

archvsync是一个用于同步Arch Linux软件仓库的Docker镜像，基于USTC镜像站的同步方案构建。该镜像提供了便捷的方式来维护本地Arch Linux镜像，能够高效地将官方仓库内容同步到本地服务器，支持增量同步、定时任务和带宽控制等功能。

核心功能

• 高效的增量同步机制，仅同步变更内容
• 支持定时自动同步
• 带宽控制功能，避免网络拥塞
• 完整的日志记录系统
• 自动校验同步文件完整性
• 支持多种同步协议
• 轻量级设计，资源占用低

使用场景

• 大学、企业或组织内部搭建Arch Linux镜像服务器
• 开源社区维护Arch Linux软件镜像站点
• 网络条件有限环境下提高软件安装速度
• 开发团队内部共享Arch Linux软件资源

使用方法

基本用法

bash
docker run -d \
  --name archvsync \
  -v /path/to/local/mirror:/mirror \
  -e UPSTREAM_URL=https://mirrors.ustc.edu.cn/archlinux/ \
  -e TARGET_PATH=/mirror/archlinux \
  ustclug/archvsync

环境变量配置

Docker Compose配置

yaml
version: '3'

services:
  archvsync:
    image: ustclug/archvsync
    container_name: archvsync
    restart: always
    volumes:
      - /data/mirror/archlinux:/mirror
    environment:
      - UPSTREAM_URL=https://mirrors.ustc.edu.cn/archlinux/
      - TARGET_PATH=/mirror/archlinux
      - SYNC_INTERVAL=720
      - BANDWIDTH_LIMIT=10240
      - LOG_LEVEL=INFO
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

手动触发同步

bash
docker exec -it archvsync /usr/local/bin/archvsync

查看同步日志

bash
docker logs -f archvsync

注意事项

1. 首次同步会下载完整的Arch Linux仓库，需要较大磁盘空间(通常需要数十GB)
2. 确保目标目录有足够的存储空间和写入权限
3. 建议使用稳定的网络连接进行同步操作
4. 生产环境中建议配置数据卷备份策略
5. 同步过程可能需要较长时间，具体取决于网络速度和仓库大小

维护与更新

更新镜像:

bash
docker pull ustclug/archvsync
docker restart archvsync

查看同步状态:

bash
docker exec -it archvsync /usr/local/bin/archvsync status

相关链接

• USTC镜像站
• Arch Linux官方网站
• https://github.com/***/ustcmirror-images