web-deploy

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

本地预览工作流

# Static site
npx http-server ./dist -p 8080 -c-1

# Next.js
npm run dev          # Development (hot reload)
npm run build && npm run start  # Production preview

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

# Vite-based
npm run dev          # Dev server
npm run build && npx serve dist  # Production preview

部署目标

Vercel (前端 / Next.js / 静态)

# First time setup
npx vercel link

# Preview deployment
npx vercel

# Production deployment
npx vercel --prod

# Environment variables
npx vercel env add SECRET_KEY

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

配置： vercel.json(对于 Next.js 通常不需要)

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

Railway (后端 / API / 数据库)

# First time setup
railway login
railway init

# Deploy
railway up

# Add database
railway add --plugin postgresql

# Environment variables
railway variables set SECRET_KEY=value

# View logs
railway logs

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

GitHub Pages (静态站点)

# Using gh-pages package
npm install -D gh-pages
# Add to 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/

部署前检查清单

• 本地构建成功运行构建命令/运行Python构建命令)
• 无TypeScript/代码检查错误
• 测试通过
• 在目标平台设置环境变量
• 环境配置文件/ 密钥不在git中
• robots.txt文件和sitemap.xml文件如果是公开网站
• 设置网站图标和元标签
• 配置HTTPS（在Vercel/Railway上自动配置）
• 配置错误页面（404，500）
• 性能：优化图片，代码分割，无巨大包

回滚

# Vercel — redeploy previous
npx vercel rollback

# Railway — redeploy previous
railway rollback

# Git-based — revert and push
git revert HEAD && git push

域名设置

# Vercel
npx vercel domains add mydomain.com

# DNS: Point CNAME to cname.vercel-dns.com
# Or A record to 76.76.21.21