Files
project-4fc4fbec-cc72-4730-…/DEPLOYMENT_GUIDE.md
2026-01-01 09:09:44 +00:00

122 lines
2.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Vercel部署指南
## 快速部署步骤
### 方法一通过Vercel CLI推荐
1. **安装Vercel CLI**
```bash
npm i -g vercel
```
2. **登录Vercel**
```bash
vercel login
```
3. **在项目目录中部署**
```bash
cd ai-chat-nextjs
vercel
```
4. **按照提示操作**
- 选择账户/团队
- 确认项目名称
- 确认项目设置
### 方法二通过GitHub集成推荐
1. **访问 [Vercel Dashboard](https://vercel.com/dashboard)**
2. **点击 "New Project"**
3. **导入GitHub仓库**
- 选择 `https://github.com/EagleFandel/test.git`
- 选择 `ai-chat-nextjs` 目录作为根目录
4. **配置项目设置**
- **Framework Preset**: Next.js
- **Root Directory**: `ai-chat-nextjs`
- **Build Command**: `npm run build`
- **Output Directory**: `.next`
## 环境变量配置
在Vercel Dashboard中配置以下环境变量
### 必需的环境变量:
```
INFINI_AI_API_KEY=your_actual_api_key_here
INFINI_AI_BASE_URL=https://cloud.infini-ai.com/maas/v1
INFINI_AI_MODEL=deepseek-v3.2-exp
```
### 可选的环境变量:
```
NEXT_PUBLIC_APP_NAME=AI聊天助手
NEXT_PUBLIC_APP_VERSION=1.0.0
NODE_ENV=production
```
## 部署配置优化
项目已包含优化的 `vercel.json` 配置:
```json
{
"functions": {
"src/app/api/*/route.ts": {
"maxDuration": 30
}
},
"rewrites": [
{
"source": "/api/:path*",
"destination": "/api/:path*"
}
]
}
```
## 部署后验证
1. **检查部署状态**访问Vercel提供的部署URL
2. **测试聊天功能**:发送测试消息
3. **检查API端点**:访问 `https://your-app.vercel.app/api/chat`
4. **查看日志**在Vercel Dashboard中查看函数日志
## 常见问题解决
### 1. API密钥错误
- 确保在Vercel Dashboard中正确设置了 `INFINI_AI_API_KEY`
- 检查API密钥是否有效
### 2. 构建失败
- 检查依赖是否正确安装
- 查看构建日志中的错误信息
### 3. API超时
- 检查 `vercel.json` 中的 `maxDuration` 设置
- 考虑优化API调用逻辑
### 4. 环境变量不生效
- 确保环境变量名称正确
- 重新部署以应用新的环境变量
## 自动部署
配置完成后每次推送到GitHub的main分支都会自动触发Vercel部署。
## 监控和日志
- **实时日志**Vercel Dashboard > Functions > View Function Logs
- **分析数据**Vercel Dashboard > Analytics
- **性能监控**Vercel Dashboard > Speed Insights
## 域名配置(可选)
1. 在Vercel Dashboard中点击项目
2. 进入 "Settings" > "Domains"
3. 添加自定义域名
4. 按照提示配置DNS记录