This commit is contained in:
freedakgmail
2025-11-24 08:11:15 +08:00
parent bec270c9af
commit b7a8c9ee6e
674 changed files with 7042 additions and 278 deletions
+29
View File
@@ -69,6 +69,27 @@ pnpm build
pnpm start
```
### 生产部署
详细的部署指南请参考:
- [DEPLOY_GUIDE.md](./DEPLOY_GUIDE.md) - 完整部署指南
- [DEPLOY_QUICK_START.md](./DEPLOY_QUICK_START.md) - 快速部署
### 常见问题
#### 重定向循环问题 (ERR_TOO_MANY_REDIRECTS)
如果遇到重定向循环错误:
1. 检查 `NEXTAUTH_URL` 是否与实际访问URL一致
2. 使用修复脚本: `./fix-redirect-loop.sh`
3. 详细说明: [问题修复总结.md](./问题修复总结.md)
#### 其他问题
- 查看应用日志: `pm2 logs chinese-family-tree`
- 检查数据库连接: `npx prisma db pull`
- 参考 [DEPLOY_GUIDE.md](./DEPLOY_GUIDE.md) 的故障排查章节
## 环境变量
创建 `.env` 文件并配置以下变量:
@@ -78,7 +99,13 @@ pnpm start
DATABASE_URL="postgresql://user:password@localhost:5432/family_tree"
# NextAuth
# ⚠️ 重要: NEXTAUTH_URL 必须与实际访问URL完全一致
# 开发环境:
NEXTAUTH_URL="http://localhost:3000"
# 生产环境示例:
# NEXTAUTH_URL="http://your-server-ip:port"
# NEXTAUTH_URL="https://your-domain.com"
NEXTAUTH_SECRET="your-secret-key-here"
# 邮箱服务器配置(用于发送邀请邮件)
@@ -93,6 +120,8 @@ SMTP_FROM="中华家谱 <cftservice@163.com>"
# GOOGLE_CLIENT_SECRET=""
```
> **⚠️ 重要提示**: 如果 `NEXTAUTH_URL` 配置错误,会导致重定向循环问题 (ERR_TOO_MANY_REDIRECTS)。详见 [问题修复总结.md](./问题修复总结.md)
## 项目结构
```