Files
crossdesk/docs/windows-updates.md
T

2.5 KiB
Raw Blame History

Windows 更新与安全软件兼容性

Windows 的更新按钮在后台下载发布信息中指定版本的安装包,完成校验及 Windows 附件安全检查后打开安装向导。客户端使用 WinHTTP,保留系统的 HTTPS 证书检查和代理配置,并用 CrossDesk/<version> WindowsUpdater 标识请求。

安装包保存在 %LOCALAPPDATA%\CrossDesk\Updates 下的独立目录中。 下载过程写入 .part 文件;HTTP 响应、文件长度、Windows 可执行文件头 均通过检查后才生成最终安装包。

客户端通过 Windows Attachment Services 的 Save 记录下载来源并请求 系统安全检查,再通过 Execute 打开安装包。这些 API 会按 Windows 策略 调用扫描、信任检查和必要的提示。安装程序由自身的管理员权限清单请求 UAC 授权。安全检查失败时停止流程,不回退到直接启动,也不删除来源标记。

发行版签名

应使用受信任的正式代码签名证书签署发布的主程序、服务、辅助程序、DLL 和最终安装包。只签安装包不能建立已安装主程序的发布者身份。 SignPath 的 test-signing 用于测试,不能代替公开发行所需的受信任签名。 当前流水线中的测试签名配置仍保持为可选项;正式策略需在取得证书及 SignPath 授权后配置。

检查实际分发文件的签名:

Get-AuthenticodeSignature .\crossdesk.exe
Get-AuthenticodeSignature .\crossdesk-win-x64-<version>.exe

网络防护告警的处理

2026-09-09 的天擎日志记录了在域名解析阶段对 downloads.crossdesk.cn 和 101.132.143.203 的阻断。 该记录不能单独证明 HTTP 库、提权方式或文件内容是命中原因。 切换到标准 Windows API 也不能保证域名/IP 信誉告警消失。

出现同类告警时,保留告警时间、策略名称、域名/IP、程序版本及签名状态, 由安全管理员向厂商核查命中原因,同时检查服务器是否存在异常活动。 确认误报后按厂商流程纠正信誉或企业策略。应在策略允许的测试环境中 验证下载、取消、不完整文件、安全检查失败及安装向导启动流程。

相关 API: