ustcmirror/rsync

rsync 镜像容器

镜像概述

本镜像属于 ustcmirror-images 项目，专为镜像站点设计，提供基于 rsync 协议的高效文件同步服务。通过封装 rsync 工具，实现上游镜像资源的定期同步，帮助用户快速构建和维护本地镜像仓库，适用于需要高效、低带宽占用的镜像同步场景。

核心功能与特性

• 增量同步：采用 rsync 核心算法，仅传输文件差异部分，显著减少带宽消耗和同步时间
• 灵活配置：支持自定义同步源地址、目标路径、同步周期及额外 rsync 参数
• 轻量级设计：基于精简基础镜像（如 Alpine）构建，镜像体积小，资源占用低
• 周期同步：内置定时任务机制，可配置固定间隔自动执行同步操作
• 兼容性强：支持标准 rsync 协议，兼容主流上游镜像源（如 Linux 发行版仓库、编程语言包管理器仓库等）

使用场景

• 本地镜像源构建：大学、企业或组织搭建内部 Linux 发行版（如 Ubuntu、CentOS）、编程语言包（如 PyPI、npm）等镜像仓库
• 上游镜像同步：需要定期从官方或第三方镜像源同步资源的场景
• 带宽敏感环境：对网络带宽有限制，需控制同步流量的场景
• 自动化运维：集成到 CI/CD 或运维系统中，实现镜像资源的自动化更新

使用方法与配置

基本使用（docker run）

bash
docker run -d \
  --name rsync-mirror \
  -e RSYNC_SRC="rsync://rsync.example.com/ubuntu/" \  # 上游 rsync 源地址
  -e RSYNC_DEST="/mirror/ubuntu" \                   # 容器内同步目标路径
  -e SYNC_INTERVAL=1440 \                            # 同步周期（分钟，默认 60）
  -e RSYNC_OPTIONS="-avz --delete --exclude=tmp" \   # 额外 rsync 参数
  -v /path/to/local/mirror:/mirror \                 # 挂载本地目录持久化数据
  ustclug/ustcmirror-images:rsync

docker-compose 配置示例

yaml
version: '3.8'

services:
  rsync-mirror:
    image: ustclug/ustcmirror-images:rsync
    container_name: rsync-mirror
    restart: always
    environment:
      # 必选：上游 rsync 源地址（支持 rsync:// 或 user@host:path 格式）
      RSYNC_SRC: "rsync://rsync.mirrors.ustc.edu.cn/centos/"
      # 必选：容器内同步目标路径（需与挂载卷对应）
      RSYNC_DEST: "/mirror/centos"
      # 可选：同步周期（分钟，默认 60）
      SYNC_INTERVAL: 720
      # 可选：rsync 额外参数（默认 "-avz --delete"）
      RSYNC_OPTIONS: "-avz --delete --progress --exclude=.~tmp~"
      # 可选：日志级别（debug/info/warn/error，默认 info）
      LOG_LEVEL: "info"
    volumes:
      # 挂载本地目录存储同步数据（需确保目录权限正确）
      - /data/mirror/centos:/mirror/centos
    networks:
      - mirror-network

networks:
  mirror-network:
    driver: bridge

关键配置参数

数据持久化

通过 -v 参数挂载本地目录至容器内的 RSYNC_DEST 路径（如示例中的 /mirror/ubuntu），确保同步数据在容器重启后不丢失。本地目录需提前创建并赋予适当权限（建议设置 755 权限，避免权限错误）。

同步日志查看

容器日志包含同步过程详情，可通过以下命令查看：

bash
docker logs -f rsync-mirror

注意事项

• 网络权限：确保容器可访问上游 rsync 源（需开放出站 873 端口，若源使用非标准端口需额外配置）
• 存储容量：本地挂载目录需预留足够空间，建议根据上游源大小预留 1.5 倍存储空间
• 首次同步：首次同步可能耗时较长（取决于源数据量和网络速度），建议在低峰期执行
• 安全配置：若上游源需要认证，可在 RSYNC_SRC 中包含用户名（如 user@host:path），并通过环境变量或密钥文件提供认证信息（需额外挂载密钥文件至容器内 ~/.ssh/ 目录）