个人版部署
个人版采用 Apache 2.0 协议,完全开源,支持商用。通过 Vercel 一键部署,快速上手。
🎯 部署概览
个人版部署非常简单,只需要 Fork 仓库并连接 Vercel 即可完成部署。
⚡
预计部署时间:5-10 分钟
📋 准备工作
在开始部署前,请确保您已经准备好以下账户:
- GitHub 账户 - 用于 Fork 项目代码
- Vercel 账户 - 用于部署前端应用
- Supabase 账户 - 用于数据库服务(推荐)
- OpenAI 账户 - 用于 AI 服务
🚀 部署步骤
Fork GitHub 仓库
- 访问 Snapifit AI GitHub 仓库
- 点击右上角的 Fork 按钮
- 选择您的 GitHub 账户,完成 Fork
连接 Vercel 账户
- 访问 Vercel Dashboard
- 点击 New Project 按钮
- 选择 Import Git Repository
- 找到您刚才 Fork 的
snapifit-ai仓库 - 点击 Import 按钮
配置 Supabase 数据库
- 登录 Supabase Dashboard
- 点击 New Project 创建新项目
- 填写项目信息:
- Name:
snapifit-ai - Database Password: 设置一个强密码
- Region: 选择离您最近的区域
- Name:
- 等待项目创建完成(约 2-3 分钟)
- 在项目设置中找到以下信息:
- Project URL:
https://xxx.supabase.co - API Key:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
- Project URL:
设置环境变量
在 Vercel 项目设置中添加以下环境变量:
# 应用基础配置
NEXTAUTH_URL=https://your-app-name.vercel.app
NEXTAUTH_SECRET=your-random-secret-key
# Supabase 配置
NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
DATABASE_URL=postgresql://postgres:password@db.xxx.supabase.co:5432/postgres
# OpenAI 配置
OPENAI_API_KEY=sk-xxx...⚠️
请将上述示例值替换为您的实际配置信息。
部署应用
- 在 Vercel 中点击 Deploy 按钮
- 等待部署完成(约 3-5 分钟)
- 部署成功后,您将获得一个访问链接
初始化数据库
- 访问您的应用链接
- 首次访问时会自动创建必要的数据库表
- 注册您的管理员账户
- 开始使用 Snapifit AI!
✅ 部署验证
部署完成后,请验证以下功能是否正常:
- 应用可以正常访问
- 用户注册和登录功能正常
- AI 对话功能正常
- 数据记录和保存功能正常
- 图片上传功能正常
🔧 常见问题
部署失败怎么办?
- 检查环境变量是否配置正确
- 确认 Supabase 项目状态正常
- 查看 Vercel 部署日志中的错误信息
- 参考 故障排除指南
如何更新应用?
- 在您的 GitHub 仓库中同步上游更新
- Vercel 会自动检测到更改并重新部署
- 也可以在 Vercel Dashboard 中手动触发部署
如何自定义配置?
个人版支持完全自定义,您可以:
- 修改应用主题和样式
- 添加自定义功能
- 集成其他第三方服务
- 部署到其他平台
📞 获取支持
如果在部署过程中遇到问题:
- 查看 常见问题
- 搜索 GitHub Issues
- 在 讨论区 提问
- 联系开发团队
🎉
恭喜!您已经成功部署了 Snapifit AI 个人版。现在可以开始您的健康管理之旅了!
🔗 相关链接
- 用户指南 - 了解如何使用 Snapifit AI
- API 文档 - 开发者接口文档
- 更新日志 - 查看最新功能和修复
- Apache 2.0 协议 - 了解协议详情
Last updated on