web-deploy

构建并部署网站、Web 应用和 API 到生产环境。

本地预览流程

# 静态网站
npx http-server ./dist -p 8080 -c-1

# Next.js
npm run dev          # 开发模式（热重载）
npm run build && npm run start  # 生产环境预览

# FastAPI
uvicorn app.main:app --reload --port 8000

# 基于 Vite 的项目
npm run dev          # 开发服务器
npm run build && npx serve dist  # 生产环境预览

部署目标平台

Vercel（前端 / Next.js / 静态站点）

# 首次设置
npx vercel link

# 预览部署
npx vercel

# 生产环境部署
npx vercel --prod

# 环境变量
npx vercel env add SECRET_KEY

最适合： Next.js 应用、React 单页应用、静态站点、无服务器函数。

配置文件： vercel.json（Next.js 项目通常不需要）

{
  "buildCommand": "npm run build",
  "outputDirectory": "dist",
  "framework": "nextjs"
}

Railway（后端 / API / 数据库）

# 首次设置
railway login
railway init

# 部署
railway up

# 添加数据库
railway add --plugin postgresql

# 环境变量
railway variables set SECRET_KEY=value

# 查看日志
railway logs

最适合： 后端 API、数据库、长时间运行进程、Docker 容器。

GitHub Pages（静态站点）

# 使用 gh-pages 包
npm install -D gh-pages
# 在 package.json 的 scripts 中添加："deploy": "gh-pages -d dist"
npm run build && npm run deploy

最适合： 文档、简单的静态站点、项目页面。

Canvas（Clawdbot 工作空间）

部署到 ~/clawd/canvas/ 目录，以便通过 clawdbot 网关本地访问。

cp -r ./dist/* ~/clawd/canvas/my-project/

部署前检查清单

• [ ] 本地构建成功（npm run build / python -m build）
• [ ] 无 TypeScript / 代码检查错误
• [ ] 测试通过
• [ ] 目标平台环境变量已设置
• [ ] .env / 密钥文件未提交到 Git
• [ ] 公开站点已配置 robots.txt 和 sitemap.xml
• [ ] 已设置网站图标和元标签
• [ ] 已配置 HTTPS（Vercel/Railway 上自动配置）
• [ ] 已配置错误页面（404、500）
• [ ] 性能优化：图片已优化、代码已分割、无超大打包文件

回滚操作

# Vercel — 重新部署上一个版本
npx vercel rollback

# Railway — 重新部署上一个版本
railway rollback

# 基于 Git — 回退并推送
git revert HEAD && git push

域名设置

# Vercel
npx vercel domains add mydomain.com

# DNS 配置：将 CNAME 指向 cname.vercel-dns.com
# 或将 A 记录指向 76.76.21.21