Hugging Face 镜像加速站
为国内 AI 开发者、科研团队与高校师生提供高效稳定的大模型权重与数据集下载通道。 网页端只反代并加速底层文件下载接口，保护用户隐私与 Token 零留存。
检测到模型网页端浏览请求
您当前访问的路径为 Hugging Face 仓库网页。为保障您的 Hugging Face 账号密码及认证 Token 安全，本加速节点严格遵循安全隔离策略，不代理网页端渲染与登录交互，只反向代理并加速文件数据下载接口。
为什么选择 HF-Mirror 镜像源？
专为海量参数 AI 权重与高并发数据分发打造的工程化解决方案
全球边缘 Anycast 加速
依托高冗余全球 CDN 边缘节点，将不稳定的跨洋公网路由转化为低延迟边缘专线连接，极大降低 TCP 握手握流丢包率。
无损断点续传机制
原生支持 HTTP Range 分块透传。拉取 50GB+ 巨型模型文件遇到偶发性网络抖动时，客户端可直接续拉，杜绝重新下载。
Gated Repo 官方 Token 直通
对 LLaMA-3、Gemma 等受限模型，直接透传官方 HF_TOKEN 至上游校验。本站零数据库落地，绝不收集用户密钥。
生态工具零修改直连
只需注入一行 HF_ENDPOINT 环境变量，完美原生兼容 huggingface-cli、Transformers、vLLM、Ollama 与 Docker。
🚀 快速上手与配置生成器
选择您的开发环境与使用场景，点击一键复制对应加速命令：
设置 HF_ENDPOINT 环境变量后，直接使用官方命令行工具即可享受高速断点续传与多线程拉取。
🔒 Gated Repo (受限模型) 官方授权指南
- 受限模型（如 LLaMA-3.3、Gemma-2 等）需先在 Hugging Face 官网 注册登录并签署使用协议。
- 官网申请通过后，前往 Access Tokens 管理页 创建一个 Read 只读权限 Token。
-
在本地命令行运行
huggingface-cli login粘贴该 Token，或直接在下载命令中传入--token hf_***即可通过本站高速拉取。
热门开源模型一键加速拉取
精选近期热门大语言模型与图像生成模型，点击即可复制加速下载指令
DeepSeek-R1-Distill-Qwen-7B
基于 Qwen-7B 蒸馏的高性能推理模型，数学推理、算法竞赛与代码生成表现优异，单张消费级显卡即可轻松部署。
Qwen2.5-7B-Instruct
通义千问最新一代主力基座模型，在代码、多语言、长文本（128k 上下文）理解及指令遵循上达到开源顶尖水准。
Llama-3.3-70B-Instruct
Meta 官方最新 70B 旗舰级大模型，能力媲美早期 405B，适合复杂 Agent 构建、企业级知识问答与深度分析。
FLUX.1-schnell
120 亿参数级前沿文本到图像生成模型，具备惊艳的照片级细节质感与卓越的复杂文字渲染能力，仅需 4 步即可出图。
bge-m3 多语言向量嵌入
支持稠密检索、稀疏检索与多向量重排混合的多语言 Embedding 标杆模型，RAG 知识库检索增强生成的必备利器。
whisper-large-v3-turbo
在海量多语种音频上微调的高精度语音转文本模型，turbo 精简版在保证识别率的同时显著降低推理时延。
HF-Mirror 加速原理与数据流转拓扑
传统跨国直接拉取大文件时，因国际骨干网高丢包率，极易导致 TCP 拥塞窗口收缩甚至连接重置。HF-Mirror 采用分层智能分发链路：
开发者机器设置 HF_ENDPOINT="https://hf-mirror.net"。无论是 CLI 还是 Python 代码，所有向 huggingface.co 发起的 REST API 和文件下载请求均重定向到本站。
请求被就近接入 Cloudflare 全球边缘数据中心。边缘网络通过高质量国际 BGP 骨干链路与上游源站建立持久化长连接池（HTTP/2 Keep-Alive），免去单文件反复握手。
大文件通过 HTTP Chunked 与 Byte-Range 流式透传，边接收边下发至客户端。文件指纹哈希（SHA256）100% 保持官方原版一致，确保模型安全性与完整性。
hf-mirror.net 与社区其他源 (如 hf-mirror.com) 的本质区别
许多开发者常困惑：同样配置了国内镜像，为什么有时下载大模型依然会断流报错？根据社区实测走查文献，核心差异在于底层大文件分发机制与是否发生境外 302 重定向。
元数据快速代理，但权重易回源国外
- 分发逻辑：解析仓库元数据与小文件很稳定，但在请求
resolve/main/下的大型权重（.safetensors / .bin）时，常返回 HTTP 302 Found 重定向回境外云存储节点。 - 实际体验：名义上走了国内镜像域名，但底层真实传输仍然在跨洋海外链路上，无代理或网络受限环境下极易遭遇
Connection reset by peer或长时间卡死在 0%。 - 断点分片限制：被 302 重定向后，部分多线程分片工具处理 Cookie/鉴权跳转时容易抛出异常。
边缘节点全链路流式传输，绝不回甩海外
- 分发逻辑：全球 Anycast 边缘 PoP 节点全程代理数据流，HEAD 探测直接返回 HTTP 200 OK，数据传输返回 206 Partial Content，不发生境外 302 甩锅。
- 实际体验：数据流经由高质量边缘专线到达用户，彻底阻断因国际光缆抖动带来的频繁断流，普通公网环境下亦能保持高吞吐。
- 完美支持 HTTP Range 多线程：原生兼容多线程 Range 分片拉取。实测表明配合 8 线程并发，1.09GB 编码器权重峰值可冲至 157 MB/s，约 3 分钟跑完。
常见疑问快速排查
涵盖模型下载中最常见的环境配置与权限授权疑问
Q: 为什么执行下载时提示 ConnectionReset 或 Download Timeout？ ▼
1. 请检查终端是否已经成功执行 export HF_ENDPOINT="https://hf-mirror.net"。可运行 echo $HF_ENDPOINT 验证输出是否为本镜像站域名。
2. 如果下载单文件体积超过 10GB，请务必使用官方推荐的 huggingface-cli download --resume-download 命令，开启断点续传功能。
Q: 下载 Gated Repo（受限模型）报 401 Unauthorized 怎么办？ ▼
受限模型需要先在 Hugging Face 官网签署 License 协议（例如 Llama-3.3 协议）。签署后在账号设置中创建只读 Token，并在终端执行 huggingface-cli login 粘贴该 Token 即可正常通过本镜像站下载。
Q: Git LFS 克隆下来的模型只有几 KB 且无法加载？ ▼
这是因为本地系统未安装 git-lfs 插件，导致下载的只是 Git LFS 指针文件。解决办法：运行 git lfs install 初始化，然后在克隆的仓库目录下执行 git lfs pull。