返回变更日志
October 23, 2026

使用 Terraform 管理你的链接

RedirHub × Terraform: a redirects.tf file with a redirect and a QR code link, and terraform apply creating both

The RedirHub Terraform provider

RedirHub 现已推出官方 Terraform 提供程序。将您的重定向、网站迁移、短链接、二维码和域名都纳入 Git 管理,在拉取请求中将每次变更作为计划进行审查,并从 CI 中应用它。

hclresource "redirhub_link" "old_domain" {
  handler       = "redirect"
  url           = "old-site.com"
  destinations  = ["https://new-site.com"]
  type          = "301"
  forward_path  = true
  forward_query = true
}

您可以管理的内容#

  • 所有类型的链接,一个资源: redirhub_link 覆盖域名重定向、网站迁移映射、品牌短链接和二维码,并且字段与 API 保持一致。可使用 for_each 从仓库中的 CSV 加载迁移配置。
  • 域名及其 DNS: redirhub_domain 连接一个域名,并返回它所需的 DNS 记录,可直接用于您的 DNS 提供商的 Terraform 资源。redirhub_domain_verification 会一直等待直到域名指向 RedirHub,因此新的链接会在一个已能响应的域名上上线。
  • 您已经拥有的链接: 按 id 导入任意链接,按主机名导入任意域名。redirhub_links 数据源可按域名、类型或标签列出 id。
  • 在仪表板中所做的更改会显示出来: 下一次计划会列出它们,因此不会与您的文件内容产生偏差。

可安全重复运行#

一个超时后再次运行的 CI 作业不会重复创建任何内容。每次创建都会携带一个 Idempotency-Key,API 现在会在每个 POST 中遵循它:24 小时内使用相同的键会返回第一次响应,而不是第二个链接。您自己的脚本也可以发送该请求头。

开始使用#

在“设置 → API 令牌”下创建一个 API 令牌,并按照 使用 Terraform 和 CI 将重定向作为代码进行管理 操作,其中包括一个在每个拉取请求上发布计划的 GitHub Actions 工作流。该提供程序在 GitHub 上是开源的。它适用于 Core、Pro 和 Enterprise。