资料修改2026-09尚无逐条事实核验记录；修改日期不代表已验证
本文仍包含未全面复核的历史资料；安装、许可、费用与当前权限请回到官方确认。查看已核信息范围
模型下载加速与断点续传
模型权重动辄几 GB，国内直连 Hugging Face 慢且容易中断。这篇把"怎么快、断了怎么办"讲清楚；镜像原理与账号配置见 HF 与国内镜像。
三条通道，按场景选
| 场景 | 推荐通道 | 速度感受 |
|---|---|---|
| 日常下载单个模型 | hf-mirror 镜像（HF_ENDPOINT，见下） | 快且稳，社区实测 8–12 MB/s |
| 国产模型 | 魔搭 ModelScope（modelscope.cn） | 国内最快，官方仓库直连 |
| 超大文件/网络不稳 | 多线程下载器（aria2 类） | 可断点续传，适合几十 GB |
日常下载单个模型：hf-mirror 镜像（HF_ENDPOINT，见下）·快且稳，社区实测 8–12 MB/s
国产模型：魔搭 ModelScope（modelscope.cn）·国内最快，官方仓库直连
超大文件/网络不稳：多线程下载器（aria2 类）·可断点续传，适合几十 GB
一条命令改镜像（huggingface-cli）
# Windows PowerShell（永久生效）
setx HF_ENDPOINT https://hf-mirror.com
# Linux / macOS（写入 shell 配置即可永久生效）
export HF_ENDPOINT=https://hf-mirror.com
改完后常规下载命令自动走镜像：
pip install -U huggingface_hub
huggingface-cli download 模型名 --local-dir ./模型目录
⚠️ 避坑：下载中断不要删掉重来——huggingface-cli 会复用已下载的分片，重跑同一条命令即可续传。删了重来反而要重新拉全部。
加速全家桶：hf_transfer
Hugging Face 官方的多线程传输库，在镜像基础上再加一层并发（对 huggingface-cli download 生效）：
pip install hf_transfer
# Windows 上再设一个环境变量启用
setx HF_HUB_ENABLE_HF_TRANSFER 1
⚠️ 避坑：hf_transfer 在小文件多的仓库上收益有限，在大文件少（单文件几 GB）的场景收益最明显；它偶尔会与某些代理环境冲突，出错时先关掉它再试。
超大文件的下载器方案
网络不稳、单个文件几十 GB 时，用支持多线程与断点续传的下载器拿直链下（镜像站同样给直链）：
- aria2（命令行）：
aria2c -x 8 -s 8 <直链>——-x单服务器连接数、-s分片数，8 是常用平衡值； - IDM / Motrix（图形界面）：粘贴直链自动多线程，断点续传稳定。
⚠️ 避坑：多线程不是越高越好——连接数开太大反而会被限速或触发风控（429）。8–16 之间足够。
下载后必做：校验完整性
大文件最容易"下载完成但损坏"，跑之前先校验：
# Windows：比对官网给出的 SHA256（PowerShell 自带）
Get-FileHash .\模型文件 -Algorithm SHA256
# Linux / macOS
sha256sum 模型文件
模型页一般会给 SHA256 或校验值文件（*.sha256/checksums.json），对不上就重新下载——不然会在加载时报各种莫名其妙的解析错误，白白排查半天。
相关
- 镜像原理与 HF_ENDPOINT 详解：HF 与国内镜像
- 国产模型去哪下：模型权重直达
- 下完怎么跑、要多少显存：GGUF 量化与显存