服务对象与地域限制
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 设置仍保留。需要恢复时,按原流程设置、读回并验证此前记录的有效模式。