更新日志（服务端）#

本页记录服务端 / 管理端（后端服务、Web 管理后台、协议、计费、部署与文档站）的变更。桌面客户端见 桌面端更新日志，移动客户端见 移动端更新日志。

[未发布]#

新增#

变更#

修复#

---

[1.0.2] - 2026-09-02#

新增#

• 文档站代码块全面升级
  • 代码块按浅色 / 深色主题自动切换语法高亮，头部显示语言或自定义标题，右上角一键复制并有轻提示；Shell 示例复制时自动去掉 $ 提示符。
  • 超过 12 行的代码自动显示行号（可用 line-numbers / no-line-numbers 强制开关），支持 diff、高亮行、聚焦行与错误级别标注。
• 更新日志按端拆分
  • 更新日志拆分为 服务端、桌面端、移动端 三个独立页面，总览页 汇总各端最新版本；顶部导航新增「更新日志」入口。
  • 旧地址 /client/changelog 自动跳转到桌面端更新日志。
• Linux 桌面客户端下载入口
  • 客户端下载页新增 Linux 栏目（AppImage / DEB / RPM），并给出各发行版的安装与卸载命令；安装包发布后自动出现下载按钮，未发布前标注「即将推出」。
• 安装脚本架构与版本校验
  • 安装包根目录新增 release.env（版本、发行版、目标架构、构建时间）；install.sh 安装前比对本机 CPU 架构，不一致时拒绝安装并提示应下载的包名。
  • 升级时比较安装目录记录的已安装版本：拒绝降级（--force 可强制），同版本重复执行按重装处理、配置与数据不变；新增 --no-start（只更新文件不启动）与 --version（查看安装包版本）参数。
  • Docker Compose 在线 / 离线包的 install.sh 同步支持上述参数与校验，升级时自动更新编排中的应用镜像标签。

变更#

• 官网首页全新设计：首页文案全部改为中文，重做产品预览、产品矩阵、能力地图与部署向导等区块，配色与动效遵循品牌令牌，尊重系统「减弱动态效果」设置。
• 发布产物命名统一：服务端产物统一为 cloud-blox-{类型}-{版本}-{系统}-{架构}-{发行版}（类型为 server 裸二进制、install 一键安装包、docker-online / docker-offline Compose 包；版本号不再带 v 前缀），桌面客户端为 CloudBlox-{版本}-{系统}-{架构}[-变体].{后缀}（如 -windows-x64-setup.exe、-linux-x64.AppImage）。下载页、检查更新接口与历史版本清单由发布流程按实际产物自动生成，不再手工维护。
• 文档正文样式：表格改为圆角容器并支持窄屏横向滚动；提示块（提示 / 说明 / 注意 / 警告 / 详情）改为带图标的卡片式样式；新增 ::: steps 步骤容器，用于安装教程的分步说明。
• 文档内容面向正式交付整理：安装教程新增产物类型对照表，补充架构校验、版本校验与幂等升级说明，快速开始同步更新；移除面向内部开发的端口与流程说明，下线内部架构评估与优化路线图页面（旧地址跳转到架构文档索引）。

---

[1.0.1] - 2026-09-02#

新增#

