FetchLinux断点续传实现指南
一、名称澄清与总体思路
- 若你指的是 Linux 下的命令行下载工具 wget，其断点续传通过 -c 参数实现；若你指的是 libcurl（许多下载器如 Fetch、aria2 的底层库），则通过设置 CURLOPT_RESUME_FROM_LARGE 让服务器从已下载的字节偏移继续传输。两者本质都依赖 HTTP 的 Range 机制：客户端发送 Range: bytes=已下载字节-，服务器返回 206 Partial Content 并从该偏移继续发送数据。
二、使用 wget 实现断点续传
- 基本用法：在已有部分文件的情况下，使用 -c 继续下载，避免重头开始。
- 示例：wget -c “https://example.com/large.iso”
- 网络不稳时建议配合重试与超时参数：
- 示例：wget -c -t 0 -T 120 “https://example.com/large.iso”
- 说明：-t 0 表示无限重试，-T 120 表示连接超时 120 秒。
- 含查询串的 URL 需加引号，并用 -O 指定保存文件名：
- 示例：wget -c -O file.zip “https://example.com/download?file=1&token=abc”。
三、使用 libcurl 实现断点续传（C/C++）
- 思路：获取本地已存在文件大小作为偏移，打开文件为追加模式，设置 CURLOPT_RESUME_FROM_LARGE 为该偏移，执行请求即可从断点继续。
- 关键步骤与示例：
- 获取本地文件大小：stat 获取 st_size；若为 0 或不存则从头开始。
- 打开文件：fopen(localpath, “ab+”)，便于追加写入。
- 设置 libcurl 选项：
- CURLOPT_URL：目标 URL
- CURLOPT_RESUME_FROM_LARGE：偏移（本地已下载大小）
- CURLOPT_WRITEFUNCTION / CURLOPT_WRITEDATA：写入回调与文件句柄
- 可选：CURLOPT_HEADERFUNCTION 读取 Content-Length，CURLOPT_CONNECTTIMEOUT 设置超时
- 执行：curl_easy_perform；失败可依据返回值与重试策略再次调用（偏移不变）。
四、使用 rsync 实现断点续传（SSH/SFTP 场景）
- rsync 通过 -P（等价于 –partial --progress）支持“部分文件保留 + 续传”，适合大文件与目录同步。
- 示例：
- 断点下载：rsync -P --rsh=ssh user@host:/remote/large.tar.gz /local/large.tar.gz
- 断点上传：rsync -P --rsh=ssh /local/large.tar.gz user@host:/remote/large.tar.gz
- 目录同步：rsync -P -r --rsh=ssh user@host:/remote/dir/ /local/dir/
- 说明：-P 会在中断后保留已传输的部分，下次执行自动续传未完成的字节范围。
五、实践注意事项
- 服务器必须支持 Range（响应头包含 Accept-Ranges: bytes），并在续传时返回 206；否则客户端无法从断点继续。
- 本地文件务必保留已下载部分，避免被覆盖；使用追加模式写入更安全。
- 对于不稳定网络，建议开启工具的重试与超时（如 wget -t 0 -T 120），减少频繁全量重传。
- 多线程下载器（如 axel、aria2）通常也支持断点续传：中断后重复相同命令即可自动续传未完成的字节范围。