L站社区版部署
L站社区版专为 Linux.do 社区用户设计,采用 Apache 2.0 协议,完全开源。
🎯 部署概览
L站社区版提供专门的登录集成和社区功能,部署过程分为两个步骤。
⚡
预计部署时间:10-15 分钟
📋 准备工作
在开始部署前,请确保您已经准备好:
- Linux.do 账户 - 用于身份验证
- GitHub 账户 - 用于 Fork 项目代码
- Vercel 账户 - 用于部署前端应用
- Supabase 账户 - 用于数据库服务
- OpenAI 账户 - 用于 AI 服务
🚀 部署步骤
第一步:获取 L站版本代码
Fork L站专用仓库
- 访问 Snapifit AI L站版仓库
- 点击右上角的 Fork 按钮
- 选择您的 GitHub 账户,完成 Fork
ℹ️
L站版本包含专门的 Linux.do OAuth 集成和社区功能。
配置 Linux.do OAuth
- 登录 Linux.do
- 访问用户设置 → 应用程序
- 创建新的 OAuth 应用:
- 应用名称:
Snapifit AI - 回调 URL:
https://your-app-name.vercel.app/api/auth/callback/discourse - 权限: 读取用户信息
- 应用名称:
- 记录 Client ID 和 Client Secret
部署到 Vercel
- 访问 Vercel Dashboard
- 点击 New Project 按钮
- 选择您 Fork 的
snapifit-ai-lzhan仓库 - 点击 Import 按钮
第二步:配置服务和环境
设置 Supabase 数据库
- 登录 Supabase Dashboard
- 创建新项目:
- Name:
snapifit-ai-lzhan - Database Password: 设置强密码
- Region: 选择合适区域
- Name:
- 等待项目创建完成
- 记录项目 URL 和 API Key
配置环境变量
在 Vercel 项目设置中添加以下环境变量:
# 应用基础配置
NEXTAUTH_URL=https://your-app-name.vercel.app
NEXTAUTH_SECRET=your-random-secret-key
# Linux.do OAuth 配置
DISCOURSE_CLIENT_ID=your-discourse-client-id
DISCOURSE_CLIENT_SECRET=your-discourse-client-secret
DISCOURSE_BASE_URL=https://linux.do
# 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...
# L站特殊配置
LZHAN_COMMUNITY_MODE=true
ENABLE_DISCOURSE_AUTH=true完成部署
- 在 Vercel 中点击 Deploy 按钮
- 等待部署完成
- 访问应用链接进行测试
🔧 L站版特殊功能
社区集成功能
- Linux.do 登录: 直接使用 L站账户登录
- 社区等级显示: 显示用户在 L站的等级和徽章
- 社区数据同步: 可选择同步 L站的部分公开信息
- 社区分享: 支持将健康成果分享到 L站
专属功能
- 社区排行榜: L站用户健康数据排行(匿名)
- 社区挑战: 定期的健康挑战活动
- 专属主题: L站风格的界面主题
- 社区支持: 优先的技术支持和功能建议
✅ 部署验证
部署完成后,请验证以下功能:
- 应用可以正常访问
- Linux.do 登录功能正常
- 用户信息正确同步
- AI 对话功能正常
- 社区功能正常显示
- 数据记录和保存功能正常
🔧 常见问题
Linux.do 登录失败?
- 检查 OAuth 应用配置是否正确
- 确认回调 URL 设置正确
- 验证 Client ID 和 Secret 是否正确
- 检查 Linux.do 账户状态
社区功能不显示?
- 确认
LZHAN_COMMUNITY_MODE=true已设置 - 检查
ENABLE_DISCOURSE_AUTH=true已配置 - 验证用户已通过 Linux.do 登录
- 查看浏览器控制台错误信息
如何更新应用?
L站版本会定期同步主版本的更新:
- 关注 GitHub 仓库的更新通知
- 在您的 Fork 中同步上游更改
- Vercel 会自动重新部署
🎁 L站用户专属福利
作为 Linux.do 社区用户,您享有:
- 免费使用: 完全免费,无任何限制
- 优先支持: 技术问题优先响应
- 功能建议: 优先考虑功能需求
- 社区活动: 参与专属的健康挑战
- 开源贡献: 欢迎贡献代码和想法
📞 获取支持
L站用户专属支持渠道:
- Linux.do 专属讨论区 - 社区讨论
- GitHub Issues - 技术问题
- L站私信 @Feather-2 - 直接联系开发者
🎉
欢迎加入 Snapifit AI L站社区!让我们一起建设更健康的开源社区!
🔗 相关链接
- Linux.do 社区 - 回到社区首页
- 用户指南 - 了解如何使用 Snapifit AI
- 社区功能说明 - L站专属功能介绍
- Apache 2.0 协议 - 了解协议详情
Last updated on