差分包技术

### 差分包技术的工作原理1. 差异计算 electron-updater会计算当前版本与新版本之间的差异2. 范围请求 只下载差异部分而不是整个安装包3. 本地合成 在本地将差异部分与当前版本合成生成完整的新版本### 预期效果- 更新包大小 通常可以减少70-90%的下载大小- 下载速度 显著提高尤其是在网络条件较差的环境下- 用户体验 更新过程更快更流畅### 服务器要求- 服务器需要支持HTTP范围请求Range Requests- 服务器需要正确配置CORS跨域资源共享允许electron-updater发送请求现在当用户更新软件应用时系统会自动使用差分包技术只下载必要的差异部分大大减小更新包的大小。要让服务器支持范围请求Range Requests需要确保服务器正确配置了相关的HTTP头和响应机制。范围请求是差分包技术的核心它允许客户端只下载文件的特定部分而不是整个文件。### 什么是范围请求范围请求是HTTP/1.1的一个特性客户端通过在请求头中添加 Range 字段来指定需要下载的文件范围服务器返回 206 Partial Content 响应并只发送请求的部分内容。### 不同服务器的配置方法1. NginxNginx默认支持范围请求不需要额外配置。如果遇到问题可以检查以下配置location / { # 确保静态文件服务启用 root /path/to/your/files; # 确保没有禁用范围请求 # add_header Accept-Ranges none; # 这会禁用范围请求不要使用 }2. ApacheApache默认也支持范围请求确保以下模块已启用# 启用必要的模块 a2enmod headers a2enmod expires在虚拟主机配置中添加Directory /path/to/your/files # 确保启用范围请求 Header set Accept-Ranges bytes # 确保没有禁用范围请求 # Header set Accept-Ranges none # 这会禁用范围请求不要使用 /Directory3. IIS (Internet Information Services)在IIS管理器中1. 选择你的网站2. 打开HTTP响应头功能3. 确保没有添加 Accept-Ranges: none 头4. 如果需要可以添加 Accept-Ranges: bytes 头 4. 云存储服务- AWS S3 : 默认支持范围请求- 阿里云OSS : 默认支持范围请求- 腾讯云COS : 默认支持范围请求- 百度云BOS : 默认支持范围请求### 验证服务器是否支持范围请求可以使用curl命令验证curl -I -H Range: bytes0-1023 http://your-server.com/openclaw/latest.yml如果服务器支持范围请求会返回 206 Partial Content 状态码和 Content-Range 头。### 常见问题及解决方案1. 服务器返回416 Range Not Satisfiable- 原因 请求的范围超出了文件大小- 解决 确保请求的范围在文件大小范围内2. 服务器返回200 OK而不是206 Partial Content- 原因 服务器未启用范围请求- 解决 检查服务器配置确保启用了范围请求3. 差分包下载失败- 原因 服务器不支持范围请求或CORS配置不正确- 解决 确保服务器支持范围请求并正确配置CORS### CORS配置除了范围请求还需要确保服务器正确配置了CORS允许electron-updater发送请求Access-Control-Allow-Origin: * Access-Control-Allow-Methods: GET, HEAD, OPTIONS Access-Control-Allow-Headers: Range这样服务器就能够正确支持范围请求electron-updater就可以使用差分包技术来减小更新包的大小。