Crest v1.5.7
Crest v1.5.7 发布说明
发布日期:2026-06-10
Crest v1.5.7 是 v1.5 系列维护版本。本版本新增 MySQL 数据源的数据集缓存能力,并修复公开分享链接、API 数据源 JsonPath 解析和数据源本地校验等问题。已有 v1.5.6 环境升级时,只需替换前后端镜像,不需要执行新增升级 SQL。
发布附件
crest-offline-v1.5.7-linux-amd64.tar.gz
crest-offline-v1.5.7-linux-arm64.tar.gz
crest-app-images-v1.5.7-linux-amd64.tar.gz
crest-app-images-v1.5.7-linux-arm64.tar.gz
crest-source-v1.5.7.tar.gz
crest-v1.5.7-checksums.txt
crest-app-images-v1.5.7-checksums.txt
GitHub 发布页面会自动提供 Source code (zip) 和 Source code (tar.gz)。crest-source-v1.5.7.tar.gz 是发布流程生成的命名源码包,用于归档和交付。
镜像
镜像标签:
ghcr.io/sevoniva/crest-service:v1.5.7
ghcr.io/sevoniva/crest-service:main
ghcr.io/sevoniva/crest-web:v1.5.7
ghcr.io/sevoniva/crest-web:main
支持架构:
linux/amd64
linux/arm64
离线包
crest-offline-* 是完整离线安装包,包含安装脚本、配置模板、Docker Compose 文件、Crest 后端镜像、Crest 前端镜像、MySQL 镜像、Prometheus/Grafana 配置、升级 SQL 和离线安装说明。启用 INCLUDE_OBSERVABILITY_IMAGES=true 制作的离线包还会包含 Prometheus 和 Grafana 镜像。
crest-app-images-* 是应用镜像升级包,仅包含 Crest 后端镜像、Crest 前端镜像、增量升级 SQL 和加载说明,不包含 MySQL、Prometheus、Grafana 镜像,也不包含完整安装脚本。已有环境只需要替换前后端应用服务时,可使用该包。
本版本没有数据库结构、系统参数或初始化数据变更,不新增升级 SQL。已有 v1.5.6 环境升级到 v1.5.7 时,请先备份元数据库和运行目录,再替换前后端镜像。
从 v1.5.4 升级到 v1.5.7 时,请按顺序执行:
upgrade-sql/v1.5.4_to_v1.5.5.sql
执行完 v1.5.4 到 v1.5.5 的升级 SQL 后,再替换 v1.5.7 前后端镜像。
新增功能
- MySQL 数据源支持数据集缓存。数据集可配置为直连读取或缓存读取,缓存表由系统同步维护。
- 数据集缓存支持全量更新、增量更新、手动更新和定时更新。
- 数据集缓存记录最近执行状态、缓存可用状态、源数据行数、缓存行数和一致性校验结果。
- 数据大屏通过数据集取数时,可使用数据集缓存结果。
- 增量缓存支持增量字段水位记录;切换增量字段或更新类型时,系统清理旧水位,后续同步按新配置执行。
修复与调整
- 修复已登录后台用户访问
/link/:uuid公开分享链接时被重定向到工作台的问题。登录态和未登录态访问同一分享链接时均进入分享展示页。 - 登录态下,公开分享、预览等只读路由按只读访问策略处理;工作台、数据源、数据集等后台路由继续执行菜单权限校验。
- 数据集缓存点击“立即更新”时,系统先保存当前数据集和缓存配置,再提交同步任务。
- 数据集缓存状态文案调整为“源数据与缓存一致”“数据一致性校验失败”等明确状态。
- 修复 API 数据源使用 JsonPath 时仍按完整响应解析数据结构的问题。
$data.dataList可按行解析子节点字段。 - API 数据源请求头配置补充标准
Authorization项。 - API 数据源启用 JsonPath 后,字段选择保持可编辑。
- 修复数据源详情页对 19 位雪花 ID 调用
Number(...)导致精度丢失的问题;数据源详情、校验、编辑等接口使用原始字符串 ID。 - 修复数据源详情页校验在异常节点或旧状态下可能返回“系统内部错误”的问题。缺失数据源时返回明确提示。
- MySQL 数据源查询时动态注册 Calcite schema,避免数据集、缓存或预览使用新建数据源时找不到 schema。
升级说明
- 全新安装不需要执行
upgrade-sql/中的 SQL。 - v1.5.6 升级到 v1.5.7 时不需要执行新增升级 SQL。
- v1.5.4 升级到 v1.5.7 时,请先执行
upgrade-sql/v1.5.4_to_v1.5.5.sql,再替换 v1.5.7 前后端镜像。 - 生产环境升级前请备份元数据库和运行目录。
验证范围
本版本已完成以下验证:
- 已登录后台用户访问
/link/:uuid分享链接的路由策略测试; - 后台工作台路径继续进入菜单权限校验的路由策略测试;
- API 数据源 Authorization 请求头、JsonPath
$data.dataList、嵌套字段解析和字段选择回归测试; - 数据源雪花 ID 字符串传参回归测试;
- 数据集缓存保存、立即更新、定时任务状态和状态文案回归测试;
- 数据源详情页校验和 API 数据源请求头联调验证;
- 后端 API 数据源、数据集缓存和数据源校验相关单元测试;
- 版本号、发布说明和 README 检查。