跳到主要内容

版本说明

本页记录影响部署、升级、配置、API 和运行行为的版本变化。

Dash​

0.3.3​

发布日期：2026-09-19

GitHub 发布页：Ithiltir 0.3.3

Uptime 和看板​

  • 节点卡片新增最近 45 个自然日的在线率日条，包含今天。悬停或使用键盘选择日期，可查看当天 24 个小时的在线率；明细加载完成后才显示弹层，快速划过时使用 200 ms 防抖。
  • 在线率按节点上报覆盖的在线时长计算。今天和当前小时只包含已结束的分钟；没有观测的时段显示未知，不按离线计算。
  • 系统设置新增游客 Uptime 开关和 SLA 颜色阈值。默认对游客可见节点展示 Uptime；低于 99% 显示黄色，低于 95% 显示红色，可分别调整。
  • 卡片间距随可见内容调整，隐藏 Uptime 后不会留下整行空白。

升级和接口​

  • 从 0.3.2 升级会执行迁移 0014，开始积累 Uptime 历史。分钟记录和小时聚合均保留 46 天，升级前的在线率不会自动补算。
  • 新增日统计和小时明细 API。游客 Uptime 开关独立于历史指标和流量统计的访问设置。
  • 指标上报必须在服务端接收后 5 秒内完成入库；超时返回 503，该次上报不会写入指标。
  • 源码构建要求 Go 1.27.1+。普通安装可使用发布包升级，无需安装 Go。

已有节点及指标历史保持不变。使用早期布尔版 Uptime 结构的预发布实例，应先按 升级 中的预发布说明处理数据库；已使用时长结构的实例保留 Uptime 历史。

0.3.2​

发布日期：2026-08-30

GitHub 发布页：Ithiltir 0.3.2

告警和流量​

  • 节点快照缺失、非法或过期时，已有的非离线告警保持未恢复状态。只有新鲜样本明确证明条件消失，或对应规则被取消挂载时，Dash 才会关闭事件。
  • 流量网卡列表继续保留历史网卡，并改为按最后采样时间倒序返回。当前仍在上报的网卡优先，避免管理台默认选择已经停用且当前账期没有数据的旧网卡。

更新和界面​

  • 管理台发起手工 Dash 更新后，会在当前浏览器会话中保存目标版本，并使用根级遮罩阻止继续操作旧界面。服务切换期间每 10 秒检查一次本机版本；连接失败时显示重连状态，达到目标版本后等待用户确认再重新加载页面。
  • 更新耗时不会被浏览器当作失败。只有后台任务明确进入 failed 终态时，遮罩才显示失败并允许返回更新详情。
  • 告警管理默认打开事件页签。语言菜单增加 250 毫秒悬停延迟，点击仍会立即打开。

兼容性​

  • 本版本没有数据库迁移、配置格式变化或新增 HTTP 路径。
  • 历史网卡不会被删除，仍可用于查询旧流量数据；本版本只改变网卡列表的默认顺序。
  • 受管安装可以直接使用 dash update 从 0.3.1 升级。

从 0.3.1 升级前应先阅读 升级。

0.3.1​

发布日期：2026-08-24

GitHub 发布页：Ithiltir 0.3.1

通知和界面​

  • Telegram、电子邮件和 Webhook 渠道可以分别选择跟随系统、中文或英文。选择跟随系统时使用后端 app.language；已有渠道缺少语言字段时也按跟随系统处理。
  • 告警、渠道测试消息和 Dash 更新通知会按目标渠道语言生成。修改语言只影响之后创建的待发送通知；已有待发送任务保留原有内容和语言。
  • 通知渠道列表修正了状态开关和操作控件的对齐。
  • Dash 更新触发页面刷新后会恢复到系统更新页签，并在更新任务完成后显示对应语言的成功提示。

安装和维护​

  • Linux 首次安装在缺少数据库依赖时锁定 PostgreSQL 16.15 和 TimescaleDB 2.29.1。已有兼容的 PostgreSQL 16+ 和匹配 TimescaleDB 不会被替换；仓库无法提供锁定版本时安装会停止。
  • 新装和省略 app.node_offline_threshold 的配置默认使用 17s；版本更新不会改写已有的显式值。
  • 数据库迁移统一由 EiluneKit 执行。应用管理的数据库结构与预期不一致时，迁移会失败。0012 迁移会补齐 updated_at 触发器。
  • 更新前端和 Go 依赖，将源码构建基线提升到 Go 1.26.6，并修复已识别的标准库及前端依赖漏洞。

