HuggingFace 镜像站下载模型

一、官方 CLI 工具（推荐）

1.1 安装 CLI

# Mac/Linux 一键安装
curl -LsSf https://hf.co/cli/install.sh | bash
 
# 验证安装
hf --help

1.2 配置镜像站

# 设置镜像地址
export HF_ENDPOINT=https://hf-mirror.com
 
# 下载模型
hf download Qwen/Qwen2.5-1.5B --local-dir ./Qwen2.5-1.5B

---

二、单文件下载

适合 ComfyUI 等场景，直接下载单个模型文件：

# 使用 wget 下载
wget https://hf-mirror.com/Qwen/Qwen2.5-1.5B/resolve/main/xxx.safetensors
 
# 添加认证头（私有模型）
wget --header "Authorization: Bearer YOUR_TOKEN" 拷贝的地址

---

三、分片模型下载

当模型较大时，会被分成多个文件：

model-00001-of-00003.safetensors
model-00002-of-00003.safetensors
model-00003-of-00003.safetensors

下载整个模型仓库：

export HF_ENDPOINT=https://hf-mirror.com
hf download FabioSarracino/VibeVoice-Large-Q8 --local-dir ./VibeVoice-Large-Q8

---

四、常见问题

4.1 下载速度慢

• 使用镜像站：https://hf-mirror.com
• 检查网络连接
• 使用下载工具

4.2 认证问题

# 获取 Token
# https://huggingface.co/settings/tokens
 
# 使用 Token
export HF_TOKEN=your_token

---

相关链接

• ComfyUI 功能笔记 - ComfyUI 使用指南
• HuggingFace 官网
• HuggingFace 镜像站