root
2336a2bd30
- Use environment variables for Dify API key/URL - Add host.docker.internal support in docker-compose - Add DATABASE_URL env and prisma db push to Dockerfile - Clean up test/requirement files and add deployment docs
104 lines
1.6 KiB
Markdown
104 lines
1.6 KiB
Markdown
# NextApp 本地启动说明
|
|
|
|
## 环境要求
|
|
|
|
- Node.js 18.x 或更高版本
|
|
- npm（随 Node.js 一同安装）
|
|
|
|
---
|
|
|
|
## 启动步骤
|
|
|
|
### 1. 安装依赖
|
|
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
### 2. 配置环境变量
|
|
|
|
项目已提供 `.env` 文件，内容如下（通常无需修改）：
|
|
|
|
```
|
|
DATABASE_URL="file:./dev.db"
|
|
NEXTAUTH_SECRET="nextapp-secret-key-2026"
|
|
NEXTAUTH_URL="http://localhost:3000"
|
|
```
|
|
|
|
### 3. 生成 Prisma 客户端
|
|
|
|
```bash
|
|
npx prisma generate
|
|
```
|
|
|
|
### 4. 初始化数据库
|
|
|
|
```bash
|
|
npx prisma migrate dev
|
|
```
|
|
|
|
### 5. 启动开发服务器
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
终端出现 `▲ Next.js x.x.x` 及 `Local: http://localhost:3000` 即为启动成功。
|
|
|
|
### 6. 初始化种子数据（可选）
|
|
|
|
浏览器访问 **http://localhost:3000/api/seed**，或执行：
|
|
|
|
```bash
|
|
curl http://localhost:3000/api/seed
|
|
```
|
|
|
|
---
|
|
|
|
## 常用命令
|
|
|
|
| 命令 | 说明 |
|
|
|------|------|
|
|
| `npm run dev` | 启动开发服务器（热重载） |
|
|
| `npm run build` | 构建生产版本 |
|
|
| `npm run start` | 启动生产服务器 |
|
|
| `npm run lint` | 代码检查 |
|
|
| `npx prisma studio` | 打开数据库可视化工具 |
|
|
| `npx prisma migrate dev --name <描述>` | 创建新数据库迁移 |
|
|
|
|
---
|
|
|
|
## 访问地址
|
|
|
|
- 开发环境：**http://localhost:3000**
|
|
- 端口被占用时，可指定其他端口：`npm run dev -- -p 3001`
|
|
|
|
---
|
|
|
|
## 常见问题
|
|
|
|
### Prisma 客户端未生成
|
|
|
|
```bash
|
|
npx prisma generate
|
|
```
|
|
|
|
### 数据库迁移未执行
|
|
|
|
```bash
|
|
npx prisma migrate dev
|
|
```
|
|
|
|
### 重置数据库
|
|
|
|
```bash
|
|
npx prisma migrate reset
|
|
```
|
|
|
|
### 清除缓存
|
|
|
|
```bash
|
|
rm -rf .next node_modules/.cache
|
|
npm run dev
|
|
```
|