9.5 模型下载失败

Whisper 模型下载失败是国内用户常见问题。

症状

• 下载进度卡住
• 下载到一半中断
• 报网络错误
• 模型文件损坏

原因

主要原因

1. 国际网络访问受限: Hugging Face 等国内访问慢
2. 网络不稳定: 大文件容易中断
3. 存储空间不足: 模型文件几个 GB
4. 下载源问题: 镜像服务器问题

解决方案

方案 1: 使用代理

最简单的解决方法。

Buzz / MacWhisper

直接配置系统代理,软件会自动走代理。

命令行下载

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

方案 2: 使用 Hugging Face 镜像

国内镜像加速:

官方: https://huggingface.co/
镜像: https://hf-mirror.com/

配置 hf-mirror

# Linux/Mac
export HF_ENDPOINT=https://hf-mirror.com

# Windows PowerShell
$env:HF_ENDPOINT = "https://hf-mirror.com"

方案 3: 手动下载模型

步骤 1: 下载模型文件

从 Hugging Face 镜像下载:

步骤 2: 放到正确位置

MacWhisper

~/Library/Application Support/MacWhisper/models/

Buzz

Windows:

C:\Users\<你>\AppData\Local\Buzz\models\

Linux/Mac:

~/.cache/whisper/

步骤 3: 重启软件

软件会自动识别已下载的模型。

方案 4: 网盘分流

我整理了常用模型的网盘资源(联系作者获取):

• 百度网盘
• 阿里云盘
• 蓝奏云

私信作者 微信: 15600871059 获取分流链接。

方案 5: 切换网络

• Wi-Fi → 有线
• 切换到 5G 热点
• 换运营商网络

方案 6: 分段下载

如果支持断点续传:

• 用 IDM(Internet Download Manager)
• aria2c
• 浏览器扩展

Buzz 模型下载

默认位置

Buzz 把模型存在:

Windows

%LOCALAPPDATA%\Buzz\models\

通常是: C:\Users\<你>\AppData\Local\Buzz\models\

macOS

~/Library/Application Support/Buzz/models/

Linux

~/.cache/Buzz/models/

手动安装步骤

1. 从镜像下载 .bin 文件
2. 放到上面的目录
3. 启动 Buzz
4. 设置中选择该模型

MacWhisper 模型下载

默认位置

~/Library/Application Support/MacWhisper/models/

手动安装

1. 在 Finder 中打开上面的目录

   • Cmd + Shift + G,粘贴路径

2. 把下载的模型文件拖入

3. 启动 MacWhisper

4. 模型选择中应该能看到

Whisper.cpp 模型

下载脚本

cd whisper.cpp/models
bash ./download-ggml-model.sh large-v3

手动下载

下载 ggml 格式的模型:

https://huggingface.co/ggerganov/whisper.cpp/tree/main

文件命名: ggml-large-v3.bin

常见错误信息

"Connection timeout"

原因: 网络超时

解决:

• 用代理
• 换镜像
• 重试

"Model file corrupted"

原因: 下载不完整

解决:

• 删除残缺文件
• 重新下载
• 校验文件 MD5

"Insufficient disk space"

原因: 磁盘空间不够

解决:

• 清理磁盘
• 换更小模型
• 移动到大盘

"Permission denied"

原因: 没有写入权限

解决:

• 检查目录权限
• 以管理员运行(Win)
• 修复权限(Mac)

模型文件大小参考

下载前预留好磁盘空间。

下载速度优化

使用 IDM (Windows)

1. 安装 IDM
2. 浏览器添加 IDM 插件
3. 复制下载链接到 IDM
4. 多线程下载,断点续传

使用 aria2c (跨平台)

aria2c -x 16 -s 16 https://hf-mirror.com/openai/whisper-large-v3/resolve/main/pytorch_model.bin

参数:

• -x 16: 16 个连接
• -s 16: 16 个分段

验证模型完整性

下载完成后验证:

检查文件大小

# Linux/Mac
ls -lh model.bin

# Windows
dir model.bin

应该和官方公布的大小一致。

检查 MD5(如果官方提供)

# Linux/Mac
md5 model.bin

# Windows
certutil -hashfile model.bin MD5

备份模型

下载好的模型建议备份:

• 复制到外置硬盘
• 上传到自己的网盘
• 多电脑共享

下次换电脑就不用重新下载。

本节小结

• ✅ 国内用户优先用 hf-mirror 镜像
• ✅ 大文件用 IDM/aria2c 多线程下载
• ✅ 手动放到对应模型目录
• ✅ 备份好下载的模型
• ⚠️ 关注磁盘空间

下一步

9.6 登录与网络问题

💬 模型分流: 加微信 15600871059(【专业译员工具社群】) 获取常用模型的网盘分流链接。