cover

ComfyUI 模型下载太慢？三种"加速"方法一次说透（含魔搭极速法）

用 ComfyUI 最崩溃的时刻之一：去 Civitai 或 HuggingFace 下模型，几个 GB 的 .safetensors 文件，进度条半天不动，中途断了还要重来。

这篇把模型下载的加速方法一次性讲清楚：网上常见的镜像站法、专用下载工具法，再加一个国内极速的魔搭（ModelScope）平台下载法——最后一个才是真正能跑满你带宽的。

方法一：国内镜像站（最常见）

HuggingFace 镜像：把下载地址里的 huggingface.co 换成 hf-mirror.com，配合 git-lfs 或下载工具即可。

# 设置环境变量后，HF 系列工具自动走镜像
export HF_ENDPOINT=https://hf-mirror.com

国内模型站：哩布哩布（liblib.art）、整个 AI 模型聚合站等，很多模型都有国内备份，网页直接下载，速度比境外源快得多。

优点：免费、简单。缺点：站点模型不全，热门新模型可能滞后；单个大文件仍可能断流。

方法二：下载工具 + 多线程（通用）

不管从哪个源下载，用支持多线程 + 断点续传的工具都能显著提速：

aria2（命令行，多线程神器）：
```
aria2c -x 16 -s 16 -k 1M "https://模型下载URL" -o model.safetensors
```
-x 16 开 16 个连接分段下载，单个文件速度能拉满。
IDM / 迅雷（图形界面）：右键复制直链，用这类工具下载，自带断点续传。

适用所有来源，但治标不治本——源头服务器慢，多线程也白搭。境外源用这个提升有限。

方法三：魔搭（ModelScope）平台下载（国内极速，重点）

魔搭（modelscope.cn）是阿里达摩院开源的 AI 模型社区，服务器在国内，下载速度极快，而且 SDXL、FLUX、SD1.5 这些主流作图模型基本都有，还支持断点续传。重点推荐这条路。

① 先注册（推荐用这个入口）

🎯 注册入口：https://modelscope.cn/register?inviteCode=caiaiacai&invitorName=caiaiacai

注册登录后，在魔搭搜索框搜「SDXL」「FLUX」「SD1.5」等关键词，进模型页复制仓库 ID（形如 AI-ModelScope/FLUX.1-dev）。

② 三种下载姿势（任选）

姿势 A：命令行工具（最推荐）

# 安装
pip install modelscope

# 下载整个模型到指定目录
modelscope download --model 'AI-ModelScope/FLUX.1-dev' --local_dir './models/checkpoints'

# 只下载大模型文件（过滤，省流量）
modelscope download --model 'AI-ModelScope/FLUX.1-dev' --include '*.safetensors' --local_dir './models/checkpoints'

常用参数：

参数	作用
`--model`	模型仓库 ID（必填）
`--local_dir`	下载到指定目录（直接指到 ComfyUI 的 models 目录最省事）
`--include` / `--exclude`	只下/跳过某些文件（`*.safetensors` 等）
`--max-workers`	并发线程数（下载慢可调大）
`--revision`	指定版本/分支

姿势 B：Python SDK

from modelscope.hub.snapshot_download import snapshot_download
model_dir = snapshot_download(
    'AI-ModelScope/FLUX.1-dev',
    allow_patterns='*.safetensors',   # 只要大模型文件
    local_dir='./models/checkpoints'
)

姿势 C：Git LFS 克隆

git lfs install
git clone https://www.modelscope.cn/AI-ModelScope/FLUX.1-dev.git

CLI 和 SDK 默认下到 ~/.cache/modelscope/hub，想改目录就设环境变量或直接用 --local_dir。

下载后怎么放？

下完把文件按类型放进 ComfyUI 对应目录即可：

模型类型	ComfyUI 目录
大模型 checkpoint	`models/checkpoints/`
LoRA	`models/loras/`
VAE	`models/vae/`
ControlNet	`models/controlnet/`

三种方法怎么选？

方法	速度	适合
镜像站	中等	想简单、模型在镜像上有
多线程工具	看源	任何来源的通用加速
魔搭平台	最快	国内下载、模型全、能断点续传，首选

总结

模型下载慢的根因是服务器在境外。治本的办法就是让数据走国内通道——魔搭平台就是最优解：下载快、模型全、支持断点续传，还能用 --include '*.safetensors' 精准只下大文件省流量。

一句话实操：注册魔搭 → 搜模型复制 ID → modelscope download --model 'xxx' --local_dir './models/checkpoints' → 放进 ComfyUI → 开跑。

注册入口（收藏备用）：https://modelscope.cn/register?inviteCode=caiaiacai&invitorName=caiaiacai