ducktors/turborepo-remote-cache

Turborepo Remote Cache (TRRC)

镜像概述

Turborepo Remote Cache (TRRC) 是Turborepo自定义远程缓存服务器的开源实现。当Vercel官方缓存服务器不可行时，本项目提供了自托管部署的替代方案，支持多种存储提供商和部署环境，并尽可能提供"一键部署"功能。

核心功能与特性

• 兼容性：完全兼容Turborepo远程缓存协议
• 多存储支持：适配多种存储提供商（详情参见https://ducktors.github.io/turborepo-remote-cache/supported-storage-providers%EF%BC%89
• 部署灵活性：支持多种部署环境，提供一键部署选项
• 开源可控：源代码完全开放，可根据需求自定义扩展

使用场景与适用范围

• 无法使用Vercel官方远程缓存服务的企业或团队
• 需要数据本地化存储的合规场景
• 希望降低第三方服务依赖的自托管基础设施
• 构建流程优化需求强烈的Turborepo monorepo项目

部署与配置指南

Docker快速启动

bash
docker run -d -p 3000:3000 \
  --name turborepo-remote-cache \
  -e PORT=3000 \
  -e STORAGE_PROVIDER=local \
  -e STORAGE_PATH=/data \
  -v ./cache-data:/data \
  docker.xuanyuan.run/ducktors/turborepo-remote-cache

Docker Compose配置

yaml
version: '3.8'
services:
  trrc:
    image: docker.xuanyuan.run/ducktors/turborepo-remote-cache
    container_name: trrc
    restart: always
    ports:
      - "3000:3000"
    environment:
      - PORT=3000
      - STORAGE_PROVIDER=s3
      - AWS_ACCESS_KEY_ID=your-aws-access-key
      - AWS_SECRET_ACCESS_KEY=your-aws-secret-key
      - AWS_REGION=us-east-1
      - AWS_BUCKET_NAME=your-turborepo-cache-bucket
    # 如需本地存储，替换为以下配置
    # environment:
    #   - STORAGE_PROVIDER=local
    #   - STORAGE_PATH=/data
    # volumes:
    #   - ./cache-data:/data

关键环境变量配置

完整环境变量列表参见https://ducktors.github.io/turborepo-remote-cache/environment-variables

Turborepo项目配置

在Turborepo项目中启用自定义远程缓存：

1. 在turbo.json中添加远程缓存配置：

   json
   {
     "remoteCache": {
       "url": "http://your-trrc-server:3000",
       "teamId": "your-team-id", // 自定义团队标识
       "token": "your-auth-token" // 如需认证，配置访问令牌
     }
   }
   

2. 验证配置：

   bash
   turbo run build --remote-cache=always
   

相关资源

• https://ducktors.github.io/turborepo-remote-cache/
• https://ducktors.github.io/turborepo-remote-cache/deployment-environments
• https://github.com/ducktors/turborepo-remote-cache