10 Jun 14:46

db0aefb

Crest v1.5.7 Latest

Latest

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 检查。

Assets 9

10 Jun 06:55

github-actions

v1.5.6

8c4813d

Crest v1.5.6

Crest v1.5.6 发布说明

发布日期：2026-06-10

Crest v1.5.6 是 v1.5 系列的数据大屏资源权限补丁版本。此版本修复后台数据大屏和仪表盘资源树中只读资源错误展示复制等管理入口、授权管理者复制资源被拦截、复制请求状态字段不兼容、数据集导出失败缺少提示、明细表合并单元格不可按需选择，以及本地开发端口变化后登录被 CORS 拦截的问题。

建议已经升级到 v1.5.5，且使用数据大屏、仪表盘后台资源树或业务资源授权管理的环境升级到 v1.5.6。已有 v1.5.5 环境升级时只需替换前后端镜像，不需要执行新增升级 SQL。

Release 附件

crest-offline-v1.5.6-linux-amd64.tar.gz
crest-offline-v1.5.6-linux-arm64.tar.gz
crest-app-images-v1.5.6-linux-amd64.tar.gz
crest-app-images-v1.5.6-linux-arm64.tar.gz
crest-source-v1.5.6.tar.gz
crest-v1.5.6-checksums.txt
crest-app-images-v1.5.6-checksums.txt

GitHub Release 页面仍会自动提供 Source code (zip) 和 Source code (tar.gz)。crest-source-v1.5.6.tar.gz 是本次发布流程额外生成的命名源码包，便于内网归档和交付。

镜像

镜像标签：

ghcr.io/sevoniva/crest-service:v1.5.6
ghcr.io/sevoniva/crest-service:main
ghcr.io/sevoniva/crest-web:v1.5.6
ghcr.io/sevoniva/crest-web:main

支持架构：

linux/amd64
linux/arm64

离线包

crest-app-images-* 是应用镜像升级包，仅包含 Crest 后端镜像、Crest 前端镜像、增量升级 SQL 和加载说明，不包含 MySQL、Prometheus、Grafana 镜像，也不包含完整安装脚本。已有内网环境只需要替换前后端应用服务时，可使用该包降低传输体积。

本版本没有数据库结构、系统参数或初始化数据变更，不新增升级 SQL。已有 v1.5.5 环境升级到 v1.5.6 时，请先备份元数据库和运行目录，再替换前后端镜像。

从 v1.5.4 升级到 v1.5.6 时，请按顺序执行：

upgrade-sql/v1.5.4_to_v1.5.5.sql

执行完 v1.5.4 到 v1.5.5 的升级 SQL 后，再替换 v1.5.6 前后端镜像。

修复内容

修复数据大屏和仪表盘资源树将只读可见资源按可管理资源返回的问题。后端现在会按创建人、系统管理员、组织管理员、用户/组织/角色资源授权计算节点权重，前端据此隐藏只读资源的复制、移动、重命名和删除操作。
修复非创建人但已获得资源管理权限时复制数据大屏或仪表盘会被服务端创建人校验拦截的问题。复制接口改为复用资源管理权限判断，只读用户仍不可复制，管理授权用户可正常复制。
修复资源树复制数据大屏或仪表盘时，前端携带布尔型发布状态导致后端参数解析失败，页面提示“系统内部错误，请联系管理员”的问题。后端现在兼容布尔型和数字型发布状态。
修复本地开发模式登录后 WebSocket 代理地址解析异常导致页面白屏的问题。
修复数据集导出请求被取消、后端返回 JSON 错误或异常响应时，前端仍可能关闭弹窗且不给出明确失败反馈的问题。确认按钮在导出请求处理中会禁用，避免重复点击造成并发状态混乱。
明细表支持按字段选择需要合并的列。开启“合并单元格”后，可在“合并字段”中选择当前明细表第一个指标字段之前的维度字段；指标字段不参与合并。
合并规则调整为可预期的纵向合并：只合并上下相邻且值相同的单元格；选择后置维度时，会在前置维度相同的范围内合并，避免不同上级分类下的同名值被合到一起。
清空“合并字段”表示不合并任何字段；历史图表未保存合并字段时，仍沿用原来的默认合并规则，避免升级后展示变化。
修复快速增删合并字段时页面卡顿、不同上级分类下的同名值被合并、序号列跟随自定义字段合并后展示混乱的问题。
统一 /login 登录入口。本地账号和管理员应急登录都从该入口进入；旧 token 损坏或过期时，会清理登录态并回到登录页。
修复本地开发模式下 Vite 端口从 8080 切换到 8081 等端口后，登录请求被后端 CORS 拦截并返回 403 的问题。

升级说明

全新安装不需要执行 upgrade-sql/ 中的 SQL。
v1.5.5 升级到 v1.5.6 时不需要执行新增升级 SQL。
v1.5.4 升级到 v1.5.6 时，请先执行 upgrade-sql/v1.5.4_to_v1.5.5.sql，再替换 v1.5.6 前后端镜像。
生产环境升级前仍建议备份元数据库和运行目录。

验证范围

本版本发布前执行以下检查：

