Rudolfs: 高性能Git LFS服务器

镜像概述

Rudolfs是一个专为Git LFS（Large File Storage）设计的服务器应用，用于存储和管理Git LFS对象。它以高性能和缓存机制为核心特性，采用AWS S3作为后端存储，旨在提供可靠、可扩展且高效的Git LFS对象存储解决方案，适用于需要处理大型二进制文件的Git工作流场景。

核心功能和特性

高性能架构

• 优化的对象处理流程，支持高并发LFS对象上传和下载请求
• 内置缓存机制，减少对AWS S3的直接访问，提升重复请求的响应速度

存储与集成

• 深度集成AWS S3，将Git LFS对象持久化存储于S3 buckets
• 支持S3兼容存储服务（需配置兼容端点）

可靠性与可扩展性

• 无状态设计，便于水平扩展以应对高负载
• 缓存层可配置为本地磁盘或分布式缓存，提升可用性

安全特性

• 支持AWS IAM认证及S3预签名URL机制
• 可集成外部认证系统（如OAuth2、基本认证）控制访问权限

使用场景和适用范围

企业级Git LFS服务

• 为企业内部Git服务（如GitLab、Gitea、GitHub Enterprise）提供专用LFS后端
• 替代第三方LFS服务，降低数据出境风险和服务依赖

高并发LFS场景

• 团队协作中频繁上传/下载大型二进制文件（如设计稿、数据集、构建产物）
• CI/CD流水线中LFS对象的自动化拉取和推送

成本优化需求

• 通过缓存减少S3 API调用次数，降低云存储访问成本
• 适合需要控制存储支出同时保证性能的组织

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name rudolfs \
  -p 8080:8080 \
  -v /path/to/local/cache:/cache \
  -e AWS_ACCESS_KEY_ID=your-aws-access-key \
  -e AWS_SECRET_ACCESS_KEY=your-aws-secret-key \
  -e S3_BUCKET=your-lfs-bucket \
  -e S3_REGION=us-east-1 \
  -e CACHE_DIR=/cache \
  jasonwhite/rudolfs

Docker Compose配置

yaml
version: '3'
services:
  rudolfs:
    image: jasonwhite/rudolfs
    container_name: rudolfs
    ports:
      - "8080:8080"
    volumes:
      - ./cache:/cache
    environment:
      - AWS_ACCESS_KEY_ID=your-aws-access-key
      - AWS_SECRET_ACCESS_KEY=your-aws-secret-key
      - S3_BUCKET=your-lfs-bucket
      - S3_REGION=us-east-1
      - CACHE_DIR=/cache
      - PORT=8080
      - LOG_LEVEL=info
    restart: unless-stopped

核心环境变量配置

配置Git客户端使用Rudolfs

1. 在Git仓库中配置LFS端点：

   bash
   git config lfs.url "[***]"
   

2. 若启用认证，配置凭据：

   bash
   git config lfs.credentials.username "your-username"
   git config lfs.credentials.password "your-password"
   

高级配置

缓存策略调整

通过CACHE_SIZE_LIMIT限制缓存总大小，超过时自动清理最久未使用的对象：

bash
-e CACHE_SIZE_LIMIT=50GB

S3兼容存储配置（如MinIO）

bash
-e S3_ENDPOINT="[***]" \
-e S3_FORCE_PATH_STYLE=true \  # 启用路径风格访问（非虚拟主机风格）

启用基本认证

bash
-e AUTH_HEADER="Authorization" \
-e AUTH_REALM="Rudolfs LFS Server" \
-e AUTH_USERS="user1:pass1,user2:pass2"  # 逗号分隔的用户名:密码对