Linux 下的分块并发下载工具，支持 SOCKS5 代理池和断点续传。
像 curl 一样直接用——编译成单个二进制文件，跟上参数即可下载。
- 分块并发下载 — 将文件按指定大小切分为多个块，通过 HTTP Range 头并发下载
- 固定线程池 — 指定并发工作线程数，每个线程从共享队列中取块下载，避免资源耗尽
- SOCKS5h 代理池 — 支持单个代理或从 TOML 配置文件加载代理池，自动轮换分配
- 故障自动转移 — 代理失败自动标记，租用新代理重试；连续失败超过阈值自动跳过并重置
- 完整性校验 — 强制验证 HTTP 206 状态码与
Content-Range头，块下载完后校验实际字节数，合并时再次校验每块与总大小；任何环节不符都会删除该块数据并重试，杜绝静默产出损坏文件 - 块级失败隔离 — 单块反复失败累计 5 次后自动跳过，worker 不退出继续下载其他块；最终若有不可恢复的块则整体报错并列出失败块编号，已下载的字节全部保留供下次续传
- 断点续传 — 下载中断后重新运行，自动跳过已完成的块，未完成的块从断点续传；已存在且大小严格相符的块直接跳过，大小不符的会自动清理重下
- 速度估算修正 — 重跑预载入已完成字节后自动重置 ETA 估算，避免显示"先大后小"的速度抖动
- 实时进度条 — 显示总进度、各工作线程进度、下载速度和预计剩余时间
- 零外部依赖 — 使用 rustls 而非 OpenSSL，编译产物无需安装系统级 SSL 库
需要 Rust 1.70+ 和 Cargo。
git clone https://github.com/bevin1984/dchunked.git
cd dchunked
cargo build --release编译产物位于 target/release/dchunked，拷贝到 /usr/local/bin/ 即可全局使用：
sudo cp target/release/dchunked /usr/local/bin/RPM (CentOS/RHEL)：
cargo install cargo-generate-rpm
cargo build --release
strip target/release/dchunked
cargo generate-rpm
# 产物在 target/generate-rpm/*.rpm
sudo rpm -i target/generate-rpm/*.rpmDEB (Ubuntu/Debian)：
cargo install cargo-deb
cargo deb
# 产物在 target/debian/*.deb
sudo dpkg -i target/debian/*.deb从 Releases 页面下载对应包后安装：
RPM (CentOS/RHEL)：
sudo rpm -i dchunked-*.x86_64.rpmDEB (Ubuntu/Debian)：
sudo dpkg -i dchunked_*_amd64.deb安装完成后即可全局使用 dchunked 命令。卸载方式：
# RPM
sudo rpm -e dchunked
# DEB
sudo dpkg -r dchunked# 最简用法，10MB 一块，8 个工作线程
dchunked https://example.com/bigfile.zip
# 指定输出文件名、块大小和并发线程数
dchunked https://example.com/bigfile.zip -o movie.mp4 -b 5M -c 16文件按 -b 指定的块大小切分为多个块。-c 指定并发工作线程数，每个线程从共享队列中取一个块下载，完成后自动取下一个未下载的块，直到所有块下载完毕。
例如，下载一个 1GB 的文件，-b 10M -c 4：
- 文件被切分为约 100 个 10MB 的块
- 同时只有 4 个线程在下载，每个线程下载完一个块后继续取下一个
- 不会出现 100 个线程同时运行的情况
下载过程中断（Ctrl+C 或网络故障），重新运行相同的命令即可续传：
# 首次下载（中断）
dchunked https://example.com/bigfile.zip -o movie.mp4
# 重新运行相同命令，自动续传
dchunked https://example.com/bigfile.zip -o movie.mp4续传时的处理逻辑：
- 文件大小严格等于块预期大小的，标记为已完成并跳过
- 文件大小大于预期大小的（通常是上次下载响应异常导致），删除文件从头重下
- 文件大小小于预期大小的（上次中断时只写了一部分），通过 Range 头从断点续传
- 速度估算会自动重置，避免预载入已完成字节时显示"先大后小"的虚假速度
下载状态保存在输出文件同目录下的隐藏目录 .filename/ 中，下载完成后自动清理。
# 通过单个 SOCKS5 代理下载（DNS 在代理端解析）
dchunked https://example.com/bigfile.zip -x socks5h://127.0.0.1:1080
# 带认证的代理
dchunked https://example.com/bigfile.zip -x socks5h://user:pass@proxy-host:1080socks5h:// 表示 DNS 解析在代理端完成（保护本地 DNS 隐私）。如果使用 socks5://，DNS 会在本地解析。
创建代理池配置文件 proxies.toml：
[[proxies]]
addr = "socks5h://user:pass@host1:1080"
[[proxies]]
addr = "socks5h://host2:1080"
[[proxies]]
addr = "socks5h://user:pass@host3:7890"下载时指定配置文件：
dchunked https://example.com/bigfile.zip -p proxies.toml -c 12代理池以 round-robin 方式将代理分配给各工作线程，失败自动切换。
Usage: dchunked [OPTIONS] <URL>
Arguments:
<URL> 下载地址
Options:
-o, --output <OUTPUT> 输出文件路径（默认从 URL 提取文件名）
-c, --chunks <CHUNKS> 并发工作线程数 [default: 8]
-b, --block-size <BLOCK_SIZE> 块大小（支持 K/M/G 后缀，如 10M、1G）[default: 10M]
-x, --proxy <PROXY> 单个 SOCKS5 代理地址
-p, --proxy-file <PROXY_FILE> 代理池配置文件路径 (TOML)
--retry <RETRY> 每个块最大重试次数 [default: 3]
--timeout <TIMEOUT> 连接超时时间（秒） [default: 30]
-h, --help 显示帮助
-V, --version 显示版本
DChunked/
├── Cargo.toml # 项目配置和依赖
├── config.example.toml # 代理池配置示例
└── src/
├── main.rs # 入口，编排下载流程
├── cli.rs # 命令行参数定义 (clap)
├── config.rs # TOML 配置文件加载
├── block.rs # 块规划、调度器、清单文件、断点续传
├── worker.rs # 块下载核心逻辑（重试 + 代理故障转移）
├── proxy.rs # 代理池管理（轮换、故障追踪、自动恢复）
├── merger.rs # 块文件合并
├── progress.rs # 进度条显示 (indicatif)
└── error.rs # 统一错误类型定义
1. 解析 CLI 参数和配置文件
2. HEAD 请求获取文件大小，检测 Range 支持
3. 按块大小计算所有块的字节范围 (bytes=start-end)
4. 检查隐藏目录，扫描已完成的块（断点续传）
└── 仅接受文件大小严格等于 expected_size 的块为已完成
5. 创建调度器，启动 N 个工作线程
├── 从调度器获取一个未占用的块（无锁 CAS 抢占）
├── 租用代理（或直连）
├── GET 请求 + Range 头
├── 校验响应：必须 206（或服务器不支持 Range 时 200）
├── 校验 Content-Range 头中的 start 与请求的 range_start 一致
├── 流式写入隐藏目录中的块文件
├── 写完后校验实际大小 == expected_size，不符则删除文件并重试
├── 失败时记录块级失败计数、标记代理，租用新代理重试
├── 单块失败累计达 5 次，调度器永久跳过该块，worker 继续取下一个
└── 完成后标记块已完成，更新清单，继续取下一个块
6. 所有可重试块完成后，检查是否有超阈值失败块或 worker panic，有则报错退出
7. 按顺序合并块文件，逐块校验读取字节数，并最终校验合并总大小 == total_size
8. 清理隐藏目录，输出完成信息
下载过程中，输出文件同目录下会创建隐藏目录存放块数据：
./bigfile.zip ← 最终输出文件
./.bigfile.zip/ ← 隐藏目录（下载完成后自动清理）
manifest.toml ← 下载状态清单
0.block ← 块数据文件
1.block
2.block
...
| 依赖 | 用途 |
|---|---|
| tokio | 异步运行时，并发下载 |
| reqwest | HTTP 客户端，socks feature 提供 SOCKS5 支持 |
| clap | CLI 参数解析 |
| indicatif | 终端进度条 |
| serde + toml | 代理池配置和下载清单解析 |
| thiserror / anyhow | 错误处理 |
# 开发编译
cargo build
# 运行
cargo run -- <URL> [OPTIONS]
# 编译 release
cargo build --release