数据大屏和仪表盘资源树权限权重测试；
非创建人但具备管理授权时复制数据大屏的服务端测试；
复制请求兼容布尔型发布状态的 JSON 解析测试；
本地开发模式登录后页面渲染和 WebSocket 初始化验证；
数据集导出响应解析、取消请求和 JSON 错误提示测试；
明细表合并单元格字段候选范围、上级分组边界、清空字段和配置保存测试；
统一登录入口、旧 token 恢复和本地开发代理 CORS 验证；
后端 Maven 单元测试；
版本号、发布说明和 README 检查。

Assets 9

06 Jun 14:40

github-actions

v1.5.5

d1d96cc

Crest v1.5.5

Crest v1.5.5 发布说明

发布日期：2026-06-06

Crest v1.5.5 是面向数据门户和可视化交付场景的功能修复版本。此版本提供独立数据门户，支持普通用户在授权范围内访问已发布资源，并交付数据大屏筛选导出、表格表头说明、账号默认密码管理和离线升级 SQL。

建议使用数据门户、普通用户只读访问、数据大屏导出、后台用户管理或内网离线交付的环境升级到 v1.5.5。已有 v1.5.4 环境升级时，请同时替换前后端镜像并执行离线包内的升级 SQL。

Release 附件

crest-offline-v1.5.5-linux-amd64.tar.gz
crest-offline-v1.5.5-linux-arm64.tar.gz
crest-app-images-v1.5.5-linux-amd64.tar.gz
crest-app-images-v1.5.5-linux-arm64.tar.gz
crest-source-v1.5.5.tar.gz
crest-v1.5.5-checksums.txt
crest-app-images-v1.5.5-checksums.txt

GitHub Release 页面仍会自动提供 Source code (zip) 和 Source code (tar.gz)。crest-source-v1.5.5.tar.gz 是本次发布流程额外生成的命名源码包，便于内网归档和交付。

镜像

镜像标签：

ghcr.io/sevoniva/crest-service:v1.5.5
ghcr.io/sevoniva/crest-service:main
ghcr.io/sevoniva/crest-web:v1.5.5
ghcr.io/sevoniva/crest-web:main

支持架构：

linux/amd64
linux/arm64

后端镜像包含应用服务、驱动、静态资源种子文件和 Prometheus metrics 能力；前端镜像包含 Web 产物和 Nginx 网关配置。离线部署请使用 Release 附件中的离线安装包。

离线包

本版本随包提供升级 SQL：

upgrade-sql/v1.5.4_to_v1.5.5.sql

全新安装不需要手动执行该 SQL。已有 v1.5.4 环境升级到 v1.5.5 时，请先备份元数据库，再在离线包目录执行：

set -a
source /opt/crest/.env
set +a
docker exec -i mysql-crest mysql -uroot -p"${CREST_DB_PASSWORD}" "${CREST_DB_NAME:-crest}" < upgrade-sql/v1.5.4_to_v1.5.5.sql

如安装时修改过 CREST_BASE，请把 /opt/crest/.env 换成实际运行目录中的 .env。外部 MySQL 环境可在数据库服务器或运维机执行同一 SQL 文件，目标库为 Crest 元数据库。

主要变化

数据门户

新增 /portal 数据门户作为默认登录入口。普通用户登录后进入门户，管理员仍可通过 /admin-login 或门户外层入口进入后台。
新增门户资源接口，支持概览统计、我的收藏、全部资源、最近使用、关键字搜索、资源类型筛选、分页和排序。
门户资源范围按创建人、默认组织、用户/组织/角色资源授权计算；管理员和系统管理员不受门户只读范围限制。
门户首页默认展示“我的收藏”，普通用户可直接收藏、取消收藏并打开已授权的数据大屏和仪表盘。
门户查看页提供返回、刷新、全屏和账号菜单，不在大屏内部展示“进入后台”入口。
门户和门户查看页顶栏统一使用 Crest 标识、系统名称、资源标题和账号区布局；系统名称来自站点设置。

已发布资源预览

普通用户可在已授权范围内访问已发布数据大屏和仪表盘，不再依赖后台资源树权限。
数据大屏筛选组件在门户预览中携带可视化资源 ID，请求数据集枚举值和树形筛选时按当前大屏与数据集关系进行只读校验。
门户打开资源时记录最近使用，支持门户“最近使用”列表。

数据大屏导出

新增“导出按钮”组件，可在数据大屏中绑定表格视图。
导出按钮支持配置按钮文案、目标表格、导出范围（当前筛选结果/全部数据）和透视表带格式导出。
表格视图导出可按当前筛选、联动、外部参数、Web 参数和钻取上下文生成 Excel。
导出中心分页参数和状态参数增加兜底处理，避免 undefined、null 或非法页码导致任务列表异常。
下载票据校验改为按任务、用户和票据时间判断，兼容历史任务缺少有效期配置的场景。

表格表头

表格组件新增“表头说明”配置，支持按字段填写说明内容，并配置说明行高度、字号、颜色和对齐方式。
表头说明可与多级表头同时使用；字段隐藏或调整顺序后按字段重新匹配说明内容。
复制表格内容时保留完整表头层级和说明行，富文本单元格会转换为可复制的纯文本和表格 HTML。
Excel 导出支持表头说明和多级表头，避免隐藏字段、说明字段和表头分组组合使用时出现错位。

账号与系统管理

