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