如何让Terraform Init从本地缓存复制模块而非远程源下载？

当然可以，以下是几种实用的实现方式：

1. 利用Terraform内置全局缓存 #

Terraform 0.13及以上版本默认提供全局模块缓存，下载过的模块会存在本地目录：

• Linux/macOS: ~/.terraform.d/modules
• Windows: %APPDATA%\terraform.d\modules

只要不同栈引用的模块源地址、版本完全一致（比如相同Git源的固定tag/commit，或Registry模块的指定版本），terraform init会自动复用缓存，无需重复下载。

注意：如果引用的是Git分支而非固定版本，Terraform会每次检查分支更新，可能触发重新下载，建议改用固定tag或commit哈希。

2. 直接引用本地模块路径 #

如果这些模块是项目内部共享的，直接改用本地相对/绝对路径引用，彻底跳过远程下载步骤：

将原来的远程引用：

module "network" {
  source = "git::https://example.com/infra-modules/network.git?ref=v2.1.0"
}

替换为本地路径：

module "network" {
  source = "../../shared-modules/network"
}

这种方式直接读取本地文件系统的模块，速度最快，还能实时同步模块的本地修改。

3. 搭建本地模块代理（进阶方案） #

如果需要保留远程源的引用模式（比如统一版本管理），可以搭建本地模块代理：

• 用私有Terraform Registry或简单HTTP服务器托管模块包
• 将模块源地址指向本地代理，terraform init会从本地拉取模块，避免重复下载远程资源

额外提示 #

• Terraform 1.3+支持terraform cache clean命令，可手动清理全局缓存中的过期模块
• 本地路径引用要注意相对路径的正确性，建议在项目根目录统一存放共享模块，用一致的相对路径引用

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