Hugging Face 文件下载加速:resolve 链接使用方法
用 Hugging Face resolve 文件直链下载模型配置和公开文件,区分模型网页、文件下载与客户端镜像端点。
HubProxy 站点维护者 · 更新于 2026-09-06
使用文件直链,不是模型介绍页
在模型仓库的文件列表中找到目标文件,复制下载链接。常见直链包含 /resolve/分支或提交/文件名;模型介绍页和 /blob/ 文件预览页不是同一种地址。
先用较小的 config.json 验证连接。能够下载配置文件,不代表所有权重文件或整套客户端协议都已兼容。
下载一个公开配置文件
把完整原始链接放到本站域名后,或交给首页生成。下面的命令使用 -f 检查 HTTP 错误,避免把错误页误当作模型文件保存。
curl -fL "https://hubproxy.luohang.net.cn/https://huggingface.co/gpt2/resolve/main/config.json" -o config.json怎样确认拿到的是目标文件
在 Files and versions 中选定文件和版本,再复制下载地址。保留完整文件路径及查询参数;文件预览页能打开,不代表复制到的就是下载直链。示例中的 main 是分支名,需要可复现版本时应按仓库提供的提交标识选择文件。
2026-09-06 从本站服务器下载上述 config.json,返回 HTTP 200、665 字节。配置文件成功只证明这一条公开文件链路可用;模型权重、分片索引、分词器文件仍需分别核对。
大文件与断点续传
公开模型权重可能经由额外的存储或 CDN 地址提供,受上游连接、文件大小限制与本站带宽影响。分片模型通常还需要索引和多个分片,单独下载一个文件未必足够运行。
需要续传时,必须确认目标地址支持 Range 且远端文件没有变化。固定提交版本比持续变化的分支更适合复现下载。
这不是完整的 Hugging Face 镜像端点
不要直接将本站域名当作 HF_ENDPOINT;huggingface_hub、Transformers 或 Xet 的整套请求流程未在本站完成兼容验证。
私有或受限模型需要遵守原平台的授权流程和模型许可。不要将 Hugging Face Token 放进本站链接、留言或截图。需要官方客户端时请参考原平台文档。
遇到登录要求或缺少文件时
若原平台要求登录、同意模型协议或申请访问权限,应先按原平台流程处理,加速地址不会绕过这些限制。不要把登录页面保存成权重文件。
模型无法加载但下载没有报错时,检查模型文档要求的文件是否齐全、版本是否一致,以及本地磁盘是否有足够空间。不要仅根据一个 config.json 或单个权重分片判断模型已经下载完整。
参考:原平台官方文档
相关指南
cc-connect 下载教程:搜索仓库、选择版本与校验文件