DChunked

Linux 下的分片并发下载工具，支持 SOCKS5 代理池。

像 curl 一样直接用——编译成单个二进制文件，跟上参数即可下载。

功能特性

• 分片并发下载 — 将文件分成多个分片，通过 HTTP Range 头并发下载，充分利用带宽
• SOCKS5h 代理池 — 支持单个代理或从 TOML 配置文件加载代理池，自动轮换分配给各分片
• 故障自动转移 — 代理失败自动标记，租用新代理重试；连续失败超过阈值自动跳过并重置
• 实时进度条 — 显示总进度、各分片进度、下载速度和预计剩余时间
• 零外部依赖 — 使用 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/deb

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/*.rpm

DEB (Ubuntu/Debian)：

cargo install cargo-deb
cargo deb
# 产物在 target/debian/*.deb
sudo dpkg -i target/debian/*.deb

从 rpm/deb 包安装

从 Releases 页面下载对应包后安装：

RPM (CentOS/RHEL)：

sudo rpm -i dchunked-*.x86_64.rpm

DEB (Ubuntu/Debian)：

sudo dpkg -i dchunked_*_amd64.deb

安装完成后即可全局使用 dchunked 命令。卸载方式：

# RPM
sudo rpm -e dchunked

# DEB
sudo dpkg -r dchunked

使用说明

基本用法

# 最简用法，自动 8 分片下载
dchunked https://example.com/bigfile.zip

# 指定输出文件名和分片数
dchunked https://example.com/bigfile.zip -o movie.mp4 -c 16

使用代理

# 通过单个 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:1080

socks5h:// 表示 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]
  -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 配置文件加载
    ├── error.rs            # 统一错误类型定义
    ├── planner.rs          # HEAD 请求获取文件信息，计算分片范围
    ├── worker.rs           # 分片下载核心逻辑（重试 + 代理故障转移）
    ├── proxy.rs            # 代理池管理（轮换、故障追踪、自动恢复）
    ├── merger.rs           # 临时分片文件合并
    └── progress.rs         # 进度条显示 (indicatif)

下载流程

1. 解析 CLI 参数和配置文件
2. HEAD 请求获取文件大小，检测 Range 支持
3. 计算各分片的字节范围 (bytes=start-end)
4. 为每个分片启动一个 tokio 异步任务
   ├── 从代理池租用代理（或直连）
   ├── GET 请求 + Range 头
   ├── 流式写入临时文件 /tmp/dchunked_<uuid>_<index>.part
   └── 失败时标记代理，租用新代理重试
5. 所有分片完成后，按顺序合并到最终文件
6. 清理临时文件，输出完成信息

关键依赖

依赖	用途
tokio	异步运行时，并发下载
reqwest	HTTP 客户端，socks feature 提供 SOCKS5 支持
clap	CLI 参数解析
indicatif	终端进度条
serde + toml	代理池配置解析
thiserror / anyhow	错误处理

开发

# 开发编译
cargo build

# 运行
cargo run -- <URL> [OPTIONS]

# 编译 release
cargo build --release