一、问题背景

在使用DeepSeek部署本地大模型时，许多用户反馈LM Studio无法下载模型。本文通过深度排查，揭示问题根源并提供高效解决方案，助您快速恢复模型训练。

二、核心原因分析

关键原因：Hugging Face国际版访问受限
LM Studio默认从Hugging Face官网下载模型，但由于国内网络限制，直接访问易出现失败。需通过国内镜像站点绕过限制。

三、解决方案（附详细步骤）

方案一：替换Hugging Face镜像源

  1. 定位文件路径
    • 右键点击LM Studio图标 → 选择「打开文件所在位置」
    • 默认路径：C:\Program Files\LM Studio\resources\app.webpack\main
  1. 备份并修改配置文件
    • 复制 index.js 至安全目录（防止误操作）
    • 用文本编辑器打开文件，将所有 huggingface.co 替换为 hf-mirror.com
      示例替换：
javascript


// 原始链接
const modelUrl = 'https://huggingface.co/models/model-name';
// 修改后
const modelUrl = 'https://hf-mirror.com/models/model-name';
  1. 重启验证
    保存文件后重启LM Studio，尝试重新下载模型。

方案二：修改备用配置文件（备选方案）

若方案一未生效，需进一步修改渲染层文件：

  1. 定位文件
    进入     renderer 文件夹 → 备份并编辑 main_window.js
  2. 执行相同替换操作
    同样替换所有     huggingface.co 为镜像域名。
  3. 清除缓存并重试
    删除     %APPDATA%/LM Studio 目录下的缓存文件后重启。

四、优化技巧与注意事项

  1. 镜像站点推荐
    推荐使用官方认证镜像：    hf-mirror.com 或 modelscope.cn，确保模型完整性。
  2. 网络环境检查
    • 确保终端设备已配置科学上网工具（如Clash、V2Ray）
    • 关闭防火墙临时拦截（测试阶段）
  1. 自动化脚本辅助
    可编写批处理脚本自动完成文件替换：
@echo off
copy /y "index.js.bak" "index.js"
powershell -Command "(Get-Content index.js).replace('huggingface.co', 'hf-mirror.com') | Set-Content index.js"