无法下载模型等资源是因境外服务受网络影响；可通过切换国内镜像源、配置HTTP代理、离线预加载或修改hosts强制解析四种方式解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder时无法下载模型、插件或远程资源，则很可能是由于境外托管服务（如Hugging Face、GitHub Releases、OSS桶）受网络链路质量影响，导致连接超时、DNS解析失败或TLS握手中断。以下是解决此问题的步骤：
一、切换国内镜像源地址
通过将原始资源URL替换为经实测稳定的国内镜像地址，可绕过境外节点直连限制，显著降低DNS解析延迟与TCP建连失败率，适用于模型权重、插件包及依赖文件的拉取。
1、打开Qoder设置面板，进入“Advanced → Resource Mirror”配置页。
2、将默认镜像地址 https://huggingface.co/Qwen/Qwen3-VL-2B-Instruct/resolve/main 替换为以下任一可用镜像：
3、https://hf-mirror.com/Qwen/Qwen3-VL-2B-Instruct/resolve/main
4、https://mirror.ghproxy.com/https://huggingface.co/Qwen/Qwen3-VL-2B-Instruct/resolve/main
5、https://download.qoder.cn/mirror/hf/Qwen/Qwen3-VL-2B-Instruct/
6、点击“Save & Reload Resources”触发资源重载。
二、配置本地HTTP代理中转
当企业防火墙严格限制出向HTTPS请求或存在SNI阻断时，启用Qoder内置代理通道可将所有模型与资源请求转发至已白名单化的内部代理服务，实现协议级穿透。
1、确认公司IT部门已开通HTTP代理服务，并提供有效地址（例如：http://proxy.internal:8080）。
2、在Qoder设置页中定位“Network → Proxy Settings”。
3、勾选“Enable HTTP Proxy for Model & Plugin Resources”。
4、在Proxy URL字段填入上述代理地址；若需认证，格式为http://user:pass@proxy.internal:8080。
5、点击“Test Connection”，验证返回状态码为200后保存配置。
三、离线预加载模型与资源包
针对完全隔离网络环境（如金融、政务、军工内网），可在联网中转机上完整下载模型权重、插件ZIP包及依赖清单，再整体导入目标设备，彻底规避在线拉取环节。
1、访问Qoder官方发布页：https://qoder.com/download 或 Hugging Face镜像站：https://hf-mirror.com/Qwen。
2、下载最新版模型权重（如Qwen3-VL-2B-Instruct完整目录）、插件包（qoderwake-plugin-bundle-v*.zip）及依赖清单（requirements-offline.txt）。
3、将全部文件压缩为单一归档（如qoder-offline-resources-202605.zip），通过U盘或内网摆渡系统导入目标机器。
4、解压至标准路径：%APPDATA%\JetBrains\IntelliJIdea*\plugins\qoder-offline\（Windows）或~/.qoder/offline/（macOS/Linux）。
5、在Qoder设置中启用“Offline Resource Mode”，并指定上述路径为本地资源根目录。
四、修改系统级hosts强制解析镜像域名
针对DNS污染导致的域名解析失败，可通过手动绑定镜像服务IP地址，跳过公共DNS查询过程，确保域名始终解析至可用CDN节点或反向代理入口。
1、获取镜像服务当前可用IP：执行命令 nslookup hf-mirror.com 223.5.5.5 或访问 https://api.ipify.org 验证出口IP是否匹配镜像站白名单。
2、编辑系统hosts文件：C:\Windows\System32\drivers\etc\hosts（Windows）或 /etc/hosts（macOS/Linux）。
3、在文件末尾新增一行：114.114.114.114 hf-mirror.com（IP应替换为实际可用镜像节点IP）。
4、保存文件后，在管理员权限下执行：ipconfig /flushdns（Windows）或 sudo dscacheutil -flushcache（macOS）。
5、重启Qoder客户端，验证资源加载日志中域名解析结果是否已指向指定IP。
