网站部署发布

技能简介

web-deploy 提供从本地构建到生产环境发布的完整工作流，覆盖静态站点、Next.js 应用、FastAPI 服务等多种技术栈，支持 Vercel、Railway、GitHub Pages 及本地 Canvas 等多目标平台。

业务背景

网站部署发布帮助团队快速将开发成果上线。无需复杂配置，即可将前端页面、后端服务或文档站点一键发布到云端，支持多平台灵活选择。本地预览功能让业务人员提前验收效果，版本回滚能力保障线上稳定，大幅降低技术门槛与发布风险。

落地案例：某产品团队完成官网改版后，通过该工具在本地构建并预览效果，确认无误后一键部署至 Vercel；同时将 API 服务同步发布到 Railway，实现前后端独立上线。后续发现异常时，2分钟内回滚至上一版本恢复服务，全程无需运维介入。

能做什么

• 在本地预览生产构建效果，验证无误后再发布
• 一键部署至 Vercel（前端/无服务器函数）
• 部署后端 API 与数据库到 Railway
• 使用 GitHub Pages 托管文档与静态页面
• 回滚至历史版本，快速恢复服务
• 配置自定义域名与 HTTPS

使用说明

1. 安装依赖

# Vercel CLI
npm i -g vercel

# Railway CLI
curl -fsSL https://railway.app/install.sh | sh

# gh-pages（可选）
npm install -D gh-pages

2. 本地预览

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

# Next.js
npm run build && npm run start

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

3. 部署到 Vercel

npx vercel link      # 首次关联项目
npx vercel           # 预览部署
npx vercel --prod    # 生产部署

4. 部署到 Railway

railway login
railway init
railway up
railway add --plugin postgresql  # 添加数据库

5. 回滚操作

npx vercel rollback   # Vercel
railway rollback      # Railway

输入与输出

见下方输入与输出表格。

风险提示

• 务必将敏感配置存入平台环境变量，禁止提交 .env 文件至代码仓库
• 生产部署前需确认构建通过、测试全部完成、无类型错误
• 图片与代码包体积过大将影响加载速度，建议开启压缩与分割
• 自定义域名需正确配置 DNS 解析，否则无法访问

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/cmanfre7/web-deploy/SKILL.md
来源类型：开源社区技能库