PuppyIP 资源中心
网络与连接排错 5 分钟 发布于 2026-11-19

Tailscale Terraform v0.30.0 怎么迁移 route_selection 并保留原路由策略?

Tailscale Terraform Provider v0.30.0 支持用 route_selection 管理 tailnet 路由策略。若旧状态中的 regional_routing_on 为 false,先查询当前 routeSelection。三种模式都可能读成 false,而写入 false 会选择 active-passive-failover。

Tailscale Terraform route_selection regional_routing_on MagicRoute

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • v0.30.0 仍支持已弃用的 regional_routing_on。两个字段不能同时写在配置里。
  • 先用管理控制台或只读 API 查出实际模式,再用等价的 route_selection 替换旧字段。
  • 可选值有 active-passive-failover、regional-routing、regional-routing-failover 和 magicroute。
  • 先审阅计划,应用后再读回设置,并用已有客户端核对路径。

先确认线上 tailnet 的实际模式

Tailscale 11 月 13 日发布的 Terraform Provider v0.30.0 给 tailscale_tailnet_settings 增加了 route_selection。旧字段 regional_routing_on 是同一设置的布尔视图。API 中的 regionalRoutingOn 只有在 regional-routing 时返回 true,其他三种模式都返回 false。

计划迁移前,确认 Terraform 指向预期的 tailnet,再在管理控制台的 General 中核对 Route selection,或通过 tailnet settings API 读取 routeSelection。通过 API 检查时,可使用 feature_settings:read 的凭据。把读到的模式和目标 tailnet 写入变更记录。

按读回的模式替换旧字段

route_selection 允许四种值。active-passive-failover 是主备切换,regional-routing 是区域路由,regional-routing-failover 是区域内主备切换,magicroute 是 MagicRoute。应以从服务端读回的当前值作为迁移依据。

例如,团队此前在控制台选择了 MagicRoute,旧布尔状态会显示 false。要保留当前行为,应写 route_selection = "magicroute" 并从这个 Terraform 资源配置里移除 regional_routing_on。把 false 转成 active-passive-failover 会改变网络选择策略。

检查 Terraform 计划和其他写入者

在已有的受控 Terraform 流程里更新 provider 并查看 plan。v0.30.0 的资源校验会在两个字段都出现在配置里时报错。若状态文件里仍能看到两个值,源码会按同一服务端设置读取这两个视图。应查看源配置以及展开后的模块变量,确认只显式配置其中一个字段。

若计划会改变实际模式、替换资源或修改其他 tailnet 设置,先查清来源再决定是否执行。也要确认旧脚本或另一套 Terraform 是否仍写 regionalRoutingOn。即使新配置正确,其他写入者仍可用 false 把策略切回主备。

应用后读回设置,再从客户端核对

按现有流程执行已审核的迁移后,再读一次 routeSelection,核对与迁移前一致。使用获授权的客户端访问已有的目标网段或服务,并从相同测试点对照路径。选择策略作用于整个 tailnet,客户端能看到的候选连接器仍受访问规则和批准状态约束。

新设 MagicRoute 适用于符合条件的 Premium 或 Enterprise tailnet,并需满足 Beta 开通要求。区域内主备也有自身的支持启用条件。仅迁移配置字段时,以当前可用模式为准;切换策略是另一次需要验证的网络变更。

资料来源

常见问题

旧状态里有两个属性,需要手工删 state 吗?

v0.30.0 会读取两个属性,状态里同时出现是正常的。冲突发生在 Terraform 配置中同时显式设置。先检查资源和模块中实际传入的值。

能根据 regional_routing_on: false 直接选一个新值吗?

应先读回 routeSelection。false 可能表示主备切换、区域内主备或 MagicRoute。

删除 Terraform 资源会恢复旧路由策略吗?

v0.30.0 的删除实现只从 Terraform 状态移除资源,tailnet 设置仍保留。需要恢复时,按原流程设置、读回并验证此前记录的有效模式。