Hugging Face Spaces 部署指南
🚀 最简单的部署方式
你的项目已经配置好使用预构建的Docker镜像 docker.io/library/my-image-name:1763908533
部署步骤
创建 Hugging Face Space
- 访问 huggingface.co/spaces
- 点击 "Create new Space"
- 选择 "Docker" 作为 SDK
- 空间名称:例如
ai-studio-build
上传文件
# 初始化git仓库 git init git add . git commit -m "Initial commit - pre-built Docker image deployment" # 添加HF远程仓库 git remote add origin https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME git push origin main自动部署
- Hugging Face Spaces 会自动读取README.md中的配置
- 使用指定的Docker镜像进行部署
- 应用将在
https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space可访问
🔧 配置文件说明
README.md: 包含Space元数据和部署配置Dockerfile: 指定使用预构建镜像和端口配置.dockerignore: 排除不必要的文件
📋 部署检查清单
- Docker镜像已构建:
docker.io/library/my-image-name:1763908533 - README.md配置正确(sdk: docker, app_port: 7860)
- Dockerfile指向正确的预构建镜像
- 端口7860已暴露(HF Spaces标准)
🎯 完成后
部署成功后,你的应用将:
- 自动从Docker Hub拉取指定镜像
- 在端口7860上运行
- 支持Web界面访问
- 具备HTTPS安全连接