GitHub / Hugging Face 访问优化指南

做 AI 开发，GitHub 和 Hugging Face 是绕不开的。但国内访问这些海外资源经常遇到慢、超时、下载失败的问题。下面分享几个我在实际开发中用过且有效的方案。

GitHub 访问优化

方案 1：配置 Git 代理

# 配置 HTTP 代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy

方案 2：使用 SSH 代替 HTTPS

# 生成 SSH 密钥
ssh-keygen -t ed25519 -C "your_email@example.com"
# 将公钥添加到 GitHub 账号
cat ~/.ssh/id_ed25519.pub
# 使用 SSH URL 克隆仓库
git clone git@github.com:user/repo.git

方案 3：使用 GitHub 镜像

# 使用镜像克隆
git clone https://ghproxy.com/https://github.com/user/repo.git
# 或配置 Git 使用镜像
git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"

方案 4：下载单个文件

# 使用 curl 下载单个文件
curl -L -o file.py https://ghproxy.com/https://raw.githubusercontent.com/user/repo/main/file.py

Hugging Face 访问优化

方案 1：使用镜像站（推荐）

# 设置环境变量
export HF_ENDPOINT=https://hf-mirror.com
# 使用 huggingface-cli 下载
pip install huggingface_hub
huggingface-cli download meta-llama/Llama-3-8B --local-dir ./models

方案 2：Python 代码中配置

import os
os.environ["HF_ENDPOINT"] = "https://hf-mirror.com"
from huggingface_hub import snapshot_download
snapshot_download(
    repo_id="meta-llama/Llama-3-8B",
    local_dir="./models"
)

方案 3：使用 transformers 下载

import os
os.environ["HF_ENDPOINT"] = "https://hf-mirror.com"
from transformers import AutoModelForCausalLM, AutoTokenizer
model_name = "Qwen/Qwen2-7B"
tokenizer = AutoTokenizer.from_pretrained(model_name, trust_remote_code=True)
model = AutoModelForCausalLM.from_pretrained(model_name, trust_remote_code=True)

方案 4：使用代理

# 配置代理
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
# 下载模型
huggingface-cli download meta-llama/Llama-3-8B

包管理器优化

npm 镜像

# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com
# 临时使用
npm install --registry https://registry.npmmirror.com

PyPI 镜像

# 使用清华镜像
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 临时使用
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name

pip 使用阿里云镜像

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

安全提醒

• 不要在公共 Wi-Fi 上直接操作 Git（中间人攻击可以截获你的凭据）
• 用 SSH 密钥认证代替密码（更安全也更稳定）
• API Key 不要硬编码在代码里，用 .env 文件存，加到 .gitignore
• 验证下载文件的 hash，确保完整性
• 定期轮换 Token 和 API Key

合规提醒

请遵守所在地的法律法规和服务条款。本文提供的建议仅基于合法合规的开发场景。网络连接方案的选择应确保符合当地法律和平台规定。

常见问题

镜像站和官方站有什么区别？

镜像站是官方站的同步副本，内容相同但可能有延迟。模型文件应校验 hash 确保完整性。企业用户建议用官方渠道或自建镜像。

代理会影响下载速度吗？

好的代理应该提升而非降低速度。选择时关注延迟、稳定性和带宽。

企业环境如何优化？

企业可以自建镜像服务，或用云服务商的镜像加速（阿里云镜像、腾讯云镜像等）。

我的实际选择

• 日常开发：SSH + 镜像站组合，够用了
• 模型下载：hf-mirror.com 镜像，比直连快很多
• 包管理：npm 用淘宝镜像，PyPI 用清华镜像
• 敏感操作：用稳定的网络连接，确保安全

下一步学习

• 海外工具安全使用：海外 AI 工具安全清单
• ChatGPT 访问优化：ChatGPT 访问慢？网络优化与替代方案
• Claude API 问题排查：Claude API 调用失败排查指南