Headscale 版本兼容10 个版本的滚动窗口与 capability version 排障【免费下载链接】headscaleAn open source, self-hosted implementation of the Tailscale control server项目地址: https://gitcode.com/GitHub_Trending/he/headscale把旧 Tailscale 客户端接到 Headscale 上握手阶段直接回 400unsupported client version本文按速查 → 自检 → 原理 → 排障四步帮你定位版本兼容问题并给出可执行的操作。版本兼容速查哪些客户端版本能连结论先行当前 HEADSCALE 支持最近 10 个 Tailscale 小版本窗口为v1.80~v1.98低于v1.80.0的客户端会被拒绝连接。Tailscale 客户端版本支持状态capability 值建议动作v1.80窗口下沿✅ 最低受支持版本113保持即可后续升级 Headscale 后会被挤出窗口v1.84~v1.92✅ 受支持116 ~ 131正常使用无需操作v1.98窗口上沿✅ 最新版138新功能尝鲜首选v1.78及以下❌ 不受支持—必须升级客户端到v1.80.0以上窗口内其余版本的完整对照见 hscontrol/capver/capver_generated.go各平台的支持范围说明见 docs/about/clients.md。如何确认客户端版本受支持在客户端机器上运行tailscale version记下版本号。对照速查表v1.80~v1.98之间即可连接低于v1.80直接升级。不确定时查 capability 值Tailscale 协议里用来协商客户端能力的数字对照服务端最低要求cv : capver.CapabilityVersion(v1.90.0) // 按你的版本填 ok : cv capver.MinSupportedCapabilityVersion // 当前为 113即 v1.80连接被拒时看 Headscale 服务端日志unsupported client connected行会同时打印minimum_version与client_version两行数字直接告诉你差多少。客户端在窗口内仍连不上检查服务端本身是否过旧——见下文排障。滚动版本窗口为什么这样设计服务端依据客户端在握手时上报的 capability version 判断行为差异这个映射表由go generate自动刷新随服务端版本滚动。窗口固定为最近 10 个版本是为了把兼容性测试矩阵控制在有限范围内并让旧客户端的兼容代码在窗口滑过时可以安全删除——所以下限随服务端升级而上移是刻意设计而不是 bug。窗口大小和最低值定义在 hscontrol/capver/capver_generated.go映射生成逻辑在 tools/capver/main.go。排障capability version 报错逐条处理现象连接直接失败服务端日志出现unsupported client version/ HTTP 400原因客户端 capability 值低于MinSupportedCapabilityVersion113对应v1.80。 动作升级该机器上的 Tailscale 客户端到v1.80.0以上iOS 走 App Store 更新macOS/Linux/Windows 用官方渠道升级后重新登录。现象升级 Headscale 后原来在线的客户端集体掉线原因服务端新版抬高了最低版本存量客户端被挤出窗口。 动作先升客户端、再升服务端Headscale 本身升级时按 docs/setup/upgrade.md 逐版本升级不跳版本。现象客户端已升级到窗口内仍报 unsupported原因客户端实际连的还是旧实例配置指向旧地址或旧代理。 动作核对客户端里的 HeadScale URL 与端口sudo systemctl restart tailscaled或重启客户端应用后执行tailscale status确认节点重新出现在服务端nodes列表中。Apple 设备改接 Headscale 的入口在 docs/usage/connect/apple.md其中自定义协调服务器的设置路径可直接照做。版本兼容的判定全部发生在服务端握手阶段客户端能升到窗口内、服务端保持更新问题基本不会再出现。遇到特殊报错先附上tailscale version输出与服务端日志再去社区提问相关常见问题可先查 docs/about/faq.md。【免费下载链接】headscaleAn open source, self-hosted implementation of the Tailscale control server项目地址: https://gitcode.com/GitHub_Trending/he/headscale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Headscale 版本兼容：10 个版本的滚动窗口与 capability version 排障
Headscale 版本兼容10 个版本的滚动窗口与 capability version 排障【免费下载链接】headscaleAn open source, self-hosted implementation of the Tailscale control server项目地址: https://gitcode.com/GitHub_Trending/he/headscale把旧 Tailscale 客户端接到 Headscale 上握手阶段直接回 400unsupported client version本文按速查 → 自检 → 原理 → 排障四步帮你定位版本兼容问题并给出可执行的操作。版本兼容速查哪些客户端版本能连结论先行当前 HEADSCALE 支持最近 10 个 Tailscale 小版本窗口为v1.80~v1.98低于v1.80.0的客户端会被拒绝连接。Tailscale 客户端版本支持状态capability 值建议动作v1.80窗口下沿✅ 最低受支持版本113保持即可后续升级 Headscale 后会被挤出窗口v1.84~v1.92✅ 受支持116 ~ 131正常使用无需操作v1.98窗口上沿✅ 最新版138新功能尝鲜首选v1.78及以下❌ 不受支持—必须升级客户端到v1.80.0以上窗口内其余版本的完整对照见 hscontrol/capver/capver_generated.go各平台的支持范围说明见 docs/about/clients.md。如何确认客户端版本受支持在客户端机器上运行tailscale version记下版本号。对照速查表v1.80~v1.98之间即可连接低于v1.80直接升级。不确定时查 capability 值Tailscale 协议里用来协商客户端能力的数字对照服务端最低要求cv : capver.CapabilityVersion(v1.90.0) // 按你的版本填 ok : cv capver.MinSupportedCapabilityVersion // 当前为 113即 v1.80连接被拒时看 Headscale 服务端日志unsupported client connected行会同时打印minimum_version与client_version两行数字直接告诉你差多少。客户端在窗口内仍连不上检查服务端本身是否过旧——见下文排障。滚动版本窗口为什么这样设计服务端依据客户端在握手时上报的 capability version 判断行为差异这个映射表由go generate自动刷新随服务端版本滚动。窗口固定为最近 10 个版本是为了把兼容性测试矩阵控制在有限范围内并让旧客户端的兼容代码在窗口滑过时可以安全删除——所以下限随服务端升级而上移是刻意设计而不是 bug。窗口大小和最低值定义在 hscontrol/capver/capver_generated.go映射生成逻辑在 tools/capver/main.go。排障capability version 报错逐条处理现象连接直接失败服务端日志出现unsupported client version/ HTTP 400原因客户端 capability 值低于MinSupportedCapabilityVersion113对应v1.80。 动作升级该机器上的 Tailscale 客户端到v1.80.0以上iOS 走 App Store 更新macOS/Linux/Windows 用官方渠道升级后重新登录。现象升级 Headscale 后原来在线的客户端集体掉线原因服务端新版抬高了最低版本存量客户端被挤出窗口。 动作先升客户端、再升服务端Headscale 本身升级时按 docs/setup/upgrade.md 逐版本升级不跳版本。现象客户端已升级到窗口内仍报 unsupported原因客户端实际连的还是旧实例配置指向旧地址或旧代理。 动作核对客户端里的 HeadScale URL 与端口sudo systemctl restart tailscaled或重启客户端应用后执行tailscale status确认节点重新出现在服务端nodes列表中。Apple 设备改接 Headscale 的入口在 docs/usage/connect/apple.md其中自定义协调服务器的设置路径可直接照做。版本兼容的判定全部发生在服务端握手阶段客户端能升到窗口内、服务端保持更新问题基本不会再出现。遇到特殊报错先附上tailscale version输出与服务端日志再去社区提问相关常见问题可先查 docs/about/faq.md。【免费下载链接】headscaleAn open source, self-hosted implementation of the Tailscale control server项目地址: https://gitcode.com/GitHub_Trending/he/headscale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考