# 国内下载 HuggingFace 模型太慢这个工具让 1000Mbps 带宽跑满 500Mbps CDN 波动时普通工具降速干等它能自动新建连接把速度拉满。## 问题为什么你的模型下载总是慢如果你在国内下载过 HuggingFace 上的 AI 模型一定经历过这些Downloading: 3% | 0.2G/7G [05:302:15:00, 8.5MB/s]1000Mbps 的带宽实际只跑了 10Mbps。不是带宽不够而是单连接下载根本吃不满带宽再加上 CDN 波动速度更是雪上加霜。更难受的是CDN 一波动速度就掉下去普通工具就干等着等网络恢复了也不会主动恢复速度。你只能手动重启下载或者干脆挂代理慢慢等。## 解决方案Mirror Downloader[Mirror Downloader](https://github.com/mirrordownload/mirrordownload) 是一个专为国内用户打造的 AI 模型下载工具核心解决两个问题1. **多源并发**内置 HuggingFace Mirror、ModelScope 等国内镜像源不用折腾环境变量2. **动态连接管理**CDN 波动时自动新建连接把速度拉满### 安装bashnpm install -g mirror-downloader### 基本用法bash# 下载模型自动选择最快源mirrordl pull meta-llama/Llama-2-7b# 使用 HF Mirror 下载国内推荐mirrordl pull Qwen/Qwen2.5-7B-Instruct --source hf-mirror# 下载到指定目录mirrordl pull meta-llama/Llama-2-7b --output ./models## 核心功能动态连接管理这是 Mirror Downloader 最重要的功能。普通下载工具开固定数量的连接通常是 1~4 条CDN 一波动速度就掉下去恢复全凭运气。Mirror Downloader 内置自适应并发引擎工作方式完全不同普通工具 1条连接 → 波动 → 降速 → 干等 → 不知道什么时候恢复Mirror DL8条连接 → 波动 → 自动加到16条 → 再加到32条 → 速度拉满具体策略| 场景 | 引擎行为 ||------|----------|| 某条连接变慢 / CDN 波动 | 吞吐量爬山算法实时监测发现加连接能提升 ≥5% 速度自动新建连接一路加到 64 条上限 || 连接错误率升高30% | 立即收缩连接数不在坏连接上浪费时间稍后自动恢复 || 连接稳定、速度已达上限 | 维持当前连接数不浪费资源 || 网络恢复 / 换源 | 每 3 秒评估一次持续寻找当前最快的连接数 |**一句话总结CDN 有多快就跑到多快波动来了自动加连接补回来。**### 实测数据1000Mbps 带宽实测| 指标 | 优化前 | 优化后 ||------|--------|--------|| 下载速度 | ~10 Mbps | **500 Mbps** || 并发连接数 | 单连接 | 8~64 动态调节 || 多文件并行 | 无 | 5 个文件同时下载 |Peak speed: 78.27 MB/s (656 Mbps)Average speed: 51.76 MB/s (434 Mbps) 用户实测反馈用这个工具之前只有 10Mbps 左右的下载速度用了以后到了 500Mbps。CDN 有多快就能下载多快。## 其他实用功能### ComfyUI 深度优化ComfyUI 的模型目录结构复杂25 种子目录手动分类费时费力。Mirror Downloader 支持一键下载并自动分类bash# 下载并自动分类到 ComfyUI 目录mirrordl pull black-forest-labs/FLUX.1-dev --comfyui D:\ComfyUI# 下载时按量化类型筛选mirrordl pull lmstudio-community/Llama-3-8B-GGUF --comfyui D:\ComfyUI --quant q4_k_m### LM Studio 适配bash# 下载到 LM Studio 默认目录mirrordl pull lmstudio-community/DeepSeek-V4-Flash-0731-GGUF --lmstudio# 下载特定量化版本mirrordl pull lmstudio-community/Llama-3-8B-GGUF --lmstudio --quant q4_k_m### MCP Server 集成内置 MCP Server可以让 Claude Desktop 等 AI 助手直接帮你下载模型json{mcpServers: {mirror-downloader: {command: npx,args: [mirror-downloader, mcp]}}}配置好后直接对 Claude 说「帮我下载 Qwen2.5-7B」它就会调用 Mirror Downloader 执行下载。### 断点续传下载到一半断了重新运行命令即可从字节级断点继续不浪费已下载的进度。### 多源切换bash# 自动探测各源延迟选最快的mirrordl probe# 手动指定源mirrordl pull Qwen/Qwen2.5-7B-Instruct --source modelscope## 和 huggingface-cli 的区别| 功能 | huggingface-cli | Mirror Downloader ||------|-----------------|-------------------|| 国内镜像源 | 需要设置环境变量部分功能不生效 | 内置适配器直接用 || 下载速度 | 单连接~10 Mbps | 8~64 动态连接500 Mbps || 多文件并行 | 无 | 5 个文件同时下载 || 断点续传 | 支持 | 支持 || ComfyUI 分类 | 不支持 | 25 种模型自动分类 || LM Studio | 不支持 | 一键适配 || MCP 集成 | 不支持 | 内置 MCP Server |## 总结Mirror Downloader 解决了国内用户下载 AI 模型的两个核心痛点镜像源访问和下载速度。动态连接管理引擎让它在 CDN 波动时也能保持高速下载实测 1000Mbps 带宽跑满 500 Mbps。如果你经常需要从 HuggingFace 下载模型值得一试。**GitHub** https://github.com/mirrordownload/mirrordownload**安装** npm install -g mirror-downloader**联系方式** mirrordownload163.com 国内下载 HuggingFace 模型太慢？自适应并发 + 动态连接管理，让 1000Mbps 带宽跑满 500Mbps
# 国内下载 HuggingFace 模型太慢这个工具让 1000Mbps 带宽跑满 500Mbps CDN 波动时普通工具降速干等它能自动新建连接把速度拉满。## 问题为什么你的模型下载总是慢如果你在国内下载过 HuggingFace 上的 AI 模型一定经历过这些Downloading: 3% | 0.2G/7G [05:302:15:00, 8.5MB/s]1000Mbps 的带宽实际只跑了 10Mbps。不是带宽不够而是单连接下载根本吃不满带宽再加上 CDN 波动速度更是雪上加霜。更难受的是CDN 一波动速度就掉下去普通工具就干等着等网络恢复了也不会主动恢复速度。你只能手动重启下载或者干脆挂代理慢慢等。## 解决方案Mirror Downloader[Mirror Downloader](https://github.com/mirrordownload/mirrordownload) 是一个专为国内用户打造的 AI 模型下载工具核心解决两个问题1. **多源并发**内置 HuggingFace Mirror、ModelScope 等国内镜像源不用折腾环境变量2. **动态连接管理**CDN 波动时自动新建连接把速度拉满### 安装bashnpm install -g mirror-downloader### 基本用法bash# 下载模型自动选择最快源mirrordl pull meta-llama/Llama-2-7b# 使用 HF Mirror 下载国内推荐mirrordl pull Qwen/Qwen2.5-7B-Instruct --source hf-mirror# 下载到指定目录mirrordl pull meta-llama/Llama-2-7b --output ./models## 核心功能动态连接管理这是 Mirror Downloader 最重要的功能。普通下载工具开固定数量的连接通常是 1~4 条CDN 一波动速度就掉下去恢复全凭运气。Mirror Downloader 内置自适应并发引擎工作方式完全不同普通工具 1条连接 → 波动 → 降速 → 干等 → 不知道什么时候恢复Mirror DL8条连接 → 波动 → 自动加到16条 → 再加到32条 → 速度拉满具体策略| 场景 | 引擎行为 ||------|----------|| 某条连接变慢 / CDN 波动 | 吞吐量爬山算法实时监测发现加连接能提升 ≥5% 速度自动新建连接一路加到 64 条上限 || 连接错误率升高30% | 立即收缩连接数不在坏连接上浪费时间稍后自动恢复 || 连接稳定、速度已达上限 | 维持当前连接数不浪费资源 || 网络恢复 / 换源 | 每 3 秒评估一次持续寻找当前最快的连接数 |**一句话总结CDN 有多快就跑到多快波动来了自动加连接补回来。**### 实测数据1000Mbps 带宽实测| 指标 | 优化前 | 优化后 ||------|--------|--------|| 下载速度 | ~10 Mbps | **500 Mbps** || 并发连接数 | 单连接 | 8~64 动态调节 || 多文件并行 | 无 | 5 个文件同时下载 |Peak speed: 78.27 MB/s (656 Mbps)Average speed: 51.76 MB/s (434 Mbps) 用户实测反馈用这个工具之前只有 10Mbps 左右的下载速度用了以后到了 500Mbps。CDN 有多快就能下载多快。## 其他实用功能### ComfyUI 深度优化ComfyUI 的模型目录结构复杂25 种子目录手动分类费时费力。Mirror Downloader 支持一键下载并自动分类bash# 下载并自动分类到 ComfyUI 目录mirrordl pull black-forest-labs/FLUX.1-dev --comfyui D:\ComfyUI# 下载时按量化类型筛选mirrordl pull lmstudio-community/Llama-3-8B-GGUF --comfyui D:\ComfyUI --quant q4_k_m### LM Studio 适配bash# 下载到 LM Studio 默认目录mirrordl pull lmstudio-community/DeepSeek-V4-Flash-0731-GGUF --lmstudio# 下载特定量化版本mirrordl pull lmstudio-community/Llama-3-8B-GGUF --lmstudio --quant q4_k_m### MCP Server 集成内置 MCP Server可以让 Claude Desktop 等 AI 助手直接帮你下载模型json{mcpServers: {mirror-downloader: {command: npx,args: [mirror-downloader, mcp]}}}配置好后直接对 Claude 说「帮我下载 Qwen2.5-7B」它就会调用 Mirror Downloader 执行下载。### 断点续传下载到一半断了重新运行命令即可从字节级断点继续不浪费已下载的进度。### 多源切换bash# 自动探测各源延迟选最快的mirrordl probe# 手动指定源mirrordl pull Qwen/Qwen2.5-7B-Instruct --source modelscope## 和 huggingface-cli 的区别| 功能 | huggingface-cli | Mirror Downloader ||------|-----------------|-------------------|| 国内镜像源 | 需要设置环境变量部分功能不生效 | 内置适配器直接用 || 下载速度 | 单连接~10 Mbps | 8~64 动态连接500 Mbps || 多文件并行 | 无 | 5 个文件同时下载 || 断点续传 | 支持 | 支持 || ComfyUI 分类 | 不支持 | 25 种模型自动分类 || LM Studio | 不支持 | 一键适配 || MCP 集成 | 不支持 | 内置 MCP Server |## 总结Mirror Downloader 解决了国内用户下载 AI 模型的两个核心痛点镜像源访问和下载速度。动态连接管理引擎让它在 CDN 波动时也能保持高速下载实测 1000Mbps 带宽跑满 500 Mbps。如果你经常需要从 HuggingFace 下载模型值得一试。**GitHub** https://github.com/mirrordownload/mirrordownload**安装** npm install -g mirror-downloader**联系方式** mirrordownload163.com