历史指标与存储​

  • 常规指标使用 1 小时时间分块，并在 1 天后无损压缩。新增的 database.metrics_raw_retention_days 默认保留最近 8 天的原始采样；15 分钟聚合保留 16 天，1 小时聚合保留 32 天。
  • 历史查询根据查询范围使用原始采样、15 分钟聚合或 1 小时聚合。CPU 温度、物理盘温度和公开的压力停顿信息（PSI）指标采用相同的聚合模型。15 天平均值按样本数加权，查询包含最新的实时采样。
  • 流量统计继续使用原有数据模型和保留策略，包括网卡原始指标、五分钟流量明细、lite/billing 模式、P95、月度快照和重建接口。
  • 0013 迁移会在 Dash 停止期间串行重建并回填连续聚合。新的原始采样保留策略仅在回填成功后启用。

兼容性​

  • 配置格式保持向后兼容。通知渠道省略 config.language 时使用 system。
  • database.retention_days 从本版本起只控制网卡原始指标和服务检查。
  • database.metrics_raw_retention_days 省略时使用默认值 8 天。需要延长常规指标原始采样保留期时，必须显式设置该字段。
  • 受管安装使用 dash update 时会自动执行数据库迁移。手工替换二进制前应备份 PostgreSQL 和通知配置密钥，并在启动前执行 dash migrate。

从 0.3.0 升级前应先阅读 升级。

0.3.0​

发布日期：2026-08-01

GitHub 发布页：Ithiltir 0.3.0

升级和运行状态​

  • Linux 更新逻辑移入原生 dash update 子命令。更新任务、阶段、日志和恢复状态会持久化到 $DASH_HOME/runtime/dash-update；update_dash_linux.sh 仅保留为兼容入口。
  • 受管安装改为不可变的 releases/<version> 目录和原子 current 软链接。更新器在停止服务前校验 release manifest、Dash/Node 版本和七个内置 Node/runner 资产的 SHA-256。
  • 更新事务在数据库迁移前失败时恢复旧 release。迁移开始后只允许使用候选版本向前恢复，不支持把旧二进制重新启动到已经前移的数据库 schema 上。
  • Dash 启动要求数据库 goose_db_version 与当前二进制完全一致。dash migrate 只推进较旧 schema，并拒绝较新 schema。
  • 告警开放事件、通知 outbox、流量物化进度、节点当前投影和流量月度累计由 PostgreSQL 持久化。告警 pending/cooldown、MTProto 登录握手、节点更新请求和流量重建任务仍是进程内状态。

配置和安全边界​

  • YAML 现在拒绝未知字段、多文档输入和显式非法时长。环境变量只要存在就覆盖 YAML；空整数变量表示 0，非空非法整数会停止启动。
  • monitor_dash_pwd 至少需要 8 个可见 ASCII 字符且不得包含空白。auth.jwt_signing_key 至少需要 32 字节且不得包含首尾空白。
  • app.public_url 的主机只接受 IP 字面量或 ASCII DNS 名称；国际化域名必须使用 IDNA/punycode，端口范围为 1..65535。
  • Redis 运行时最低版本为 6.2.0，推荐 8.2.3+。Dash 会对实际端点执行 PING 和 INFO server；--no-redis 跳过 Redis 配置、连接和版本校验。
  • API 响应统一增加 CSP、Permissions Policy、Referrer Policy、nosniff 和禁止 framing 的安全头。Refresh cookie 使用 SameSite=Strict。
  • 超过路由限制的 JSON body 返回 413 body_too_large，不再返回 400 invalid_request。

