SSL on 豆子技术站

为豆子域名管家实现版本检测功能的技术实践

Tue, 17 Mar 2026 09:00:00 +0800

豆子域名管家是一款基于 Wails 3 开发的超轻量级单文件客户端。它不仅拥有 Naive UI 打造的精致界面，更集成了强大的域名监控能力：

全方位监测：主面板表格直观展示域名列表、SSL 证书剩余天数、Whois 到期时间。
智能告警：支持自定义告警阈值，状态（正常/警告/错误）一目了然。
多渠道通知：深度集成钉钉与企业微信，支持配置调度时间与通知频次，确保告警不漏报、不打扰。
静默守护：支持随系统自动启动，后台默默守护您的域名安全。

为什么需要版本提醒，为什么不是自动更新？

在开发豆子域名管家时，Wails 3 就提供了自动集成的更新方案，但经过深思熟虑，我选择了“版本提醒 + 手动覆盖”的策略：主要考虑到个人服务器的带宽限制，避免高并发下载造成服务器宕机。单文件二进制直接覆盖即可完成升级，无需复杂的安装程序。

在之前的版本中，我主要通过公众号发布新版本并提供下载链接进行手动升级。它的问题是用户需要关注公众号并手动前往蓝奏云下载。为了进一步优化体验，我决定在新版本中引入版本对比提醒：

红点微标提醒：客户端启动后会自动对比本地与云端版本号。若有新版，左下角版本号将出现灵动的红点徽标，提醒而不打扰。
交互式遮罩弹窗：点击徽标即可弹出基于 Naive UI 开发的漂亮窗口，清晰展示：
- 当前版本 vs 最新版本
- 详细的更新日志
- 保姆级使用方法说明
- 极简升级路径：点击“复制下载链接”，直接在浏览器中下载最新的二进制文件，覆盖旧文件即可完成升级。

版本检测核心实现思路

这不仅仅是一个简单的弹窗，背后凝聚了对安全和灵活性的思考。为了确保版本检测既高效又安全，我们采用了以下技术路径：

1，我没有在前端 JS 中硬编码版本号。使用了Go 后端驱动，客户端通过 Wails 3 的原生桥接功能，调用后端 Go 方法获取本地编译时的版本标识。

2，防爬虫机制：在向云端请求最新版本信息时，配置了特定的 Custom Header 校验，有效拦截恶意脚本和不必要的扫描，保护服务器资源。

3，设计了灵活的云端数据结构。我们的版本接口不只是返回一个数字，而是返回一个包含三个核心维度的 JSON 对象：

最新版本号：用于精准比对。
下载地址：支持动态变更下载镜像，防止因链接失效导致的无法更新。
更新日志：让用户第一时间了解修复了哪些 Bug 或新增了哪些功能。

4，极致的 UI 交互（基于 Naive UI）
当本地版本低于云端时，左下角会亮起精美的红点徽标。点击后的交互逻辑非常人性化：

信息全透明：对比当前版本与新版本，展示完整的更新列表和使用指南。
尊重用户选择：弹窗配备了清晰的“取消/稍后再说”按钮，绝不强制升级。
快捷操作：提供“复制下载链接”按钮，点击后自动写入剪切板。用户只需打开浏览器粘贴，即可从蓝奏云等高速渠道下载，覆盖即升级。免去了前期的复杂步骤。

界面功能效果预览

徽标提示
弹窗说明

工具如何开始使用？

无论您是拥有几十个域名的运维大拿，还是只有几个小站的个人玩家，豆子域名管家都是您的不二之选。