Hub documentation
容器镜像访问控制
单点登录(SSO) 审计日志 存储区域 用于私有数据集的 Data Studio 资源组(访问控制) 高级计算选项 高级安全 令牌管理 服务账号 发布者分析 门控组集合 网络安全 下载分析 速率限制 博客文章
PRO 计划 仓库 入门仓库 仓库设置 存储限制 存储后端(Xet) 本地缓存 Pull Requests 与 Discussions 通知 集合 Webhooks GitHub Actions Notebooks 后续步骤 许可证
模型 数据集 Spaces Spaces 概览 Spaces GPU 升级 Spaces ZeroGPU Spaces 开发模式 Spaces 磁盘使用量与存储 Spaces 自定义域名 Spaces 作为 MCP 服务器 Spaces 作为智能体工具 将 Spaces 用作 API 端点 Gradio Spaces Streamlit Spaces 静态 HTML Spaces Docker Spaces 嵌入您的 Space 使用 Docker 运行 Spaces Spaces 配置参考 使用 HF 登录按钮 精选 Spaces Spaces 更新日志 高级主题
存储桶 new 容器镜像 new 任务 智能体 智能体概述 Hugging Face AI 智能体 CLI Hugging Face MCP 服务器 Hugging Face Agent Skills 使用 HF SDK 构建智能体 使用 llama.cpp 的本地代理 Agent 库 会话跟踪格式
其他 容器镜像访问控制
谁可以拉取和推送镜像取决于仓库的可见性以及每位成员在组织中的角色:任何人都可以拉取公开镜像,只有成员可以拉取私有镜像,而推送需要 write 角色。令牌遵循相同的规则:具有 read 权限的 User Access Token 用于拉取,具有 write 权限的用于推送。
使用资源组进行访问控制
在采用 Team 或 Enterprise 套餐的组织中,镜像可以归属于某个 Resource Group。此时,成员在该组中的角色将取代其组织角色,用于该镜像的操作:read 用于拉取,write 用于推送。Resource Group 中的私有镜像只能由该组的成员和组织管理员拉取。
在创建仓库时选择组,或者从镜像的设置中、或从该组的 Resources 选项卡中进行选择。使用 API 时,在创建仓库时传入 resourceGroupId,或移动现有仓库(组的 ID 位于其页面 URL 的末尾,GET /api/organizations/my-org/resource-groups 可列出所有组):
curl -X POST https://huggingface.co/api/containers/my-org/my-app/resource-group \
-H "Authorization: Bearer $HF_TOKEN" \
-H "Content-Type: application/json" \
-d '{"resourceGroupId": "<resource-group-id>"}'