Files
ai-portal/本地启动说明.md
root 2336a2bd30 feat: improve Docker deployment and Dify API configuration
- 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
2026-05-09 16:05:23 +08:00

1.6 KiB

NextApp 本地启动说明

环境要求

  • Node.js 18.x 或更高版本
  • npm(随 Node.js 一同安装)

启动步骤

1. 安装依赖

npm install

2. 配置环境变量

项目已提供 .env 文件,内容如下(通常无需修改):

DATABASE_URL="file:./dev.db"
NEXTAUTH_SECRET="nextapp-secret-key-2026"
NEXTAUTH_URL="http://localhost:3000"

3. 生成 Prisma 客户端

npx prisma generate

4. 初始化数据库

npx prisma migrate dev

5. 启动开发服务器

npm run dev

终端出现 ▲ Next.js x.x.xLocal: http://localhost:3000 即为启动成功。

6. 初始化种子数据(可选)

浏览器访问 http://localhost:3000/api/seed,或执行:

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 客户端未生成

npx prisma generate

数据库迁移未执行

npx prisma migrate dev

重置数据库

npx prisma migrate reset

清除缓存

rm -rf .next node_modules/.cache
npm run dev