flnxi-Wu/docs/guides/SETUP.md
WuYongJie f646b71813
Some checks failed
CI Check / check (push) Has been cancelled
chore: 初始化本地仓库并同步最近改动
2025-11-18 17:50:16 +08:00

119 lines
2.2 KiB
Markdown
Raw 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.

# 快速部署指南
## 一、安装依赖
在项目根目录运行:
```bash
npm install
```
## 二、配置环境变量
创建 `.env.local` 文件(已经创建好了,检查内容):
```bash
cat .env.local
```
确保包含以下配置:
- PostgreSQL 数据库连接
- NextAuth 密钥
- MinIO S3 配置
## 三、初始化数据库
```bash
# 1. 生成 Prisma Client
npm run prisma:generate
# 2. 推送数据库模式(创建表)
npm run prisma:push
```
## 四、创建管理员账号
### 方法1: 使用 Prisma Studio(推荐)
```bash
# 打开 Prisma Studio
npm run prisma:studio
```
在浏览器中打开 http://localhost:5555,然后:
1. 先注册一个普通用户(通过网站 http://localhost:3000/register)
2. 在 Prisma Studio 中找到该用户
3. 将 `role` 字段改为 `ADMIN`
### 方法2: 使用 SQL
```bash
# 连接到 PostgreSQL
psql postgresql://postgres:FastBuildAI2025SecureDB@149.88.95.87:5432/lobechat
```
注册账号后运行:
```sql
UPDATE users SET role = 'ADMIN' WHERE email = 'your@email.com';
```
## 五、启动开发服务器
```bash
npm run dev
```
访问: http://localhost:3000
## 六、生产部署
```bash
# 构建
npm run build
# 启动
npm start
```
## 功能说明
### 普通用户功能
- ✅ 注册/登录
- ✅ 上传素材(预览图上传到 S3,压缩包存储在本地 uploads 目录)
- ✅ 浏览素材
- ✅ 下载素材
### 管理员功能
- ✅ 所有普通用户功能
- ✅ 系统设置入口(在顶部导航栏)
- ✅ 素材管理(查看、删除)
- ✅ 用户管理(查看、删除)
## 文件存储说明
- **预览图**: 存储在 MinIO S3 (jsxiangche bucket, 由壹点AI/ 路径)
- **压缩包**: 存储在本地 `uploads/` 目录
## 常见问题
### Q: 数据库连接失败
A: 检查 `.env.local` 中的 `DATABASE_URL` 是否正确
### Q: S3 上传失败
A: 检查 S3 配置(endpoint, access key, secret key)是否正确
### Q: 无法看到管理员菜单
A: 确保你的账号 role 已设置为 ADMIN
### Q: 上传大文件失败
A: Next.js 默认限制为 100MB,已在 next.config.js 中配置
## 技术支持
如有问题,请检查:
1. Node.js 版本 >= 18
2. PostgreSQL 数据库可访问
3. MinIO S3 服务可访问
4. 环境变量配置正确