国内直接访问 huggingface.co 通常会超时或打不开，核心原因是

海外服务器+跨境链路限制

下面是一些解决方案，立即可用，优先级从高到低的解法：

---

一、最省事：用国内镜像（无需代理）

访问/下载都走国内镜像站，速度快、稳定。

1）浏览器直接访问

打开：https://hf-mirror.com
界面和官方完全一致，可浏览、搜索、下载模型。

2）命令行 / Python 全局替换

设置环境变量 HF_ENDPOINT，所有 huggingface_hub/transformers 会自动走镜像：

# Linux/macOS 临时
export HF_ENDPOINT=https://hf-mirror.com

# Windows CMD
set HF_ENDPOINT=https://hf-mirror.com

# Windows PowerShell
$env:HF_ENDPOINT = "https://hf-mirror.com"

永久生效（Linux/macOS）：

echo 'export HF_ENDPOINT=https://hf-mirror.com' >> ~/.zshrc
source ~/.zshrc

3）下载示例（用镜像）

pip install huggingface-hub
huggingface-cli download 模型名 --local-dir 保存路径

二、备用国内平台（模型丰富）

• 魔搭 ModelScope：https://modelscope.cn/
• 百度飞桨 PaddleHub：https://www.paddlepaddle.org.cn/hub

三、常见报错速查

• Failed to connect to huggingface.co port 443: Timeout → 用镜像或开代理
• SSL certificate problem → 换浏览器/清缓存，或用镜像
• 429 Too Many Requests → 限流，换镜像或稍后重试

---

建议优先用 hf-mirror.com 镜像，基本能解决 95% 的访问/下载问题，且长期稳定。