通知和告警​

  • dash migrate 使用 AES-256-GCM 加密完整通知渠道配置，并创建 $DASH_HOME/configs/notify-config.key。数据库备份和该密钥必须分开保存；缺少匹配密钥时 Dash 拒绝启动。
  • 通知渠道改为严格 schema。非法存量渠道仍会出现在管理台中，但配置返回 null，只能删除后重建。
  • 通知 outbox 新增 paused、blocked 和 discarded 语义，以及 unknown、healthy、degraded、disabled 四种渠道投递状态。停用渠道暂停积压；兼容配置保存或重新启用会唤醒积压并重置重试预算。
  • Webhook、Telegram 和 SMTP 请求增加字段大小、邮件地址、URL 和重定向限制。通知 HTTP 请求最多跟随五次同主机安全重定向，POST 只接受保留方法和 body 的 307/308。
  • SMART 告警通知会列出受影响设备、ATA 失败属性、NVMe critical warning 和可用的 media_errors。Node 提供的标签会移除控制字符并限制长度和条目数。
  • 规则名、持续时间、冷却时间、有限数值阈值及偏移量现在在写入边界校验。存量非法规则会关闭仍开放的事件并使用 rule_invalid 原因。

流量和节点契约​

  • 账期改为每个节点显式持有。升级会把原来继承全局账期的节点固化为迁移前的有效账期；新节点默认使用从 1 号开始的自然月。
  • 全局流量设置不再接受账期字段。旧输入 traffic_cycle_mode=default 仅作为兼容别名，写入时规范化为显式自然月。
  • 流量用量累计和五分钟流量明细使用独立的处理进度。从 lite 切换为 billing 时，系统从切换前 30 分钟开始生成五分钟流量明细；更早且仍在网卡原始指标保留期内的数据需要按节点手工重建。
  • 节点流量重建仅在 billing 模式下可用。运行期间切换到 lite 时，任务完成当前分块后停止。
  • 流量响应删除废弃字段 partial。GET /api/statistics/traffic/monthly 的 months 只接受 1..24。
  • 节点名、secret、标签、分组名和备注增加明确长度及控制字符限制。节点上报的整数范围、比率、速率和写入定长列的文本会在数据库写入前校验，非法 payload 返回稳定的 400 或 422。

安装、发布和界面​

  • install_dash_linux.sh 只支持首次安装。非 systemd 主机必须显式使用 --service-manager=none；后续版本变更统一使用 dash update。
  • Linux Node 安装器支持 systemd、Alpine/OpenRC 和显式 none。安装器先暂存并执行候选二进制，再停止已有进程和切换 release；重新执行安装脚本是强制重装，不承担 Node 自更新的回滚职责。
  • Linux、macOS 和 Windows Node 安装器在携带 X-Node-Secret 下载时最多跟随五次同主机安全重定向，拒绝 HTTPS 降级和跨主机跳转。
  • 发布包只携带 configs/config.example.yaml，不会打包本地配置。格式 v1 的 release.env 记录 Dash/Node 版本、目标平台和全部内置 Node/runner 资产摘要。
  • 浏览器在页面可见时检查本机 /api/version；Dash 版本变化后会重新加载页面，避免继续使用旧前端资源。远端 Release 查询失败不会阻止加载本机已安装版本。
  • 管理台补齐跳到主内容、键盘选择、焦点约束/恢复、对话框语义、加载状态、tooltip 描述和 reduced-motion 行为。
  • 看板汇总中的“告警”改名为“异常项”。该数值统计离线、RAID、CPU 和磁盘异常条件，不是已配置告警事件数。

从 0.2.7 升级前应先阅读 升级。

0.2.7​

发布日期：2026-07-01

GitHub 发布页：Ithiltir 0.2.7

变更​

  • 管理台新增 Dash 自更新页，可检查 release/prerelease 通道、查看当前版本、打包 Node 版本、最新版本、任务状态和最近日志。
  • Dash 自更新支持手动更新、重新安装、仅通知和自动更新模式。自动更新通过 systemd transient unit 执行包内 update_dash_linux.sh，状态保存在 DASH_HOME/runtime/dash-update。
  • 告警管理新增告警记录页，支持按节点、状态、指标和时间范围筛选，并支持分页加载。
  • 节点列表新增未恢复告警入口，显示当前未恢复告警摘要并跳转到对应节点的告警记录。
  • 告警通知渠道新增搜索和状态整理，Dash 自动更新通知复用已启用的全局通知渠道。
  • 系统设置新增 dash_update_channel 和 dash_update_mode 运行时配置。

