Hugging Face Spaces：把模型 Demo 放上网之前，先分清代码公开、应用公开和私有

哇哦AI

工具信息
工具名称：Hugging Face Spaces
主要分类：编程与开发
官网：访问官网
价格：提供基础与付费计算资源，硬件、休眠、存储和费用以当前 Space 设置为准
代码要求：需要编写或维护应用代码；可复制公开 Space 作为起点，但仍要理解依赖、构建、权限和运行日志
中文支持：官方界面和文档以英文为主；自己创建的应用可按项目需要提供中文界面
使用平台：网页、Git 仓库、Dev Mode（网页 VS Code、SSH 或本地编辑器）、API 与命令行

你可能在 Hugging Face 上点开过一个图像生成、语音识别或聊天 Demo，浏览器里直接就能试。承载这些小应用的就是 Spaces。它不只是一个作品列表，而是一套把代码仓库、构建过程、运行硬件和公开页面连在一起的托管入口；真正开始之前，先决定代码和应用究竟要公开到什么程度。

它不是模型列表，而是一个会运行代码的应用仓库
创建 Space 时，要先选应用名称、可见性和运行方式。Gradio 适合用 Python 做机器学习界面，Docker 可以带上更完整的运行环境，Static 适合前端静态页面。代码和配置保存在 Git 仓库里；推送新的提交后，平台会重新构建并启动应用。构建失败、依赖缺失或运行报错时，仍要回到日志和代码中处理，不是上传一个模型名称就自动得到可用网站。

官方的 Dev Mode 可以从 Space 设置进入网页 VS Code，也能通过 SSH 或本地编辑器继续改代码，并查看运行与 Git 状态。公开社区里现成的 Space 可以复制成自己的仓库作为起点，但复制的是代码和配置关系，不是对原作者模型、数据、图片、字体和其他素材的无限授权；动手前仍要逐项看许可证。

Public、Protected 和 Private，公开的东西并不一样
Public Space 的源代码、正在运行的应用和复制入口都对外开放，适合公开 Demo、作品集和希望社区共同改进的项目。Protected 会把源代码留给所有者和协作者，但运行中的应用仍可通过嵌入地址或配置的域名对外访问；它适合不公开代码、又需要让别人使用页面的情况。Private 则同时限制代码和运行应用，只让获授权的成员访问。

这里最容易混淆的是‘代码看不见’和‘应用不对外’。Protected 只解决前者，用户在公开页面提交的文字、图片或文件仍会进入你运行的程序和它连接的服务。项目维护者还要自己设计登录、权限、隐私说明、日志和删除机制；换一个可见性选项并不会自动补齐这些业务控制。

变量、Secrets 和运行磁盘，放错地方会留下真问题
模型名称、公开开关等非敏感配置可以放 Variables；访问令牌、API Key 和其他凭据应放 Space 设置里的 Secrets，不能写进公开仓库。普通 Variables 本来就是可公开查看的配置，Static Space 的页面代码还能在浏览器端取得配置内容，因此任何会带来账号权限或费用的值都不该放在那里。复制别人的 Space 时，公开变量可能会一并带过来，Secrets 则需要由新所有者重新设置。

Space 运行时写入的本地磁盘是临时的，重启或停止后可能丢失。需要保存用户文件、索引或业务状态时，应改用当前支持的 Storage Bucket、Hub 仓库或外部存储，并同时设置访问权限、清理和备份。不要等 Demo 有了真实用户，才发现文件只留在一台会重启的运行实例里。

硬件升级能让 Demo 跑得动，也可能在没人访问时继续计费
基础计算适合较轻的示例，模型更大、需要 GPU 或访问量上来后，可以在设置里选择其他硬件或申请社区资源。升级硬件通常按实际运行状态计费；应用没有访客时也可能保持运行，因此要根据用途设置休眠、手动暂停或降回基础硬件。需要多副本、稳定容量和长期运行时，还要继续评估成本、监控和故障恢复，不能只看一次演示能不能打开。

Spaces 很适合把研究成果做成可分享 Demo、给同事演示原型，或把开源项目放进社区让别人试用。它替你接上了仓库、构建、硬件和网页入口，但代码安全、数据去向、许可证、依赖更新、成本和对外服务质量仍然属于项目本身。

官方应用展示

图片来源：官方页面

资料来源
https://huggingface.co/spaces/launch
https://huggingface.co/docs/hub/main/spaces-overview