• 2025-10-17
  • 实现网页端一键登录功能。
  • 将登录页面从静态提示升级为交互式表单，用户可直接在代理站粘贴 Cookie。
  • 新增 /set-cookie 后端接口，自动处理并设置登录凭证。
  • 极大简化了登录流程，提升了易用性和用户体验。
• 2025-08-23
  • 修复由于Huggingface API变更导致的Content-Length功能失效问题。#11 #12
  • 部分支持Huggingface Spaces (测试) #10
• 2025-05-09
  • 支持Huggingface xet (测试)
• 2024-12-02
  • 优化部署流程，仅需一个域名即可完成配置。 #4
  • 兼容 Huggingface 最新的 CDN 配置。 #4
  • 防止Cloudflare报钓鱼网站 #5
  • 解决Huggingface客户端必须要content-length头的问题 #4
  • 支持Huggingface使用CDN存储静态资源 #6
• 2024-07-03
  • 支持pages部署 #3
• 2023-11-25
  • huggingface的cdn地址发生变化
• 2023-12-08
  • 支持多种CDN

• Cloudflare 账号（免费）
• 一个域名（绑定到 Cloudflare）
• 一点点时间和耐心

1. 登录 Cloudflare Workers 控制台，新建一个 Worker。

2. 将代码库中 src/_worker.js 的内容复制到 Workers 编辑器中。

3. 保存代码。

4. 在设置-域和路由里添加你的自定义域名（如 hf.yourdomain.com）。

5. 设置环境变量：

   • 在需要使用 Huggingface 的环境中，添加如下配置：

     HF_ENDPOINT=https://你的域名

• Cloudflare 账号（免费）
• 一个域名（无需绑定到 Cloudflare，支持自定义域名）

1. 下载项目代码。
2. 在 Cloudflare Pages 新建项目，将 src 文件夹作为代码上传源。
3. 保存并部署 Pages。
4. 绑定一个子域名（如 hf.yourdomain.com），按提示完成绑定。
5. 设置环境变量：
   • 在需要使用 Huggingface 的环境中，添加如下配置：

     HF_ENDPOINT=https://你的域名

部分 Huggingface 仓库（私有或受限仓库）需要登录权限才能访问。现在，你可以通过代理站内置的登录功能，轻松完成授权，无需复杂配置。

• 类 Chrome 浏览器
• 浏览器扩展：Cookie Editor
• 能够直连 Huggingface 的网络环境（用于首次登录获取 Cookie）

1. 访问代理登录页：在浏览器中打开你的代理站登录地址（例如 https://你的域名/login）。
2. 在官网登录：在新标签页中，访问 Hugging Face 官网 并正常登录你的账户。
3. 复制 Cookie：
   • 安装并打开浏览器扩展 Cookie Editor。
   • 在扩展中，找到 huggingface.co 域名。
   • （推荐） 点击 “Export” 或 “Copy” 按钮，一键复制所有 Cookie。
   • （手动） 或者，手动复制所有 Cookie 的 名称=内容，并用分号 ; 将它们拼接成一整行。
4. 在代理站登录：
   • 返回到你的代理站登录页面。
   • 将复制的内容粘贴到文本框中。
   • 点击 “登录” 按钮。
5. 完成登录：页面会提示“Cookie 设置成功！”，并自动跳转至首页。现在你应该已经处于登录状态，可以访问需要权限的仓库了。

1. 代理地址加载失败怎么办？
   • 检查域名解析是否正确绑定到 Cloudflare。
   • 确认 Worker 或 Pages 的触发器是否配置正确。
2. 是否支持 Huggingface 的全部功能？
   • 支持大部分常用功能（如模型下载、API 调用）。
   • 登录授权功能已通过内置的网页表单实现，用户只需粘贴 Cookie 即可，非常方便。
3. Cookie 失效了怎么办？
   • Hugging Face 的 Cookie 可能会过期。如果发现登录状态丢失，只需重复上述登录步骤，重新设置一次 Cookie 即可。

欢迎通过 GitHub Issues 提交问题或建议！😊