修复​

  • Dash 更新完成后，管理台会重新同步 /api/version 和更新检查结果，避免“当前安装版本”和“最新版本”标签停留在旧状态。
  • Dash 自更新边界更严格：缺少 systemd、git、tar、curl/wget 或 update_dash_linux.sh 时返回明确不可用原因。
  • 系统设置 PATCH/PUT 明确区分局部更新和全量替换，避免保存时丢失新增字段。
  • 告警记录筛选的自定义时间范围校验更严格，避免无效范围发起查询。
  • 节点自动更新最低版本调整为 0.2.3，低版本节点需要重新执行安装命令或手工替换二进制。

兼容性​

  • Dash 自更新仅支持 Linux/systemd 包安装布局。非 systemd 环境会显示更新器不可用。
  • PUT /api/admin/system/settings 是全量替换，必须提交 history_guest_access_mode、dash_update_channel、dash_update_mode、logo_url、page_title 和 topbar_text。局部更新应使用 PATCH。
  • prerelease 通道只检查 prerelease tag，不回退到普通 release。
  • 节点列表的未恢复告警摘要是进入节点页时加载的快照，不是实时轮询。

0.2.6​

发布日期：2026-06-17

GitHub 发布页：Ithiltir 0.2.6

变更​

  • Dash 更新脚本新增 reinstall 命令。已安装版本与目标版本相同时，也可以重新安装当前通道的最新发布包。
  • 打包携带的 /deploy/* Node 二进制和 runner 资产改为受保护下载。正常请求需要 X-Node-Secret；旧 Node 自动升级使用 Dash 生成的短期 upgrade_token。
  • Node 自动升级处理支持 SemVer build metadata。同一 SemVer 优先级但 build metadata 不同的 Node 二进制仍可下发。
  • Linux Node 安装脚本支持中文和英文输出。
  • Linux Node 安装脚本在存在 cc、gcc 或 clang 时编译 root 侧连接数缓存 helper，用于统计主机和容器网络命名空间中的 TCP/UDP 连接数。
  • 运行时指标和历史指标的存储边界调整。TCP/UDP 连接数继续作为历史数值指标保存；SMART、温度和完整运行时明细保留在当前快照或前端缓存中。

修复​

  • 旧 Node 自动升级下载不发送 X-Node-Secret 时，Dash 返回带临时授权的下载 URL。
  • 更新 Node secret 时，如果新 secret 已属于其他节点，Dash 返回 409 duplicate_secret。
  • 前端缓存重建不再依赖发起请求的取消状态。
  • Dash 优雅关闭失败后会关闭底层 server。

兼容性​

  • Dash 管理台自动下发 Node 更新的最低 Node 版本仍为 0.2.1。
  • /deploy/* 中的安装脚本模板仍可公开读取；打包携带的 Node 二进制和 runner 资产需要鉴权。
  • 生产升级仍应先备份数据库。发布包更新脚本会执行迁移；手工替换二进制后必须手工执行迁移。

Node​

0.2.4​

发布日期：2026-08-21

GitHub 发布页：Ithiltir-node 0.2.4

变更​

  • 磁盘 SMART 上报新增可选 media_errors 字段，用于携带 NVMe SMART 的媒体和数据完整性错误累计值。

兼容性​

  • smartctl 未提供该值时，Node 会省略 media_errors。该字段是向后兼容的 JSON 扩展，现有接收端可以继续忽略未知字段。

0.2.3​

发布日期：2026-06-17

GitHub 发布页：Ithiltir-node 0.2.3

变更​

  • Node 下载 update manifest 中的资产时，会发送当前 target key 作为 X-Node-Secret。
  • Linux 和 macOS 托管安装布局完成暂存更新后，会切换 /var/lib/ithiltir-node/current 并以原参数和环境执行更新后的 Node。
  • Windows 托管安装完成暂存更新后，由 runner 替换二进制并重启 Node。
  • 不支持自更新的安装布局会报告 self update disabled，并继续执行上报循环。
  • Linux 连接数缓存缺失、过期或不可用时，Node 保留内置连接数统计作为回退路径。

修复​

  • 修复暂存更新后未正确重启或未执行新二进制的问题。
  • 修复受保护下载资产的认证处理。
  • 修复连接数缓存不可用时可能丢失回退统计的问题。

兼容性​

  • Windows 自更新要求 runner 托管。
  • Linux 和 macOS 自更新要求 /var/lib/ithiltir-node/releases/<version> 和 /var/lib/ithiltir-node/current 安装布局。
  • 安装布局外直接运行的二进制不会应用 update manifest。需要重新执行安装命令或手工替换二进制。