如何在GitHub Actions自托管运行器间共享Docker缓存以规避拉取限制？

一、跨自托管运行器共享Docker镜像缓存（AWS EC2场景） #

因为你使用terraform-aws-github-runner创建EC2自托管运行器，最直接的缓存共享方案是借助AWS EFS：

• 用Terraform为EC2集群创建并挂载EFS卷，将Docker默认镜像存储目录/var/lib/docker挂载到EFS上。所有运行器会共用同一个镜像缓存池，拉取一次后无需重复请求。
• 配置注意事项：
  • 选择EFS的General Purpose模式（兼顾性能与成本），高频率场景可切换为Max I/O模式。
  • 确保EC2安全组允许访问EFS的NFS端口（2049）。
  • 在Terraform的EC2用户数据中添加挂载命令，保证实例启动时自动挂载EFS到/var/lib/docker。

二、优化作业结构减少不必要的镜像拉取 #

1. 设置镜像拉取策略为if-not-present #

在GitHub Actions作业的services配置中，给每个镜像添加拉取策略，避免已有镜像时重复拉取：

services:
  postgres:
    image: postgres:12.8
    pull_policy: if-not-present
    ...
  mysql:
    image: mysql:5.7
    pull_policy: if-not-present
    ...
  redis:
    image: redis:5.0
    pull_policy: if-not-present
    ...

2. 复用预热镜像 #

• 新增预热作业：在矩阵作业执行前，提前拉取所有需要的服务镜像；如果是按需创建的EC2运行器，可在Terraform用户数据中添加镜像拉取命令，让实例启动时自动完成预热。
• 迁移镜像到AWS ECR：将postgres/mysql/redis镜像同步到你的AWS ECR仓库，作业中改用ECR镜像地址。EC2拉取ECR镜像不受Docker Hub限制，速度更快，配合EFS缓存可进一步减少拉取次数。

3. 复用工作流逻辑 #

如果多个作业使用相同的服务配置，可将服务定义抽成可复用工作流，通过uses关键字引用，避免重复定义导致的冗余拉取。

三、规避Docker Hub拉取限制的补充配置 #

配置Docker Hub认证，提升拉取配额：在GitHub Secrets中存储Docker Hub账号密码，作业执行前添加登录步骤（匿名用户配额100次/6小时，认证用户提升至200次/6小时，付费账号配额更高）：

steps:
  - name: Login to Docker Hub
    uses: docker/login-action@v3
    with:
      username: ${{ secrets.DOCKER_USERNAME }}
      password: ${{ secrets.DOCKER_PASSWORD }}

内容的提问来源于stack exchange，提问作者TedOC