简介
HF-Mirror（hf-mirror.com）是一个面向国内 AI 开发者的 Hugging Face 公益镜像站。该项目致力于解决国内用户访问 Hugging Face 官方源时遇到的网络延迟高、连接不稳定等问题，提供快速、稳定的开源模型与数据集下载服务。作为公益项目，HF-Mirror 联合趋动云打造一站式 AI 开发体验，覆盖从资源发现、本地下载到云端部署运行的完整工作流。
主要功能
- 全站域名镜像：完整镜像
huggingface.co，无缝替代官方源，保障国内网络环境下的高速访问。
- 热门资源排行：实时展示模型与数据集的下载热度榜单，涵盖文本生成、多模态（image-text-to-text）等前沿方向，帮助用户快速发现优质开源项目。
- 多模式下载支持：提供网页直链、官方 CLI、自研高速下载器及非侵入式环境变量四种下载方案，适配不同开发习惯与工程需求。
- Gated Repo 授权下载：支持通过 Access Token 下载需申请权限的受限仓库，在保障 Hugging Face 账号安全的前提下满足合规获取需求。
- 算力平台联动：与趋动云深度集成，支持模型下载后直接对接云端 GPU 算力，实现开箱即用的部署与运行体验。
下载与使用方式
HF-Mirror 提供灵活的资源获取方案，开发者可根据实际场景选择：
- 网页直接下载：在镜像站搜索目标模型或数据集，进入详情页的
Files and versions 标签页即可手动下载文件。
- huggingface-cli（官方命令行）：安装
huggingface_hub 后，设置环境变量 HF_ENDPOINT=https://hf-mirror.com，即可使用官方命令下载模型或数据集，支持 --resume-download 断点续传。
- hfd 自研工具：基于
aria2 开发的专用下载脚本，具备高速下载、稳定不断线特性。配置环境变量后，通过 ./hfd.sh <repo_id> 即可一键拉取。
- 环境变量（非侵入式）：在运行 Python 训练/推理脚本前临时注入
HF_ENDPOINT=https://hf-mirror.com，Hugging Face 工具链将自动切换至镜像源，无需修改业务代码。
适用场景
- 国内大模型算法工程师、研究员下载开源基座模型（如 Llama、Qwen、GLM 系列）及预训练/微调数据集。
- 高校学生与 AI 爱好者进行本地模型部署、LoRA 微调及技术验证。
- 受限于网络环境，需要稳定、高速下载 Hugging Face 资源的企业开发团队。
- 希望快速完成“模型获取 → 云端 GPU 部署”闭环的 AI 应用开发者。
注意事项
- 本站为纯公益项目，服务器带宽与运维依赖社区捐赠支持。
- 出于账号安全考虑，镜像站不提供 Hugging Face 账号登录功能。下载 Gated Repo 时，需先前往 Hugging Face 官网申请权限并获取 Access Token，再通过命令行参数（如
--token 或 --hf_username/--hf_token）完成下载。
- 部分数据集内置的下载脚本可能硬编码了官方地址，此类情况需手动修改脚本内的 URL 以适配镜像源。
- 详细进阶用法与 Token 配置指南可参考站内提供的完整教程文档。
