diff --git a/README.md b/README.md index 1808fec..37799c4 100644 --- a/README.md +++ b/README.md @@ -67,6 +67,26 @@ DEMO_MOCK=0 Mock 模式下可将任一素材 URL 写成包含 `reject` 的地址,验证单张驳回、失败原因和视频生成锁定状态。 +## 线上部署交接 + +本项目没有第三方 npm 运行依赖,服务器安装 Node.js 20 或更高版本后即可启动: + +```bash +cp .env.example .env.local +npm start +``` + +上线前请完成以下配置: + +1. 在服务端填写 `KK_API_KEY`,并设置 `DEMO_MOCK=0`;不要把 `.env.local` 提交到 Git。 +2. 设置 `HOST=0.0.0.0` 和实际监听端口,由 Nginx/网关反向代理并提供 HTTPS。 +3. 将 `AUDIT_LOG_DIR` 指向持久化磁盘,设置随机的 `AUDIT_HASH_SALT`,同时配置日志轮转与清理周期。 +4. 使用 systemd、PM2 或容器编排守护 Node 进程,异常退出后自动重启。 +5. 在入口层增加客户访问鉴权、请求频率限制与并发生成限制;服务商 Key 仅保留在服务端。 +6. 发布后访问 `/api/config` 检查 `mockMode=false`、素材与视频能力均为可用,再分别跑一条素材审核和视频生成链路。 + +当前素材审核任务状态保存在单进程内存中,首次客户交付建议只运行一个应用实例。若需要多实例扩容,应先把任务状态迁移到 Redis 或数据库。 + ## 当前还缺的真实联调材料 - **快快 AI Hub 统一 Key**:形如 `sk-...`,同时用于新版素材库与 Seedance 2.0。