下载、版本与设备升级

获取当前版本

在下载中心选择“账户登录安装”和系统，公开下载已发布的统一客户端，无需先登录网站。页面显示版本、架构、文件大小、系统要求、更新说明和校验值；商店发行使用对应的官方商店链接。安装后在应用内登录，支持的平台可在设置中按需开启本机被控。

免账号 Agent 从用户后台按设备组获取，目标设备无需登录。不要用公开的账号客户端安装包替代设备组专属安装内容。暂无已发布版本或查询失败时，下载页会分别提示；你可以先使用浏览器访问已有设备。

应用提示需要升级

平台管理员可以设置最低支持版本。登录或刷新登录状态时，低于最低版本的应用会提示需要升级；已有会话的设备操作也会受到限制。

在当前服务器的下载中心安装可用版本，然后重新登录。不同服务器可以有不同的发行策略。此策略不会静默降低你已经安装的较新版本，也不会替你绕过操作系统的安装和授权提示。

管理员发布软件

具有平台设置写入权限的管理员可以打开软件版本与升级。工作区管理员身份本身不等于平台发行权限。

1. 点击“新增版本”，填写系统、架构、客户端类型、渠道和版本号。
2. 填写固定的 HTTPS 安装包地址或官方商店地址，以及更新说明。普通安装包需要文件大小和 SHA-256 校验值。
3. 完成对应平台的签名、公证或商店分发检查，以及安装测试，再勾选发行审核。内部未签名产物保留为草稿。
4. 发布后，使用“设为当前版本”启用下载页分发；按需要开启升级检查、设置最低支持版本。

账号客户端的发行记录沿用内部兼容类型：Linux、iOS 使用 controller，Windows、macOS、Android 使用 full，并选择 stable 渠道。公开页面按此映射展示一个账号产品，不再让用户选择 Controller/Full。只发布已完成统一客户端整合和发行审核的安装包；agent 与自动升级二进制不作为公开账号客户端下载。

已发布或已撤下的版本信息不能修改。安装文件变化时创建新版本。选择其他已发布版本可以切换下载入口；撤下版本会停止该版本的受管下载和升级推荐。暂停升级检查仍保留当前下载入口。

批量自动升级设备

批量功能用于 Windows、macOS、Linux 上以服务方式运行、带标准 Core 的官方 MeshAgent。它更新设备 Agent，不会批量静默安装控制端应用、Android APK 或 iOS 应用。

管理员先建立“MeshAgent 自动升级二进制”类型的版本，选择“设备端”，填写精确的处理器架构、MeshAgent 架构 ID、目标构建号及 SHA-384 校验值。运维人员需要提前在对应数据节点准备匹配的官方二进制；仅填写下载地址并不会自动把文件准备到节点上。

发布后点击“批量升级”，搜索并勾选目标设备，确认 Agent 重启可能中断远程会话，然后创建任务。每批最多 100 台设备，离线设备最多等待 24 小时。任务不会重启整台电脑，但当前的远程连接可能暂时断开。

查看进度与停止任务

“已下发”表示数据节点已接收升级，不代表安装成功。只有重新观察到设备运行目标构建号，才会显示“升级成功”。版本已经相同或更新的设备会显示“无需升级”。

可以打开任务明细查看每台设备的状态。架构不匹配、文件未预置、校验失败和等待超时会分别显示原因。下发结果不明时，系统会查询原节点，不会盲目重复安装。

“停止任务”会取消尚未下发的设备；已经交给 Agent 的安装可能继续完成。撤下对应版本、移除发起管理员权限或变更设备归属，也会阻止后续下发。出现失败时，先处理明细中的原因，再选择需要重试的设备创建新的任务。