Feedbase 部署到 Vercel 指南免费云托管你的反馈系统的完整流程【免费下载链接】feedbaseThe open-source solution for collecting feedback communicating updates.项目地址: https://gitcode.com/gh_mirrors/fe/feedbaseFeedbase 是一款开源的反馈收集与更新沟通工具旨在帮助产品团队高效收集用户反馈、管理功能建议并发布更新日志。本指南将手把手教你将 Feedbase 部署到 Vercel免费云托管属于你自己的反馈系统全程无需服务器、无需为基础设施付费只需几个简单的配置步骤即可上线。为什么选择 Feedbase Vercel 的组合在开始部署前先快速了解这套组合的优势优势说明零服务器成本Vercel 提供免费托管额度Feedbase 本身开源免费自动 HTTPSVercel 自动为你的反馈系统配置 SSL 证书持续部署代码推送即自动构建上线无需手动操作全球 CDN访问速度更快用户体验更佳Feedbase 的技术栈基于 Next.js TypeScript Supabase与 Vercel 天然兼容这也是官方推荐的自托管方式。官方部署文档位于 vercel.mdx部署前建议通读一遍。部署前的准备工作正式部署前你需要准备以下账号和工具Supabase 账号用于创建数据库和用户认证服务Vercel 账号用于云托管你的反馈系统Git 客户端用于克隆 Feedbase 仓库第一步创建 Supabase 项目进入 Supabase 控制台点击 New Project 按钮创建新项目。创建完成后记下项目的Project URL和anon key它们位于项目的 API 设置页面后续配置环境变量时需要用到。第二步迁移数据库结构Feedbase 的所有数据库迁移脚本存放在项目的 supabase/migrations 目录中共包含 6 个 SQL 迁移文件涵盖数据库认证、存储、API Key 系统、自定义主题、通知系统、更新日志订阅等数据表。迁移数据库有三种方式新手推荐前两种方式一使用 Supabase CLI推荐首先克隆 Feedbase 仓库git clone https://gitcode.com/gh_mirrors/fe/feedbase.git然后依次执行登录、关联项目和推送迁移supabase login supabase link --project-ref 你的项目ID supabase db push项目 ID 可以在 Supabase 项目仪表盘的 URL 中找到或通过supabase projects list命令查看。方式二使用 SQL Editor 手动执行进入 Supabase 项目的 SQL Editor将supabase/migrations目录下每个迁移文件的内容依次复制进去并运行。如果全部执行成功你的 Supabase 仪表盘中应该能看到完整的数据库表结构。方式三使用 Supafork 自动化迁移Supafork 可以帮你自动 fork Feedbase 仓库并完成数据库迁移适合不想接触命令行的小伙伴。第三步配置 Supabase 认证数据库迁移完成后进入 Supabase 的 Authentication 设置中的URL Configuration添加你的站点地址和重定向地址Site URLhttps://你的域名.comRedirect URLshttps://**.你的域名.com/**这一步非常关键配置错误会导致用户登录失败或回调地址报错。Feedbase 环境变量配置详解环境变量是部署过程中最容易出错的一环。Feedbase 所需的全部环境变量定义在仓库根目录的 .env.example 文件中部署前请逐项核对。必填环境变量变量名说明NEXT_PUBLIC_SUPABASE_URLSupabase 项目的 API URLNEXT_PUBLIC_SUPABASE_ANON_KEYSupabase 项目的匿名公钥NEXT_PUBLIC_ROOT_DOMAIN站点根域名不带 https:// 和末尾斜杠子域名托管相关变量如果你计划在子域名上托管 Feedbase例如https://feedback.example.com需要额外配置SUBDOMAIN_HOSTING设置为trueDASHBOARD_SUBDOMAIN设置为托管管理后台的子域名前缀CUSTOM_DOMAIN_WHITELIST逗号分隔的自定义域名白名单用于公共反馈页面的域名分配提示如果你已经在根域名上托管了落地页强烈建议使用子域名方式托管 Feedbase避免冲突。可选环境变量RESEND_API_KEY用于邮件通知和团队邀请不使用邮件功能可留空SUPABASE_SERVICE_ROLE_KEY仅单点登录SSO集成需要TINYBIRD_API_KEY仅使用 Tinybird 数据分析时需要VERCEL_PROJECT_ID/VERCEL_TEAM_ID/VERCEL_AUTH_TOKEN仅自定义域名功能需要一键部署 Feedbase 到 Vercel 的具体步骤环境变量准备好后就可以开始正式部署了。整个部署过程约 5-10 分钟。在 Vercel 中导入仓库登录 Vercel 控制台点击 Add New → Project选择从 Git 仓库导入 Feedbase 项目。如果你还没有将仓库推送到自己的 Git 平台也可以使用 Vercel 的 CLI 直接部署npm i -g vercel vercel关键配置Root Directory 必须设为 apps/webFeedbase 是一个 monorepo 结构使用 pnpm workspace Turbo 管理Web 应用位于 apps/web 目录。因此你需要在 Vercel 项目的Settings → General中将Root Directory设置为apps/web。这是新手最容易踩的坑如果这一步没配置构建会失败并报错Error: No Output Directory named public found after the Build completed。添加环境变量并部署在 Vercel 项目设置的Environment Variables中添加前面整理好的全部环境变量。注意勾选合适的环境Production / Preview / Development。然后点击 Deploy 按钮等待构建完成即可。部署完成后你的反馈系统就会在 Vercel 分配的域名上运行了。你可以在管理后台创建项目、发布更新日志、收集用户反馈完整的后台代码位于 apps/web/app/dash 目录。部署常见问题排查Troubleshooting根据官方文档和社区反馈以下三个问题出现频率最高遇到时按图索骥即可构建失败找不到 public 输出目录原因monorepo 的 Root Directory 未配置。解决进入 Project Settings → General将 Root Directory 改为apps/web后重新部署。页面显示 404: NOT_FOUND原因构建与部署设置不匹配。解决在 Project Settings → General 中将 Framework Preset 选择为Next.js。页面出现 404 错误原因子域名相关的环境变量配置错误。解决回到环境变量配置部分重新核对SUBDOMAIN_HOSTING、DASHBOARD_SUBDOMAIN、CUSTOM_DOMAIN_WHITELIST三个变量是否设置正确。总结通过本指南你已经掌握了 Feedbase 部署到 Vercel 的完整流程创建 Supabase 项目并迁移数据库 → 配置认证与环境变量 → 在 Vercel 中设置 Root Directory 并一键部署。整个过程完全免费无需购买服务器Feedbase 的邮件模板、通知系统等完整功能开箱即用。现在就去部署你自己的反馈系统吧把用户的声音变成产品改进的动力【免费下载链接】feedbaseThe open-source solution for collecting feedback communicating updates.项目地址: https://gitcode.com/gh_mirrors/fe/feedbase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考