mirror of
https://github.com/kunkundi/crossdesk.git
synced 2026-10-16 17:10:20 +08:00
49 lines
2.5 KiB
Markdown
49 lines
2.5 KiB
Markdown
# 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 授权后配置。
|
||
|
||
检查实际分发文件的签名：
|
||
|
||
```powershell
|
||
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：
|
||
|
||
- [WinHttpOpen](https://learn.microsoft.com/windows/win32/api/winhttp/nf-winhttp-winhttpopen)
|
||
- [IAttachmentExecute::Save](https://learn.microsoft.com/windows/win32/api/shobjidl_core/nf-shobjidl_core-iattachmentexecute-save)
|
||
- [IAttachmentExecute::Execute](https://learn.microsoft.com/windows/win32/api/shobjidl_core/nf-shobjidl_core-iattachmentexecute-execute)
|