admin
7c6449b7bd
- Change the API default listen port from 3000 to 3100 and include the Docker frontend origin in default CORS. - Point Vite's default API proxy, Docker API container port, and Nginx upstream to 3100. - Keep Docker host ports on 4002 for web, 3002 for API, and 5433 for PostgreSQL. - Update environment examples and documentation to remove stale localhost:3000 guidance.
2.8 KiB
2.8 KiB
部署运行
本地开发
前端：
npm install
npm run dev
开发服务监听 0.0.0.0:3001。
开发模式下 Vite 会把 /api 代理到 VITE_API_PROXY_TARGET，默认 http://localhost:3100。
后端：
cp .env.example .env
npm run prisma:generate
npm run server:dev
本地直接运行 API 默认监听 0.0.0.0:3100，健康检查为：
http://localhost:3100/api/health
如需连接真实 PostgreSQL：
npm run prisma:migrate
npm run prisma:seed
质量检查
npm run lint
npm run test
npm run server:build
npm run build
当前 lint 实际执行 tsc --noEmit，用于 TypeScript 类型检查。
环境变量
复制示例文件：
cp .env.example .env.local
AI 和语音密钥由后端 Settings API 保存并由代理使用，前端不再注入 Gemini 旧环境变量。
后端新增变量：
API_PORT：API 监听端口。本地直接运行默认3100；Docker Compose 暴露到宿主机的默认端口是3002。CORS_ORIGIN：允许跨域携带 Cookie 的前端来源。DATABASE_URL：PostgreSQL 连接串。Docker Compose 暴露到宿主机的默认端口是5433，容器内部仍使用db:5432。SESSION_SECRET：Session Cookie 签名密钥。SESSION_COOKIE_SECURE：是否只通过 HTTPS 发送 Session Cookie。本地 HTTP/Compose 默认false，生产 HTTPS 应设为true。FILE_STORAGE_DIR：后端文件目录。Docker Compose 默认/app/uploads，并挂载到uploads_datavolume。VITE_API_PROXY_TARGET：前端开发服务器/api代理目标。直接运行后端用http://localhost:3100；连接 Docker Compose API 用http://localhost:3002。VITE_ENABLE_LOCAL_FALLBACK：生产构建是否允许本地兼容回退。开发模式默认启用，生产默认关闭。
Docker 部署
docker-compose up -d --build
默认通过 Nginx 暴露 http://localhost:4002。
当前 Compose 服务：
web：前端静态站点，暴露http://localhost:4002。api：NestJS API，暴露http://localhost:3002。db：PostgreSQL 16，暴露localhost:5433。uploads_data：后端文件持久化 volume。
构建流程：
Dockerfile使用 Node 构建dist/。- 运行阶段使用
nginx:alpine托管静态文件。 Dockerfile.server构建并运行 NestJS API。nginx.conf已配置 SPA 路由回退和/api反向代理。
部署边界
当前后端已承载登录认证、数据库 Session、Dashboard、报告、报告媒体关系、模板、字段库、通用文件/签名文件、视频/关键帧文件、用户管理、部门模板授权、系统设置、AI 代理、语音代理、HTML 清洗和审计日志查询。生产化前还需要补齐第三方代理调用摘要、限流、备份恢复、对象存储和更完整的旧数据迁移。