如何提升Windows ClickOnce安装器下载速度及启用断点续传

Azure APIM 端限速配置检查 #

你的ClickOnce包通过APIM分发，首先排查APIM侧的带宽/速率限制：

• 产品级/API级限速：登录Azure门户，进入目标APIM实例，依次选择「API管理」→「API」或「产品」→ 进入对应API/产品的「策略」编辑器，查找是否存在 <bandwidth-limit>（带宽限制）或 <rate-limit-by-key>（请求速率限制）节点。这类策略会直接限制单客户端的下载带宽，若存在可根据业务需求调整带宽阈值（比如将带宽从2.7Mbps调高到实际可用上限）。
• 全局策略限制：检查APIM的「全局策略」是否配置了统一的带宽管控规则，避免遗漏全局层面的限制。

ClickOnce 客户端解除限速 #

ClickOnce的下载器dfsvc.exe默认可能存在并发连接数限制，导致无法充分利用带宽，可通过注册表调整：

1. 打开注册表编辑器（regedit.exe），定位到路径：
   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319\System.Deployment

   注意：若使用64位系统，需同时检查HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319\System.Deployment路径

2. 添加或修改以下DWORD值：
   • MaxConnectionsPerServer：设置为十进制10或更高（默认可能为2-4），提升单服务器并发连接数
   • MaxConnectionsPer1_0Server：同上，兼容旧版HTTP协议的连接限制
3. 重启dfsvc.exe进程（任务管理器中找到并结束进程，下次启动ClickOnce时会自动重启）

dfsvc.exe 启用暂停/续传功能 #

ClickOnce下载器默认未完全启用暂停续传，可通过注册表开启：

1. 在上述相同的System.Deployment注册表路径下，添加DWORD值：
   EnableResume，设置为十进制1
2. 确保部署清单（.application文件）中包含正确的文件哈希和版本信息，dfsvc.exe会基于这些信息识别已下载的片段，实现断点续传。
3. 若下载中断，重新启动ClickOnce安装程序会自动从断点处继续下载，无需重新开始。

额外优化建议 #

• 拆分大安装包：将1.25GB的MSI等大文件拆分为ClickOnce支持的独立组件，利用增量部署特性，减少单次下载量。
• APIM 启用CDN缓存：在APIM中配置CDN集成，将ClickOnce安装包缓存到边缘节点，缩短用户与资源的物理距离，提升下载速度。
• 区域就近部署：确保APIM实例与目标用户群体在同一或邻近Azure区域，降低网络延迟对下载速度的影响。

内容的提问来源于stack exchange，提问作者Mcore8x