系统参数新增“账号安全”分组，包含默认密码、密码策略、禁用初始密码、密码有效期、登录限制次数和限制时间。
新建本地用户和重置本地用户密码后，管理员可直接看到当前默认密码并一键复制。
当前用户信息增加 admin 和 backendAccess 标识，前端根据该标识控制后台入口和只读访问路径。
新建用户时会自动选取可用组织，减少未选择组织导致的保存失败。
审计日志补充新路由、权限接口、导出下载和用户密码操作的描述。

兼容性与安全

恢复旧版嵌入 token 参数读取方式，支持 /embedded/token-args 和旧路径 /embedded/getTokenArgs。
兼容旧版可视化组件名称，历史大屏中的装饰、边框、图片、标签页、视频等组件可继续加载。
修复数据集自定义 SQL 保存按钮、编辑器拖拽插入、复制数据集路由参数和资源树默认排序异常。
SQL 占位符、schema alias 和标识符替换改为边界感知处理，避免误替换字段名、表名或 Unicode 字符串。
查询取数和跨源取数字段场景增加单语句、只读 SQL 校验。
远程下载 URL 增加协议和地址校验，默认阻止本地、私有和组播地址。
文件上传、读取和删除路径使用规范化校验，避免路径越界。
分离部署示例不再提供固定默认密码和固定加密参数，启动时必须显式设置敏感环境变量。

升级说明

全新安装不需要执行 upgrade-sql/ 中的 SQL。
v1.5.4 升级到 v1.5.5 时，请先备份元数据库和运行目录，再执行 upgrade-sql/v1.5.4_to_v1.5.5.sql。
该 SQL 用于写入账号安全相关系统参数：默认密码、密码策略、禁用初始密码、密码有效期、登录限制次数和限制时间。
早期开发环境迁移到 v1.5.5 时，仍建议先导出业务资源，再在全新环境中导入。
生产环境必须设置高强度 CREST_INITIAL_PASSWORD、CREST_DB_PASSWORD、CREST_AES_KEY、CREST_AES_IV 和 Prometheus 抓取 token。
Prometheus/Grafana 默认不启动；只有显式设置参数后才启用。

验证范围

本版本发布前执行以下检查：

前端类型检查；
前端正式构建；
前端轻量产物检查；
后端 Maven 单元测试；
后端 standalone 打包；
API 路由合同测试；
数据门户权限和默认入口测试；
门户预览筛选测试；
数据大屏筛选导出测试；
表格表头说明复制和导出测试；
导出中心任务列表和下载票据测试；
用户默认密码和重置密码提示测试；
嵌入 token 参数兼容测试；
SQL 兼容和安全校验测试；
amd64、arm64 完整离线包、应用镜像升级包和源码包 checksum 校验。

Assets 9

02 Jun 06:58

iscarson

v1.5.4

1665d0a

Crest v1.5.4

Crest v1.5.4 发布说明

发布日期：2026-06-02

Crest v1.5.4 是 v1.5 系列的可观测性增强版本，面向企业内网、专有云和统一监控平台接入场景。此版本在前后端分离部署基础上补齐 Prometheus metrics、Grafana 看板、Prometheus 告警规则和可选内置监控组件，同时保持默认最小暴露面。

如已成功安装并运行 v1.5.3，可继续使用现有环境。需要接入 Prometheus/Grafana、分发带监控配置的离线包，或在 Kubernetes 中部署配套监控组件时，建议使用 v1.5.4。

镜像

镜像标签：

ghcr.io/sevoniva/crest-service:v1.5.4
ghcr.io/sevoniva/crest-service:main
ghcr.io/sevoniva/crest-web:v1.5.4
ghcr.io/sevoniva/crest-web:main

支持架构：

linux/amd64
linux/arm64

离线包

Release 附件：

crest-offline-v1.5.4-linux-amd64.tar.gz
crest-offline-v1.5.4-linux-arm64.tar.gz
crest-offline-v1.5.4-checksums.txt

离线包包含安装脚本、配置模板、Docker Compose 文件、Crest 后端镜像、Crest 前端镜像、MySQL 镜像、Prometheus/Grafana 配置和离线安装说明。启用 INCLUDE_OBSERVABILITY_IMAGES=true 制作的离线包还会包含 Prometheus 和 Grafana 镜像，适合完全无公网环境。

主要变化

后端接入 Actuator 和 Micrometer Prometheus registry，提供 /api/v1/actuator/prometheus 指标端点。
指标端点默认关闭；开启后必须配置 CREST_PROMETHEUS_TOKEN，抓取请求使用 Bearer Token 认证。
前端网关默认对外屏蔽 Prometheus 指标路径，Prometheus 从容器或集群内网直接访问后端服务。
Grafana provisioning 新增服务总览、API 监控、告警与 SLO、JVM、数据库连接池、任务与缓存 6 个看板，覆盖接口纳管、模块分类、接口吞吐、错误率、P95 延迟、状态码分布、Top 接口、JVM、GC、线程池、缓存和数据库连接池。
Prometheus 新增默认告警规则，覆盖服务采集中断、API 路由清单缺失、HTTP 5xx 错误率、P95 延迟、CPU、JVM 堆内存、线程池队列和数据库连接池。
Grafana Top 类和分布类面板增加空数据兜底，状态码分布、接口吞吐 Top 20、接口 P95 Top 20 等面板在低流量窗口下不再显示 No data。
单机安装新增 observability profile，可选启动 crest-prometheus 和 crest-grafana。
Kubernetes 新增 internal-mysql-observability 和 external-mysql-observability overlay，支持内置 MySQL 和外部 MySQL 两种形态。
系统参数页新增“可观测性”页签，管理员可查看 Prometheus/Grafana 状态、指标端点、token 是否已配置和内置看板信息。
离线包制作脚本支持打入 Prometheus/Grafana 镜像；企业已有统一监控平台时，也可只启用 Crest metrics 并导入 Crest 看板。
后端运行镜像补齐 JVM management 模块，确保 JVM、GC、线程和 CPU 指标完整输出。
文档、安装脚本、Kubernetes 示例、离线包示例和 CI 默认镜像标签统一更新至 v1.5.4。

