feat(config): 添加 Node.js 堆内存配置和代理路径规范化

- 在 .env.sample 中新增 NODE_MAX_OLD_SPACE_SIZE 配置项，默认设置为 8192 MiB - 在 docker-compose.yml 中添加 NODE_OPTIONS 环境变量配置 - 在 easyai-proxy.conf.sample 中添加 /api 路径规范化重定向规则 - 修改 https.sh 脚本优先使用完整代理模板生成配置文件 - 更新 README.md 添加新版本发布说明 - 扩展测试脚本验证代理配置和路径重定向功能
2026-07-24 22:10:45 +08:00
parent 6ee9666b0c
commit f31e349409
6 changed files with 40 additions and 0 deletions
@@ -209,6 +209,11 @@ $env:UPDATE_NO_WAIT = "1"
 2. **新装与升级迁移**：Linux/macOS 和 Windows 启动、升级脚本会在重建服务前初始化并校验公开 API 地址，支持 IP 自定义 `SERVER_HTTP_PORT`、HTTP/HTTPS 域名和 `DEPLOY_PUBLIC_API_BASE_URL` 高级覆盖。
 3. **代理端口透传**：新 Nginx 模板为 `/api/`、`/mcp` 补齐公开 Host/Port Header；已有生成配置不会自动改写。

+### 2026.07.15
+
+1. **主服务 Node.js 堆内存上限**：`easyai-server` 默认通过 `NODE_OPTIONS` 将 V8 old-space 堆上限设置为 8192 MiB，可在 `.env` 中使用 `NODE_MAX_OLD_SPACE_SIZE` 覆盖。该值只限制 V8 堆，不包含 Buffer、sharp/libvips 等 native 内存。
+2. **生效要求**：该参数仅在创建 Node.js 进程时读取，更新部署文件后需要在合适的维护窗口重建 `easyai-server` 容器。
+
 ### 2026.06.24

 1. **主服务 sharp/native 内存护栏**：`easyai-server` 默认关闭 sharp/libvips cache，并将 sharp 并发限制为 1；同时设置 `MALLOC_ARENA_MAX=2`、`MALLOC_TRIM_THRESHOLD_=131072`、`MALLOC_MMAP_THRESHOLD_=131072`、`MALLOC_TOP_PAD_=131072`，降低图片处理和大 Buffer 场景下 native RSS 持续膨胀风险。