Chatbot 部署实战3 条命令跑通本地到生产【免费下载链接】chatbotA full-featured, hackable Next.js AI chatbot built by Vercel项目地址: https://gitcode.com/GitHub_Trending/ai/chatbot本文以 Vercel 开源的 Chatbot 模板为例拆解 Next.js AI 聊天机器人的部署闭环5 个环境变量配齐、1 次构建自动迁移、托管与自托管两条路线。适合需要快速上线生产级 AI 聊天应用的开发者。项目定位为什么选它Chatbot 是一个基于 Next.js 与 AI SDK 的全功能聊天机器人模板覆盖多模态输入、文档产物Artifact、用户认证与历史记录持久化可作为企业级 AI 聊天应用的起点。Next.js App Router React Server Components路由与服务端渲染开箱即用app/AI SDK 统一 API 调用文本、结构化输出与工具调用经 AI Gateway 接入多模型厂商lib/ai/models.tsshadcn/ui Tailwind CSS Radix UI 组件体系可主题化改造components/Drizzle ORM 持久化 User、Chat、Message_v2 等 6 张表迁移脚本内建lib/db/schema.tsAuth.js 认证含访客guest登录通道app/(auth)//)本地快速跑通全部 4 条命令按顺序执行即可应用会跑在http://localhost:3000git clone https://gitcode.com/GitHub_Trending/ai/chatbot cd chatbot pnpm install cp .env.example .env.local # 按表格填写后 pnpm db:migrate pnpm dev环境变量对照 .env.example 填写变量作用是否必需AUTH_SECRET认证签名密钥可用openssl rand -base64 32生成必需AI_GATEWAY_API_KEYAI Gateway 模型调用密钥Vercel 部署走 OIDC 可免配非 Vercel 部署必需BLOB_READ_WRITE_TOKENBlob 存储令牌承载上传文件与图片必需POSTGRES_URLPostgres 连接串存用户与聊天记录必需REDIS_URLRedis 连接串生产环境 IP 限流依赖它可选生产建议配生产化改造清单迁移并入构建package.json的 build 脚本是tsx lib/db/migrate next build即每次pnpm build前先执行数据库迁移SQL 见 lib/db/migrations/无需单独迁移步骤。构建与启动本地验证生产形态用一条命令构建产物由next start托管pnpm build pnpm start限流依赖 Redis生产模式下每 IP 每小时限 10 条消息lib/ratelimit.ts不配REDIS_URL时限流静默失效上线前确认连接串已注入。演示模式next.config.ts 支持IS_DEMO1环境变量将应用挂载到/demo路径并改写静态资源前缀适合与主站共用一台服务器时灰度发布。部署路线怎么选两条路线的差异集中在外部服务的提供方上维度Vercel 托管自托管Postgres / Blob / Redis平台内建服务控制台勾选即可自备实例填 4 个连接串模型调用鉴权OIDC 自动签发免配 API Key必须配AI_GATEWAY_API_KEYSSL 与 CDN自动签发Nginx 反代 证书自管数据库迁移随部署自动执行由pnpm build内建步骤覆盖成本免费额度 按量计费固定服务器成本可长期压低成本 自托管场景用进程管理器拉起一条命令即可假设已构建完成npx pm2 start npm --name chatbot -- start上线之后盯什么指标观测位置参考线流式接口首响应时延/api/chat/stream端点app/(chat)/api/chat//api/chat/)P95 低于 3sPostgres 连接数数据库监控不超过连接池上限的 80%模型调用成功率AI Gateway 用量面板高于 99%进程内存系统监控无持续增长曲线优化按优先级执行把热点会话与用户数据读路径放进 Redis复用REDIS_URL同一实例。检查聊天历史查询的索引覆盖Message_v2的parts/attachments为 JSON 大字段量级上来后考虑拆分列。按场景路由模型档位简单追问走小模型复杂任务走大模型配置集中在 lib/ai/models.ts。应用实例与数据库分开扩容流式长连接吃并发而非 CPU。排障速查登录后仍被跳回登录页检查AUTH_SECRET是否配置多实例部署时是否一致。生产环境 Cookie 走 secure 模式见 proxy.ts确认已启用 HTTPS。访客邮箱guest与正式账号混用会触发重定向循环清空 Cookie 重试。模型调用 401 或超时非 Vercel 部署确认AI_GATEWAY_API_KEY有效且未过期。核对该模型在 lib/ai/models.ts 中的厂商路由是否写对。排除出口网络问题curl目标厂商端点看连通性。迁移执行了但表缺失POSTGRES_URL为空时 lib/db/migrate.ts 会打印提示后直接退出属于静默跳过。确认连接串注入到了构建/运行环境而非只写在本地.env.local。重跑pnpm build观察 Migrations completed 输出即可验证。以上即 Chatbot 从本地到生产的最小闭环5 个环境变量、1 次内建迁移、2 条部署路线任选。更多细节见 README.md 与 lib/ 下各模块源码。【免费下载链接】chatbotA full-featured, hackable Next.js AI chatbot built by Vercel项目地址: https://gitcode.com/GitHub_Trending/ai/chatbot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
