下载加速缓存代理使用说明

本项目是一份下载加速代理使用说明，面向需要访问 GitHub、HuggingFace 与 Docker 资源的 AI 对话、脚本和程序。架构上，.223 本机的 127.0.0.1:8086 通过 SSH 隧道连接香港 VPS 的 127.0.0.1:8081 缓存代理；127.0.0.1:5000 通过隧道连接 VPS 的 registry:2 镜像缓存。服务仅本机可见，没有公网端口、域名或证书。实测 GitHub 下载从 34KB/s 提升到 1.3~3.3MB/s，HuggingFace 从打不开提升到 3MB/s+。文档给出了一键工具 ghfetch、git/HuggingFace/Docker 的自动生效方式、手动下载拼接方法，以及程序内调用和代理健康检查、回退策略。当前代理缓存上限 3GB，Docker 镜像缓存上限 8GB，主要用于开发资源加速，不用于流媒体、游戏或通用翻墙。

功能

• 提供 ghfetch/ghdl/hfdl 一键下载，自动识别 GitHub/HuggingFace 并在代理不可用时回退直连
• git 访问 github.com 已通过 /etc/gitconfig 自动走 127.0.0.1:8086
• HuggingFace 库通过 HF_ENDPOINT 自动使用本机缓存代理
• Docker 拉镜像按 daocloud 主、VPS 缓存备的顺序自动处理
• 支持手动 curl/wget 拼接代理地址，或在 Python/Node/Go 等程序内调用 ghfetch
• 提供 proxy-status 与 /health 健康检查，隧道和容器服务支持自动重连

技术栈

使用 / 部署教程

以下按资料中的使用流程整理，资料未提供从零安装步骤。

1. 检查代理：运行 proxy-status，或执行 curl -s http://127.0.0.1:8086/health，返回 OK 表示可用。
2. 一键下载：使用 ghfetch <url> [输出文件]，会自动判断 GitHub/HuggingFace 并走缓存代理；ghdl、hfdl 为别名。代理不可用时 ghfetch 会自动回退直连并打印警告。
3. 自动生效项：git 访问 github.com 已由 /etc/gitconfig 配置代理；HuggingFace 库使用 HF_ENDPOINT=http://127.0.0.1:8086，若进程未继承可手动 export；Docker 拉镜像已配置 daocloud 主、VPS 缓存备，无需改动。pip/npm 不需要改走代理。
4. 手动下载：不用 ghfetch 时，在 GitHub URL 前拼接 http://127.0.0.1:8086/ 后用 curl/wget 下载；HuggingFace 推荐设置 HF_ENDPOINT，或按文档拼接代理 URL。
5. 程序内调用：禁止把全局 HTTPS_PROXY 设为该代理；可在子进程中调用 /usr/local/bin/ghfetch <url> <out>，或拼接代理 URL 后直接 GET，或设置 HF_ENDPOINT 使用官方库。
6. 维护与回退：隧道/服务为 .223 上的 cache-proxy-tunnel、registry-cache-tunnel，VPS 上为 cache-proxy、registry-cache 容器，systemd 自动重连。

常见问题