接入方式

使用内置 Prometheus/Grafana

单机安装前在 installer/install.conf 中设置：

CREST_PROMETHEUS_ENABLED=true
CREST_GRAFANA_ENABLED=true

安装脚本会在 token 为空时生成随机抓取 token，写入运行目录的 conf/prometheus-token，并以只读文件挂载给 Prometheus。Grafana 默认监听 CREST_GRAFANA_PORT，并自动加载 Prometheus 数据源和 Crest 看板。

接入企业已有 Prometheus/Grafana

只开启 Crest metrics：

CREST_PROMETHEUS_ENABLED=true
CREST_PROMETHEUS_TOKEN=<prometheus-scrape-token>

Prometheus 侧抓取后端内网地址：

scrape_configs:
  - job_name: crest-service
    metrics_path: /api/v1/actuator/prometheus
    scheme: http
    bearer_token: <prometheus-scrape-token>
    static_configs:
      - targets:
          - crest-service:8100

Grafana 可直接导入仓库内看板：

installer/crest/observability/grafana/provisioning/dashboards/*.json

Prometheus 可加载仓库内告警规则：

installer/crest/observability/prometheus/rules/crest-alerts.yml

生产环境建议使用 Prometheus Secret、Kubernetes Secret 或企业密钥系统管理 token，不要把 token 写入公开文档、截图或前端页面。

安装注意事项

Prometheus/Grafana 默认不启动；只有显式设置参数后才启用。
指标端点开启但未配置 token 时，后端返回 503，不输出指标。
token 缺失或错误时，后端返回 401，并要求 Bearer Token。
前端网关访问 /api/v1/actuator/prometheus 返回 404，避免指标端点被公网或普通用户直接访问。
CREST_PROMETHEUS_MAX_URI_TAGS 默认 200，用于限制 HTTP URI 标签数量，避免高基数指标影响 Prometheus。
v1.5.4 面向全新环境安装，不支持从早期开发环境直接执行 Flyway 原地升级。
迁移已有环境前，请先备份元数据库和运行目录，导出业务资源，再在新环境中导入。
生产环境必须设置高强度 CREST_INITIAL_PASSWORD、CREST_DB_PASSWORD、CREST_AES_KEY、CREST_AES_IV 和 Prometheus 抓取 token。

验证范围

本版本发布前执行以下检查：

前端正式构建；
前端轻量产物检查；
后端 Maven 打包；
后端 split 打包；
后端和前端 Dockerfile 构建；
Prometheus metrics 默认关闭验证；
Prometheus metrics Bearer Token 认证验证；
前端网关屏蔽 metrics 路径验证；
Prometheus 容器抓取 Crest metrics 验证；
Grafana provisioning 和看板加载验证；
Kubernetes internal/external overlay 渲染检查；
Compose 单机和 split 配置渲染检查；
后端应用日志和前端网关日志检查；
amd64、arm64 离线包生成和 checksum 校验。

Assets 5

01 Jun 23:48

iscarson

v1.5.4-rc.1

2a8ff80

Crest v1.5.4-rc.1 Pre-release

Pre-release

Crest v1.5.4-rc.1 发布说明

发布日期：2026-06-02

Crest v1.5.4-rc.1 是 v1.5 系列的可观测性候选版本，面向企业内网、专有云和统一监控平台接入场景。此版本在前后端分离部署基础上加入 Prometheus metrics、Grafana 看板和可选的内置监控组件，同时保持默认最小暴露面。

如已成功安装并运行 v1.5.3，可继续使用现有环境；如需要接入 Prometheus/Grafana、分发带监控配置的离线包，或在 Kubernetes 中验证可观测性部署，可使用 v1.5.4-rc.1 进行测试验证。正式发布会在候选版验证完成后再打 v1.5.4。

镜像

镜像标签：

ghcr.io/sevoniva/crest-service:v1.5.4-rc.1
ghcr.io/sevoniva/crest-service:main
ghcr.io/sevoniva/crest-web:v1.5.4-rc.1
ghcr.io/sevoniva/crest-web:main

支持架构：

linux/amd64
linux/arm64

离线包

Release 附件：

crest-offline-v1.5.4-rc.1-linux-amd64.tar.gz
crest-offline-v1.5.4-rc.1-linux-arm64.tar.gz
crest-offline-v1.5.4-rc.1-checksums.txt

主要变化

后端接入 Actuator 和 Micrometer Prometheus registry，提供 /api/v1/actuator/prometheus 指标端点。
指标端点默认关闭；开启后必须配置 CREST_PROMETHEUS_TOKEN，抓取请求使用 Bearer Token 认证。
前端网关默认对外屏蔽 Prometheus 指标路径，Prometheus 从容器或集群内网直接访问后端服务。
Grafana provisioning 新增“Crest 可观测性总览”看板，覆盖接口吞吐、错误率、P95 延迟、状态码分布、接口明细、JVM、GC、运行时线程池、CPU 和采集状态。
单机安装新增 observability profile，可选启动 crest-prometheus 和 crest-grafana。
Kubernetes 新增 internal-mysql-observability 和 external-mysql-observability overlay，支持内置 MySQL 和外部 MySQL 两种形态。
系统参数页新增“可观测性”页签，管理员可查看 Prometheus/Grafana 状态、指标端点、token 是否已配置和内置看板信息。
离线包制作脚本支持打入 Prometheus/Grafana 镜像；企业已有统一监控平台时，也可只启用 Crest metrics 并导入 dashboard。
后端运行镜像补齐 JVM management 模块，确保 JVM、GC、线程和 CPU 指标完整输出。
文档、安装脚本、Kubernetes 示例、离线包示例和 CI 默认镜像标签统一更新至 v1.5.4-rc.1。

接入方式

使用内置 Prometheus/Grafana

单机安装前在 installer/install.conf 中设置：

CREST_PROMETHEUS_ENABLED=true
CREST_GRAFANA_ENABLED=true

安装脚本会在 token 为空时生成随机抓取 token，写入运行目录的 conf/prometheus-token，并以只读文件挂载给 Prometheus。Grafana 默认监听 CREST_GRAFANA_PORT，并自动加载 Prometheus 数据源和 Crest dashboard。

接入企业已有 Prometheus/Grafana

只开启 Crest metrics：

CREST_PROMETHEUS_ENABLED=true
CREST_PROMETHEUS_TOKEN=<prometheus-scrape-token>

Prometheus 侧抓取后端内网地址：

scrape_configs:
  - job_name: crest-service
    metrics_path: /api/v1/actuator/prometheus
    scheme: http
    bearer_token: <prometheus-scrape-token>
    static_configs:
      - targets:
          - crest-service:8100

Grafana 可直接导入仓库内 dashboard：

installer/crest/observability/grafana/provisioning/dashboards/crest-observability.json

生产环境建议使用 Prometheus Secret、Kubernetes Secret 或企业密钥系统管理 token，不要把 token 写入公开文档、截图或前端页面。

安装注意事项

Prometheus/Grafana 默认不启动；只有显式设置参数后才启用。
指标端点开启但未配置 token 时，后端返回 503，不输出指标。
token 缺失或错误时，后端返回 401，并要求 Bearer Token。
前端网关访问 /api/v1/actuator/prometheus 返回 404，避免指标端点被公网或普通用户直接访问。
CREST_PROMETHEUS_MAX_URI_TAGS 默认 200，用于限制 HTTP URI 标签数量，避免高基数指标影响 Prometheus。
v1.5.4-rc.1 面向全新环境安装，不支持从早期开发环境直接执行 Flyway 原地升级。
迁移已有环境前，请先备份元数据库和运行目录，导出业务资源，再在新环境中导入。
生产环境必须设置高强度 CREST_INITIAL_PASSWORD、CREST_DB_PASSWORD、CREST_AES_KEY、CREST_AES_IV 和 Prometheus 抓取 token。

验证范围

本版本发布前执行以下检查：

前端正式构建；
前端轻量产物检查；
后端完整测试；
后端 split 打包；
后端和前端 Dockerfile 构建；
Prometheus metrics 默认关闭验证；
Prometheus metrics Bearer Token 认证验证；
前端网关屏蔽 metrics 路径验证；
Prometheus 容器抓取 Crest metrics 验证；
Grafana provisioning 和 dashboard 加载验证；
Kubernetes internal/external overlay 渲染检查；
Compose 单机和 split 配置渲染检查；
后端应用日志和前端网关日志检查；
amd64、arm64 离线包生成和 checksum 校验。

Assets 5

01 Jun 21:58

iscarson

v1.5.3

d47f93f

Crest v1.5.3

Crest v1.5.3 发布说明

发布日期：2026-06-02

Crest v1.5.3 是 v1.5 系列的部署形态升级版本，面向全新私有化部署环境。此版本将应用拆分为后端服务和前端网关两个容器，补齐 Kubernetes 前后端分离部署、健康检查、网关转发和公开分享链路。

如已成功安装并运行 v1.5.2，可继续使用现有环境；如需要重新部署、分发离线包或在 Kubernetes 中验证前后端分离部署，建议使用 v1.5.3。

镜像

镜像标签：

ghcr.io/sevoniva/crest-service:v1.5.3
ghcr.io/sevoniva/crest-service:main
ghcr.io/sevoniva/crest-web:v1.5.3
ghcr.io/sevoniva/crest-web:main

支持架构：

linux/amd64
linux/arm64

后端镜像包含应用服务、驱动和静态资源种子文件；前端镜像包含 Web 产物和 Nginx 网关配置。离线部署请使用 Release 附件中的离线安装包。

离线包

Release 附件：

crest-offline-v1.5.3-linux-amd64.tar.gz
crest-offline-v1.5.3-linux-arm64.tar.gz
crest-offline-v1.5.3-checksums.txt

离线包包含安装脚本、配置模板、Docker Compose 文件、Crest 后端镜像、Crest 前端镜像、MySQL 镜像和离线安装说明。

主要变化

单机安装默认启动 crest-service 后端服务、crest 前端网关和 mysql-crest 元数据库三个容器。
Kubernetes 清单拆分为 crest-service 后端 Deployment 和 crest 前端 Deployment，分别配置资源、探针和安全上下文。
新增 Kubernetes 前端 Nginx ConfigMap，统一处理静态资源、API 转发、WebSocket 转发、doc.html 和 OpenAPI 入口。
后端新增独立的 liveness 和 readiness 检查；readiness 校验元数据库连接，liveness 只判断应用进程响应。
前端网关新增 /healthz 检查，Kubernetes startup、readiness 和 liveness 阈值按冷启动和初始化场景重新设置。
Kubernetes 部署不再由 Kustomize 生成占位 Secret，改为部署前在目标 namespace 创建 crest-db-secret。
内置 MySQL 镜像调整为 mysql:8.0.43，探针使用 MYSQL_PWD 注入密码，避免命令行参数暴露。
修复公开分享链接独立打开时被登录态拦截的问题，数据大屏分享链接可在未登录浏览器中直接访问。
分享页启动阶段只开放分享代理信息和分享校验接口，后续数据请求继续使用受限分享 token。
文档、安装脚本、Kubernetes 示例、离线包示例和 CI 默认镜像标签统一更新至 v1.5.3。

安装注意事项

v1.5.3 面向全新环境安装，不支持从早期开发环境直接执行 Flyway 原地升级。
迁移已有环境前，请先备份元数据库和运行目录，导出业务资源，再在新环境中导入。
默认安装会加载内置演示资源。生产环境不需要示例数据时，安装前设置：

CREST_LOAD_DEMO=false

同时将 Flyway 路径设置为只加载核心初始化脚本：

CREST_FLYWAY_LOCATIONS=classpath:db/migration

Kubernetes 部署前必须在目标 namespace 创建 crest-db-secret，生产环境建议由集群侧 Secret 管理系统下发。
生产环境必须设置高强度 CREST_INITIAL_PASSWORD、CREST_DB_PASSWORD、CREST_AES_KEY 和 CREST_AES_IV。
内置 MySQL 适合快速验证和单集群测试；正式环境建议优先使用外部托管 MySQL 或企业标准数据库服务。

验证范围

本版本发布前执行以下检查：

前端正式构建；
前端轻量产物检查；
后端完整测试；
后端 split 打包；
后端和前端 Dockerfile 构建；
Kubernetes internal/external overlay 渲染检查；
kind 内置 MySQL 全新安装验证；
/healthz、后端 liveness、后端 readiness 检查；
管理员登录、分享开关和分享详情接口验证；
数据大屏公开分享链接未登录独立打开验证；
Pod Ready 状态、重启次数和 Kubernetes Warning events 检查；
后端应用日志和前端网关日志检查；
amd64、arm64 离线包生成和 checksum 校验。

Assets 5

01 Jun 10:32

iscarson

v1.5.2

f55bc84

Crest v1.5.2

Crest v1.5.2 发布说明

发布日期：2026-06-01

Crest v1.5.2 是 v1.5 系列的安装交付修复版本，面向全新私有化部署环境。此版本修正单机离线安装包的数据库初始化编排，确保内置演示资源可按配置加载或跳过，并修复服务健康检查在多容器场景下的误判。

如已成功安装并运行 v1.5.1，可继续使用现有环境；如需要重新部署或分发离线安装包，建议使用 v1.5.2。

镜像

发布镜像：

ghcr.io/sevoniva/crest:v1.5.2
ghcr.io/sevoniva/crest:main

支持架构：

linux/amd64
linux/arm64

离线包

Release 附件：

crest-offline-v1.5.2-linux-amd64.tar.gz
crest-offline-v1.5.2-linux-arm64.tar.gz
crest-offline-v1.5.2-checksums.txt

离线包包含安装脚本、配置模板、Docker Compose 文件、Crest 应用镜像、MySQL 镜像和离线安装说明。

主要变化

修复离线安装包中演示资源清理 SQL 被 MySQL 首次初始化流程误执行的问题。
移除 MySQL 初始化 SQL 挂载，改为通过 MYSQL_DATABASE=${CREST_DB_NAME} 创建元数据库，避免数据库名被脚本写死。
保留安装时演示资源开关：CREST_LOAD_DEMO=true 时加载内置演示资源，设置为 false 时只初始化平台基础数据。
将 cleanup-demo-data.sql 移至手动维护目录，仅由 cleanup-demo-data.sh 调用，不再参与数据库首次启动。
修复 crestctl 健康检查读取多个 container_name 后误判服务失败的问题。
离线包制作流程清理 macOS 扩展属性文件，避免包内出现 ._* 或 .DS_Store。
文档、镜像标签、Kubernetes 示例和安装包示例统一更新至 v1.5.2。

安装注意事项

默认安装会加载零售经营和研发效能演示资源。
生产环境不需要示例数据时，安装前设置：

CREST_LOAD_DEMO=false

已加载演示资源的单机环境可执行：

bash cleanup-demo-data.sh --yes

Kubernetes 环境清理演示资源前，先将 CREST_LOAD_DEMO 设为 false，将 CREST_FLYWAY_LOCATIONS 设为 classpath:db/migration，重启应用后再执行清理 SQL。
生产环境必须设置高强度 CREST_INITIAL_PASSWORD、CREST_DB_PASSWORD、CREST_AES_KEY 和 CREST_AES_IV。
只有在环境明确要求 SM2 / SM3 / SM4 时，才启用 CREST_CRYPTO_MODE=sm-suite，并配置 CREST_SM4_KEY。

验证范围

本版本发布前执行以下检查：

安装脚本语法检查；
Docker Compose 配置展开检查；
演示资源开关配置检查；
前端构建；
后端打包；
离线包内容检查；
公开文档与版本号检查。

Assets 5

01 Jun 07:48

iscarson

v1.5.1

1aed23a

Crest v1.5.1

Crest v1.5.1 发布说明

发布日期：2026-06-01

Crest v1.5.1 是 v1.5 系列维护版本，主要处理 v1.5.0 发布后在安装交付、示例资源、权限、导出、数据集选择和审计链路中发现的问题。该版本继续面向全新私有化部署环境，不建议在早期开发版本数据库上直接原地升级。已有环境迁移时，请先备份元数据库和运行目录，并导出业务资源后再导入新环境。

一、安装与交付

本版本将内置示例资源从核心数据库初始化流程中拆出，安装时可通过 CREST_LOAD_DEMO 控制是否加载演示数据。默认安装仍会加载示例资源，便于验收和二次开发；正式生产环境如需纯净初始化，可在安装前设置：

CREST_LOAD_DEMO=false

针对已加载示例资源的环境，本版本提供清理脚本：

bash cleanup-demo-data.sh --yes

清理范围包括内置示例数据源、数据集、图表、大屏资源以及 crest_demo_retail 演示库。Kubernetes 部署文档同步补充了示例资源开关和清理方案，避免生产环境误带演示数据。

本版本发布镜像：

ghcr.io/sevoniva/crest:v1.5.1
ghcr.io/sevoniva/crest:main

镜像支持 linux/amd64 和 linux/arm64。离线包包含应用镜像、MySQL 镜像、安装脚本、配置模板、Docker Compose 文件和离线安装说明。

二、功能修复

修复管理员登录后业务菜单权限异常，导致工作台显示无业务菜单权限的问题。
修复数据集列表、数据源列表、新建仪表盘和新建数据大屏中数据集无法选择或持续加载的问题。
修复内置研发效能大屏部分图表持续刷新、数据未加载或下钻数据异常的问题。
修复仪表盘发布时出现 405 请求错误，并同时提示“已被他人更新”和“发布成功”的问题。
修复导出中心下载在文件过期、文件缺失、用户信息解析异常等场景下的错误提示和下载失败问题。
修复审计日志入口、菜单权限和接口访问校验不稳定的问题，管理员和审计只读角色可正常查看审计记录。
修复 v1.5.1 镜像构建中遗漏前端导出通知模块的问题。
移除旧版 commons-lang:commons-lang 传递依赖，关闭相关 Dependabot 安全告警。

三、体验优化

优化工作台、系统设置、数据源、数据集、数据血缘、导出中心等页面的浅色界面一致性。
调整系统设置侧边栏、角色管理、权限管理、审计日志等页面的表格、按钮、边框和间距，减少视觉割裂。
优化顶部导航、Logo、用户入口和“数据准备”下拉菜单的交互状态。
优化导出中心通知逻辑，多个任务完成时合并提示，避免连续弹出多条成功消息。
优化表格数据显示，对 \n、\t、HTML 换行和空白实体做兼容处理，避免在页面中直接显示转义字符。
增强表格复制体验，仪表盘、大屏、分享页面和“查看数据”中的表格可按选区复制，复制结果保持表格结构，便于粘贴到 Excel。
优化研发效能演示大屏的累计流、阶段漏斗、投入产出矩阵和明细下钻数据表现。

四、文档与接口

更新 README、安装文档、Kubernetes 文档、开发文档和数据血缘说明。
API 文档页按 Crest 产品模块重新整理，覆盖仪表盘与数据大屏、图表、数据集、数据源、数据血缘、导出中心、系统设置、基础能力和权限管理。
明确示例资源、核心初始化脚本和清理脚本的边界，降低后续部署和运维成本。

五、验证范围

本版本发布前已完成以下检查：

前端构建。
后端测试与打包。
本地 Docker 环境运行验证。
工作台、数据源、数据集、仪表盘、数据大屏、审计日志、权限管理和导出中心关键链路验证。
内置演示资源初始化和大屏数据加载验证。
依赖安全告警复查。

Assets 5

31 May 17:21

iscarson

v1.5.0

5de9faa

Crest v1.5.0

Crest v1.5.0 发布说明

发布日期：2026-06-01

Crest v1.5.0 面向企业内网和私有化部署场景发布，重点提升安装交付、平台管理、数据治理和安全审计能力。安装完成后，系统会自动初始化示例数据、数据集、仪表盘和数据大屏，便于团队快速完成部署验证和后续配置。

v1.5.0 面向全新环境安装，不支持从早期开发版本直接执行 Flyway 原地升级。已有环境迁移到本版本时，请先导出业务资源，部署新的 v1.5.0 环境，再导入资源。

镜像

发布镜像：

ghcr.io/sevoniva/crest:v1.5.0
ghcr.io/sevoniva/crest:main

支持架构：

linux/amd64
linux/arm64

离线包

Release 附件：

crest-offline-v1.5.0-linux-amd64.tar.gz
crest-offline-v1.5.0-linux-arm64.tar.gz
crest-offline-v1.5.0-checksums.txt

离线包内包含安装脚本、配置模板、Docker Compose 文件、Crest 应用镜像、MySQL 镜像和离线安装说明。

数据库初始化

v1.5.0 只保留两份 Flyway 初始化脚本：

脚本	用途
`V1.5.0.1__initial_schema.sql`	创建元数据库表结构、默认管理员、菜单、系统参数、平台管理、单点登录、审计日志、国产密码套件配置和内置驱动
`V1.5.0.2__demo_resources.sql`	创建零售经营演示库，以及研发效能主题数据、指标视图、图表、仪表盘和数据大屏

这两份脚本仅用于全新元数据库初始化。

主要变化

新增字段级数据血缘，覆盖数据源表、物理字段、数据集字段、图表、仪表盘和数据大屏。
内置零售经营演示资源和研发效能分析资源。
支持 OceanBase Oracle 模式数据源，基于 OceanBase Connector/J。
完善平台管理，覆盖用户、角色、权限、单点登录、审计日志、系统参数、站点设置和字体管理。
单点登录支持 OIDC / OAuth2 授权码模式，并按系统配置控制登录页入口。
国产密码套件模式由配置文件开关控制。
服务治理命名统一到 Crest 语义，覆盖接口、表结构、模块名和公开文档。
提供单机 Docker 安装、Kubernetes 部署和双架构离线部署包。

安装注意事项

请使用空的元数据库安装 v1.5.0。
生产环境必须设置高强度 CREST_INITIAL_PASSWORD、CREST_DB_PASSWORD、CREST_AES_KEY 和 CREST_AES_IV。
只有在环境明确要求 SM2 / SM3 / SM4 时，才启用 CREST_CRYPTO_MODE=sm-suite，并配置 CREST_SM4_KEY。
将 /opt/crest 或实际安装目录纳入备份。
生产环境建议启用 HTTPS，并设置明确的 CREST_ORIGIN_LIST。

验证情况

本版本发布前已完成以下检查：

前端构建；
后端打包；
空 MySQL 初始化；
Docker 镜像启动；
linux/amd64 和 linux/arm64 离线包制作；
敏感信息扫描；
版本扫描，确认公开发布材料中没有旧版本号残留。

Assets 5

29 May 06:35

iscarson

v1.3.0

a6b936f

Crest v1.3.0

发布内容

Crest v1.3.0 是面向正式部署的发布版本，包含产品界面调整、研发效能分析大屏、内置演示数据、Docker 部署补充和离线安装包。

镜像

ghcr.io/sevoniva/crest:v1.3.0
支持 linux/amd64 与 linux/arm64

离线安装包

crest-offline-v1.3.0-linux-amd64.tar.gz
crest-offline-v1.3.0-linux-arm64.tar.gz
crest-offline-v1.3.0-checksums.txt

离线包内包含安装脚本、Docker Compose 配置、Crest 应用镜像、MySQL 8.4.5 镜像和离线安装说明。

校验

Maven standalone 构建通过
Docker Compose 配置渲染通过
GitHub Actions 双架构镜像发布通过

Assets 5

Releases: sevoniva/Crest

Crest v1.5.7

Crest v1.5.7 发布说明

发布附件

镜像

离线包

新增功能

修复与调整

升级说明

验证范围

Uh oh!

Crest v1.5.6

Crest v1.5.6 发布说明

Release 附件

镜像

离线包

修复内容

升级说明

验证范围

Uh oh!

Crest v1.5.5

Crest v1.5.5 发布说明

Release 附件

镜像

离线包

主要变化

数据门户

已发布资源预览

数据大屏导出

表格表头

账号与系统管理

兼容性与安全

升级说明

验证范围

Uh oh!

Crest v1.5.4

Crest v1.5.4 发布说明

镜像

离线包

主要变化

接入方式

使用内置 Prometheus/Grafana

接入企业已有 Prometheus/Grafana

安装注意事项

验证范围

Uh oh!

Crest v1.5.4-rc.1

Crest v1.5.4-rc.1 发布说明

镜像

离线包

主要变化

接入方式

使用内置 Prometheus/Grafana

接入企业已有 Prometheus/Grafana

安装注意事项

验证范围

Uh oh!

Crest v1.5.3

Crest v1.5.3 发布说明

镜像

离线包

主要变化

安装注意事项

验证范围

Uh oh!

Crest v1.5.2

Crest v1.5.2 发布说明

镜像

离线包

主要变化

安装注意事项

验证范围

Uh oh!

Crest v1.5.1

Crest v1.5.1 发布说明

一、安装与交付

二、功能修复

三、体验优化

四、文档与接口

五、验证范围