Butterbase 模板实战：如何一键克隆 butterbaseCRM 与 butterSupport 两个生产级应用

Butterbase 模板实战如何一键克隆 butterbaseCRM 与 butterSupport 两个生产级应用【免费下载链接】butterbase-ossOpen-source backend-as-a-service. Postgres, auth, storage, functions, AI gateway, MCP.项目地址: https://gitcode.com/gh_mirrors/bu/butterbase-ossButterbase 是一个开源的 Backend-as-a-ServiceBaaS平台内置 Postgres 数据库、认证、存储、云函数、AI 网关和 MCP 工具。它最大的特色之一是模板克隆Template Clone一条命令就能把完整的 CRM 或 AI 客服应用复制到你自己的账号下拥有独立的数据库、API 密钥和已部署的前端。本文带你实战克隆 butterbaseCRM 和 butterSupport 两个生产级模板从零到可运行。为什么用 Butterbase 模板而不是自己搭脚手架大多数脚手架只给你一个空目录和 README而 Butterbase 的模板是完整产品每个模板都是团队自己在用的真实应用。克隆后你第一天就拥有✅ 已建好 Schema 并启用行级安全RLS的 Postgres 数据库✅ 数十个已部署的无服务器函数含定时任务✅ 配置好的认证系统邮箱密码 Google OAuth✅ 已接入的 AI 网关无需申请第三方 API Key 即可出第一条回复✅ 已上线的 React 前端自动指向你的新后端✅ 可随时拉取到本地的代码仓库快照两个官方模板的定位如下总览文档见 templates/README.md模板定位函数数量配置难度butterbaseCRMAI 原生 CRM联系人、公司、交易、Gmail/日历同步、会议记录机器人、营销活动、社交发布56 个⭐ 零配置环境变量全部自动填充butterSupportAI 客服台可嵌入客服组件、基于 RAG 的文档问答、人工审批的回复草稿、升级与策略学习30 个 1 个 Durable Object⭐⭐ 需补 2 个函数变量 6 个 DO 变量找到模板仪表盘、CLI、API 三条路1. 仪表盘最适合新手在 Butterbase 仪表盘打开Templates页面可按名称搜索或按Recent / Popular克隆次数排序。每张卡片展示应用名、发布者和所在区域唯一操作按钮就是Clone。2. CLI推荐日常使用butterbase templates # 列出所有公开模板 butterbase templates --sort popular --limit 203. REST API适合自动化GET /v1/templates?qcrmsortpopularlimit20 GET /v1/templates/{app_id}浏览模板是匿名的无需任何凭据详情接口还会返回该模板的表和函数清单方便你先验货再下单。完整流程参考官方文档 cloning.md。一键克隆从点击到可用的完整流程克隆分三步走找到模板 → 预检Preflight→ 克隆并轮询任务。预检会告诉你克隆后哪些环境变量平台会自动填好auto_filled哪些第三方密钥需要你提供user_required。注意只返回变量名永远不会泄露源应用的密钥值。点击Clone后弹窗会让你给新应用命名并展示需要填写的环境变量。克隆任务会依次经历replaying_schema → replaying_rls → replaying_functions → copying_repo → seeding_data → completed等阶段——56 个函数的模板需要几分钟属正常现象。CLI 用户一行命令搞定以 CRM 为例命令细节见 QUICKSTART.mdbutterbase clone app_44zjayftl7b3 ./my-crm --name My CRM --region us-east-1这条命令会创建属于你自己的新应用把 Schema、RLS 策略、函数代码、认证/存储/AI 配置全部复制进去并把最新代码快照拉到本地./my-crm/目录。克隆后什么会转移、什么不会这是新手最容易踩坑的地方建议先读 configure.md✅ 会转移❌ 不会转移表结构、索引、类型OAuth 客户端密钥client secret行级安全策略、访问模式函数环境变量的值只给名字不给值函数代码已部署到你的应用Durable Object 的环境变量值代码仓库最新快照终端用户的账号和会话存储、CORS、AI 模型默认配置自定义域名、计费Stripe Connect配置发布者的种子数据_seed: true表调用历史与审计日志前端会被自动重新指向你的新应用并重新发布——克隆完成后直接在应用概览页打开 URL 就能看到界面。实战一butterbaseCRM — 零配置的 AI 原生 CRMbutterbaseCRM 是目录中最大的模板也是最容易启动的它需要的每一个环境变量都会在克隆时自动填充平台会自动为你的新应用签发作用域受限的bb_sk_*服务密钥不需要你先去申请任何第三方 API Key。仪表盘克隆只需 5 步打开Templates点击butterbase-crm→Clone给应用命名区域在仪表盘固定为模板所在的us-east-1环境变量步骤会显示 Nothing to enter直接点下一步点击Start clone等待 56 个函数重新部署完成后在概览页打开已上线的 CRM 前端克隆后建议做的事读取克隆告警会议记录机器人的 webhook 密钥wsec_*会在克隆时为你重新签发且只显示一次务必记录配置 Google OAuthGmail/日历同步需要你自己的 client id/secret源应用的不会转移配好前ingest-gmail等函数会空转设置消费上限该模板重度使用 AI富化、摘要、聊天、搜索都消耗积分还有多个无人值守的 cron 任务模板的完整功能清单和后端镜像代码都在仓库里Schema 定义见 schema.json前端源码在 frontend/ 目录想刷新本地后端镜像可运行 sync.sh。实战二butterSupport — 会读产品数据的 AI 客服台butterSupport 的亮点是AI 客服不只读你的帮助文档还能读取真实产品数据失败的支付、过期的卡、正在报错的客户账号并起草回复供你审批。每个工单由一个独立的 Durable Object 驱动推理过程实时流式展示在创始人控制台。⚠️ 重要提醒新克隆默认处于最高自治模式AUTO-RESOLVE——AI 会自主回复并关单仅账户删除、计费、退订三类问题强制升级给人工。在对真实用户开放前请务必先到Console → Autonomy把默认模式改为草稿待审批。克隆时的关键配置环境变量步骤会要求你填写两个值变量作用怎么填SUBSTRATE_OUTBOX_SECRET升级/出站流程的 HMAC 签名密钥自己生成的强随机密钥两个函数必须用同一个值RAG_COLLECTIONRAG 文档集合名如support-docs三个函数必须完全一致克隆后还有 3 个必做项补 Durable Object 环境变量7 个 DO 变量中有 4 个已就位缺的BUTTERBASE_API_URL、BUTTERBASE_APP_ID、RAG_COLLECTION必须手动补上它们若被复制过来反而是错的创建 RAG 集合并灌入文档把帮助中心的 URL 交给ingest-docs否则客服只会用模型的通用知识假装回答你的文档问题轮换组件密钥嵌入组件到公网前调用rotate-widget-secret别沿用源应用派生的值 常见故障如果RAG_COLLECTION在三个函数间不一致写入和查询会各用各的集合回答看似正常实则全空——这是该模板最常见的坑。完整架构和 Widget 签名机制见 butterSupport/README.md。克隆完成后的验证清单不管克隆的是哪个模板按这个顺序冒烟测试查表确认 Schema 和种子数据都到位调函数调用一两个核心函数遇到500几乎都是缺环境变量注册测试用户走一遍你的认证配置打开前端确认页面加载、核心流程可点通审安全姿态检查访问模式、通读随克隆转移过来的 RLS 策略别假设继承的配置对你的场景安全结语Butterbase 的模板机制把从零搭后端变成了一键拥有产品butterbaseCRM 适合需要长期跟踪人和组织的项目销售 CRM、投资人跟踪、招聘管道butterSupport 则适合AI 基于自有内容回答 人工审批放行的场景客服台、内部帮助台、文档助手。克隆只是起点跟着本文的配置清单走完你就能拥有一个真正属于自己的生产级应用。延伸阅读仓库内相对路径模板总览templates/README.mdCRM 快速上手templates/butterbaseCRM/QUICKSTART.mdCRM 功能说明templates/butterbaseCRM/README.mdbutterSupport 完整文档templates/butterSupport/README.md官方模板目录available.md克隆指南cloning.md克隆后配置清单configure.md【免费下载链接】butterbase-ossOpen-source backend-as-a-service. Postgres, auth, storage, functions, AI gateway, MCP.项目地址: https://gitcode.com/gh_mirrors/bu/butterbase-oss创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考