DEPLOYMENT_GUIDE.md

免费部署平台选择指南

由于Railway免费账户有限制，以下是几个免费的替代方案：

方案一：Hugging Face Spaces（新增推荐）

Hugging Face Spaces 提供免费的 Docker 部署，特别适合 AI/ML 相关应用：

1. 准备代码

   • 将代码上传到GitHub仓库
   • 确保包含 Dockerfile.hf 和更新的 README.md

2. 部署步骤

   • 访问 huggingface.co/spaces
   • 点击 "Create new Space"
   • 选择 "Docker" SDK
   • 连接GitHub仓库或直接上传文件
   • 重命名 Dockerfile.hf 为 Dockerfile
   • Hugging Face 会自动构建和部署

3. 特点优势

   • 完全免费使用
   • 支持 Docker 容器
   • 自动 HTTPS
   • 内置演示界面（访问 /demo）
   • 社区友好，便于分享

4. 限制说明

   • CPU 限制较严格
   • 截图尺寸限制在 2000x2000
   • 超时时间较短（20秒）
   • 主要面向演示用途

方案二：Render.com

Render提供免费的Docker部署服务：

1. 准备代码

   • 将代码上传到GitHub仓库
   • 确保包含 render.yaml 配置文件

2. 部署步骤

   • 访问 render.com
   • 注册并连接GitHub账户
   • 点击 "New +" → "Blueprint"
   • 选择你的GitHub仓库
   • Render会自动读取 render.yaml 配置并部署

3. 免费限制

   • 750小时/月免费使用时间
   • 应用会在无活动时休眠
   • 冷启动需要几秒钟

方案三：Railway通过GitHub连接

即使免费账户也支持GitHub连接：

1. 上传到GitHub

   git init
   git add .
   git commit -m "Initial commit"
   git remote add origin https://github.com/yourusername/page-shot.git
   git push -u origin main
   

2. 在Railway连接

   • 访问你的项目：https://railway.com/project/1c166fd2-d6ee-4adf-8226-980cdf451b73
   • 点击 "Connect Repo"
   • 选择GitHub仓库
   • 自动部署

方案四：Vercel（仅限Node.js项目）

虽然Vercel主要用于前端，但也支持API：

1. 访问 vercel.com
2. 连接GitHub仓库
3. 自动部署

方案五：Heroku替代 - Koyeb

免费的容器化部署平台：

1. 访问 koyeb.com
2. 连接GitHub仓库
3. 选择Docker构建
4. 免费额度：512MB RAM，2.5M执行时间

推荐操作步骤

快速演示部署

Hugging Face Spaces（推荐用于演示）

• 完全免费
• 内置演示界面
• 社区分享友好
• 适合展示功能

生产环境部署

1. 中等使用量：Render.com

   • 免费额度充足
   • 稳定性好
   • 支持自定义域名

2. 重度使用：升级Railway Pro

   • 每月$5
   • 性能最佳
   • 无限制部署

Hugging Face Spaces 部署详细步骤

1. 创建 Space

   # 克隆你的仓库
   git clone https://github.com/yourusername/page-shot.git
   cd page-shot
   
   # 重命名 Dockerfile
   mv Dockerfile.hf Dockerfile
   

2. 上传到 HF Spaces

   • 方式一：通过 Git

     git remote add hf https://huggingface.co/spaces/yourusername/page-screenshot
     git push hf main
     

   • 方式二：通过 Web 界面直接上传文件

3. 配置 Space

   • Space 名称：page-screenshot
   • SDK：Docker
   • 可见性：Public（免费）

4. 访问应用

   • API 端点：https://yourusername-page-screenshot.hf.space/screenshot
   • 演示界面：https://yourusername-page-screenshot.hf.space/demo

你想选择哪个平台？我可以为你提供具体的部署步骤。