差分包技术 - 技术栈

差分包技术的工作原理

差异计算：electron-updater会计算当前版本与新版本之间的差异
范围请求：只下载差异部分，而不是整个安装包
本地合成：在本地将差异部分与当前版本合成，生成完整的新版本

预期效果

更新包大小：通常可以减少70-90%的下载大小
下载速度：显著提高，尤其是在网络条件较差的环境下
用户体验：更新过程更快，更流畅

服务器要求

服务器需要支持HTTP范围请求（Range Requests）
服务器需要正确配置CORS（跨域资源共享），允许electron-updater发送请求

现在，当用户更新软件应用时，系统会自动使用差分包技术，只下载必要的差异部分，大大减小更新包的大小。

要让服务器支持范围请求（Range Requests），需要确保服务器正确配置了相关的HTTP头和响应机制。范围请求是差分包技术的核心，它允许客户端只下载文件的特定部分，而不是整个文件。

什么是范围请求？

范围请求是HTTP/1.1的一个特性，客户端通过在请求头中添加 Range 字段来指定需要下载的文件范围，服务器返回 206 Partial Content 响应，并只发送请求的部分内容。

不同服务器的配置方法

Nginx

Nginx默认支持范围请求，不需要额外配置。如果遇到问题，可以检查以下配置：

复制代码

location / {
    # 确保静态文件服务启用
    root /path/to/your/files;
    # 确保没有禁用范围请求
    # add_header Accept-Ranges none;  # 这会禁用范围请求，不要使用
}

Apache

Apache默认也支持范围请求，确保以下模块已启用：

复制代码

# 启用必要的模块
a2enmod headers
a2enmod expires

在虚拟主机配置中添加：

复制代码

<Directory /path/to/your/files>
    # 确保启用范围请求
    Header set Accept-Ranges bytes
    # 确保没有禁用范围请求
    # Header set Accept-Ranges none  # 这会禁用范围请求，不要使用
</Directory>

IIS (Internet Information Services)

在IIS管理器中：

选择你的网站
打开"HTTP响应头"功能
确保没有添加 Accept-Ranges: none 头
如果需要，可以添加 Accept-Ranges: bytes 头 4. 云存储服务

AWS S3 : 默认支持范围请求
阿里云OSS : 默认支持范围请求
腾讯云COS : 默认支持范围请求
百度云BOS : 默认支持范围请求

验证服务器是否支持范围请求

可以使用curl命令验证：

复制代码

curl -I -H "Range: bytes=0-1023" http://your-server.com/openclaw/latest.yml

如果服务器支持范围请求，会返回 206 Partial Content 状态码和 Content-Range 头。

常见问题及解决方案

服务器返回416 Range Not Satisfiable

原因：请求的范围超出了文件大小
解决：确保请求的范围在文件大小范围内

服务器返回200 OK而不是206 Partial Content

原因：服务器未启用范围请求
解决：检查服务器配置，确保启用了范围请求

差分包下载失败

原因：服务器不支持范围请求或CORS配置不正确
解决：确保服务器支持范围请求，并正确配置CORS

CORS配置

除了范围请求，还需要确保服务器正确配置了CORS，允许electron-updater发送请求：

复制代码

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, HEAD, OPTIONS
Access-Control-Allow-Headers: Range

这样，服务器就能够正确支持范围请求，electron-updater就可以使用差分包技术来减小更新包的大小。