• 官网与文档站迁移到 Next.js（web-server/）

  • 官网与文档站改为 Next.js App Router 纯静态导出：首页新增产品预览 / 产品矩阵 / 能力地图 / 安装向导演示；文档页为侧栏 + 本页目录 + 上下页三栏布局，支持本地搜索（Ctrl / ⌘ K）与系统 / 浅色 / 深色三态主题。
  • 全部原有文档（部署、使用指南、架构、客户端、更新日志、常见问题、隐私政策）完成迁移，旧 .html 地址保留兼容副本；/api/version/*、/api/changelog.json、/desktop/* 版本接口由构建自动生成。
  • 旧 docs/ VitePress 站点标记为废弃（docs/DEPRECATED.md），停止自动推送；make docs-dev / docs-build / docs-check 指向新站点。

• 管理端统计报表

  • 系统管理新增「统计报表」页面：整体统计、用量趋势、带宽统计、存储桶维度、区域节点五个板块。
  • 带宽按时间窗聚合 ClickHouse 流量事件推导（峰值/均值），下载流量只统计通过域名或 S3 协议的下载。
  • 指标口径与计费指标统一（容量 → 上传流量 → 出口流量 → 回源流量 → 请求次数 → 图片/视频/音频处理），指标类型由后端 API 下发。

• 区域服务端配置

  • 区域管理新增「服务端配置」：按区域选择 Nginx / Caddy / 自定义规则插件，通过 schema 表单填写根域名与端口。
  • 支持配置预览、保存、更新与删除；同一区域的多台机器可直接复用生成结果。

• 文档站下载与版式

  • 首页与客户端下载页按发布清单展示可下载平台；当前为 Windows 与 macOS（Apple Silicon）。Linux、Android、iOS、macOS Intel 标明「准备中」，不提供无效链接。
  • 文档正文页收紧行宽、标题节奏、侧栏与表格样式，不影响首页全宽布局。
  • 文档站信息架构重构：导航调整为「介绍 / 部署安装 / 使用指南 / 客户端」；区域节点部署、Nginx 反向代理拆分为独立页面；更新日志按服务端与客户端分设页面。

• 分片上传前置校验

  • 服务端在初始化分片上传时即校验文件大小与扩展名，超限请求第一时间被拒绝，不再传完整个文件才收到 413 错误。

• 内容审核人工复审系统

  • 审核记录新增「复审状态」字段（待复审/已复审/无需复审），所有非审核通过的结果均需人工复审。
  • 审核通过的可直接上传；AI 判定违规的需等待人工复审确认；人工审核/出错/超时的放行上传但仍标记待复审。
  • 人工复审通过后重新入上传队列跳过审核；确认违规后自动删除对象。
  • 审核记录选项卡角标显示待复审数量，支持按复审状态筛选。
  • 审核详情弹窗内嵌图片/视频/音频预览，支持在线审核操作。

• 通道执行统计

  • 通知通道新增执行次数与失败次数统计列。
  • 审核通道新增通过、违规、失败次数统计列。

• CDN 通道管理（商业版功能）

  • 支持接入阿里云 ESA 等第三方 CDN，统一管理域名绑定与证书。
  • 系统管理新增「CDN 通道」菜单，支持新增、编辑、删除通道，以及测试连接。
  • 配置时支持从 CDN 服务商动态获取站点列表与 DNS 记录列表，通过弹窗选择。
  • 区域管理支持绑定 CDN 通道（多选）、配置「强制使用 CDN」与「普通绑定解析地址」。
  • 域名绑定支持完整的 CDN 验证流程：创建后显示 TXT 验证记录和 CNAME 地址，支持一键复制，待验证状态下提供「验证」按钮。
  • 支持免费证书自动申请与自定义证书上传，证书状态实时显示。
  • 域名状态、证书状态均显示中文（如「待验证」「已激活」「申请中」「申请失败」等）。

• DNS 记录检测

  • 存储桶绑定域名页、CDN 通道域名列表均新增「DNS」检测按钮。
  • 一键检测域名验证 TXT、证书验证 TXT、CNAME 记录配置是否正确。
  • 检测结果显示主机记录、期望值、实际值、DNS 服务器、查询耗时，并以颜色区分通过/失败状态。

• 区域域名配置

  • 区域管理新增「域名配置」区块，支持配置「需要 ICP 备案」开关。
  • 中国大陆区域开启后，用户绑定自定义域名时需验证 ICP 备案状态。

• 用户存储桶配置（访问资源配额）

  • 用户管理支持按用户配置存储桶相关限制：每用户最大存储桶数、是否启用绑定域名/回源/备份及每桶数量上限。
  • 留空继承系统配置，0 表示不限制。
  • 存储桶设置选项卡（绑定域名/回源/备份）按用户生效限制与版本功能显示。

• 系统版本信息

  • 系统配置新增「系统版本」选项卡，展示应用版本、数据库版本、运行环境信息。
  • 支持一键「检测更新」，提示是否有新版本可用。
  • 「更新日志」子选项卡可查看完整的版本更新记录。

• 对象到期时间（文件到期时间）

  • 上传文件时可设置到期时间，到期后自动删除。
  • 文件列表支持按到期状态筛选：即将过期、到期>30天、永不过期、已过期。
  • 支持单个文件编辑到期时间，也支持批量延长/扣减到期时间。
  • 批量操作支持选择文件夹，对目录下所有文件生效。
  • 到期时间按剩余时间分档显示，并按状态着色（红/橙/黄提醒）。

变更#

• 统一版本同步与校验：根目录 VERSION 成为管理端、桌面端、移动端工程清单的唯一版本来源；新增 scripts/sync-version.mjs（make sync-version）一键同步，scripts/check-version.sh（make check-version）纳入质量门禁，构建与发布脚本打包前自动同步，移动端改为运行时读取安装包版本。

• 仓库瘦身：不再跟踪 web/.pnpm-store（约 3.3 万个文件、350 MiB），克隆与 CI 拉取明显变快。

• 桌面端构建预算门禁：质量门禁新增桌面端 bundle 预算检查（首屏同步脚本与单个异步 chunk 的 gzip 上限），防止依赖再被整体合并进首屏。

• 队列可靠性：执行失败的重试退避增加上限与随机抖动，高重试次数不再产生超长等待；Worker 节点标签周期续期，长期运行的节点不再从队列概览消失；队列概览新增「投递积压」指标（等待投递的任务数与最早等待时长）。

• 品牌图标：管理后台、文档站与桌面客户端统一为新的云网络图标；站点 LOGO/图标改为打包资源 URL，不再使用内联 base64。

• 存储桶文件图标：文件列表改用高辨识度彩色文件类型图标，支持扩展名、MIME 类型及 .env、.gitignore、Dockerfile 等特殊文件名识别。

• 存储桶文件路径导航：支持点击路径编辑图标手动输入目录路径，并快速跳转到指定目录。

• 储存桶文件预览：图片、音视频、PDF、Office 与文本文件统一使用同一套预览窗口，支持连续浏览、缩放、旋转、搜索、全屏、下载和新窗口打开；过大的文本、Office 与 PDF 文件会提示下载后查看。

• 队列执行记录：支持按存储通道、副本通道或审核通道筛选任务，批量重新入队时同步应用通道筛选条件。

• 计费与迁移可靠性基础：数据库处于脏迁移状态时不再自动跳过失败版本；ClickHouse 计费结构未完成迁移或校验失败时不再启动计费日志。新增计费事件去重、完整快照、可重试结算、扣费幂等与物理删除恢复所需的数据结构。

• 后端稳定性与架构收口：上传、删除与异步任务执行路径统一收口，减少双轨写库风险；管理端接口参数校验与错误返回更一致；资源回源的后台落盘任务增加超时与异常保护。生产配置支持 database.migrate.fail_fast，迁移失败时可中止启动。

• 后台异步任务封装：统一使用带超时与 panic 恢复的异步执行入口，通道/副本通道「刷新全部统计」与操作日志写入改为受控后台任务。

• 计费管理读路径收口：管理端账单/快照/余额/水位线与用户套餐定价统一走账单服务，去掉 Handler 内直查库与拼装用户名。

• 删除队列详情优化

  • 新增「删除执行摘要」区块，直观展示引用计数变化（带数字徽标）、操作结果（物理删除/仅减引用）、副本/备份删除数量。
  • 执行历史表格新增「操作」和「副本」列，一目了然每次执行的操作类型和级联删除情况。

• 备份/副本队列区分上传与删除

  • 备份队列和副本队列的任务列表新增「操作」列，以标签区分上传和删除任务。
  • 任务详情页新增「操作类型」字段，显示备份上传/备份删除、副本上传/副本删除。
  • 删除队列列表不再显示无意义的「大小」列。

• 媒体处理页

  • 优化页面布局：标题 + URL 命令栏 + 预设胶囊 + 参数/预览双栏。
  • 参数区采用带步骤号的折叠块，预览区支持固定定位。
  • 「生成预览」按钮增加加载状态提示。

• 对象存储菜单：侧栏「密钥管理」与「媒体处理」顺序对调，密钥管理在前。

• 回源设置：源站地址校验域名或 IP 格式，非法时返回明确错误提示。

• 任务管理权限：非管理员需指定存储桶或具备任务管理权限。

• 系统任务页：存储桶输入支持回车触发搜索；任务类型统一为中文展示。

• Worker 进程数量：默认数量等于已开启队列数量，支持在队列管理页修改。

修复#

• 入库中下载：Pending/Uploading 优先读临时存储，Uploaded 优先读正式通道并允许回退临时文件；仍在入库却读不到时返回可重试 503/1006，不再误报永久不存在 1004。
• 站点图标预览：系统配置页的系统 LOGO/图标改为正确加载打包资源，避免仍显示旧图或裂图。
• 并发覆盖上传：修复批量秒传同时覆盖多个同名文件时，删除任务因数据库间隙锁互相等待而偶发失败的问题。
• 私有对象预览与下载：修复签名链接被额外探测或追加下载参数后失效的问题；未配置预签名密钥时，改为通过登录鉴权安全获取文件。
• 副本队列状态：副本通道被禁用或下线时，执行记录改为“跳过”，任务改为“已取消”，不再误计为成功或已完成。
• 操作日志成败判定：业务接口统一返回 HTTP 200 时，操作日志不再仅按 HTTP 状态码判定成功；改为依据响应体 success/code 字段记录成功/失败。
• StorageFile 引用计数偏高：上传/回源 Worker 新建 StorageFile 后多余调用了一次 IncrementRef，导致 ref_count 比实际引用数始终多 1，删除任务中显示的引用计数不正确。附带数据修复迁移。
• 清空存储桶改为异步处理：清空操作立即返回并在后台执行，避免文件较多时请求超时；同一存储桶清空期间重复操作会被拒绝。
• 删除迁移任务后迁移仍在执行：正在执行的迁移任务被删除后，后台迁移现在会自动停止；删除任务时一并清理其迁移文件日志。迁移中的任务也可直接删除（删除后自动停止）。
• 任务重新入队报「task ID conflicts with another task」：手动重试、批量重新入队前先清理队列中残留的旧条目，并改用唯一入队标识，避免与已归档/已完成/等待重试的旧任务冲突导致重试失败。
• 上传/回源换通道重试：通道较多时不再因队列层重试次数不足导致任务卡在「待处理」；移除换通道时必然失败的重复入队调用，消除无效错误日志。
• 新建文件夹被识别为文件：修复文件夹写入时类型字段被数据库默认值覆盖，导致部分文件夹在客户端目录中显示为文件的问题；自动补齐的上级目录也会正确记录名称。

---

[1.0.0] - 2026-03-02#

新增#

• 初始版本
• S3 兼容协议、分片上传、预签名 URL
• 对象存储管理、文件管理控制台
• 图片/视频媒体处理
• 任务管理、队列管理、定时任务
• 多通道存储、通道选择
• 管理后台（用户/角色/菜单/部门/字典）
• 系统配置、操作审计日志
• 数据迁移

---