Repository navigation
Releases
NovaBlog CMS v1.3.0
NovaBlog CMS v1.3.0
本版本为切割版本(破坏性重构):以 v1.2.x 为界对历史包袱做一次性清底——移除全部向下兼容代码与死代码、删除 88 个历史迁移 SQL、移除全部测试用例,表结构以 GORM AutoMigrate + bootstrap 启动逻辑为唯一事实源。同时落地两轮代码核查报告的全部整改:定时任务拆分为独立进程、缓存层收口、主题托管分层、/ready 真实探活、错误信息收敛等规范修复。
Warning
不兼容提醒:v1.3.0 不兼容 v1.3.0 之前的任何版本,无法直接升级。
- 老用户:请先升级到 v1.2.12 完成旧数据兼容迁移,再升级 v1.3.0
- 新用户:直接从 v1.3.0 开始使用即可
升级前请备份数据库与上传目录。
后台选图弹窗重构(媒体体验优化)
- 统一选图体验:两栏文件管理器浏览器(
MediaBrowser共享组件)覆盖全部挑选媒体库的入口——9 个业务模块弹窗(文章/音乐歌曲/音乐歌单/视频/菜谱/游戏/项目/读书/设备)、旅行攻略封面与景点池、摄影作品集三步向导(添加作品/编辑/封面) - 两栏布局:弹窗加宽,左侧固定文件夹树(各级层级 + 文件数徽标,打开时按业务模块自动定位到对应文件夹),右侧为面包屑 + 文件网格,目录结构一目了然,不再依赖逐级点入
- 文件名展示:图片下方显示文件名(超长省略、悬浮显示完整名),视频文件显示占位图标
- 双维搜索:新增搜索框,支持文件夹名与文件名检索——文件夹由前端过滤目录树(结果带完整路径,点击直达该文件夹);文件走后端全局检索(结果标注所属文件夹),清空搜索即回到目录浏览
- 个人资料、技术栈图标、文章编辑器为纯上传/在线搜图场景(无媒体库挑选需求),保持原交互不变
向下兼容内容移除(切割核心)
- 退役 X-Market-Base-URL 请求头透传链:controller/logic/middleware/cors 共 16 处传参及 CORS 允许头一并移除(CMS 前端早已不发送该头,官方主题不受影响)
- 零调用死代码清除:article_cache、SumArticleViews、IncrementViewCountByID、GetAllIDs、SoftDeleteByPortfolioID、GetByKey、ReplaceTags、GetTagIDsByArticle、IPBlacklistRecord 模型等;删除 5 个零引用错误码(403002/400205/400209/404004/400507)
- 废弃库对象改为启动时自动清理(
bootstrap/deprecated_cleanup.go,幂等DROP ... IF EXISTS,失败仅告警不阻塞启动):- 旧
ip_blacklist表(单数,注意运行时黑名单走ip_blacklists+ Redis,不受影响) theme_market_configs.market_base_url列(官方站点地址已统一托管)security_configs的 9 个旧限流列(get/post/view/like_max_tokens 及对应 window_seconds、blacklist_threshold)
- 旧
历史迁移与测试清理
- 删除 88 个历史迁移 SQL:经核查从未被代码/部署执行(全仓无迁移 runner、无 go:embed、deploy 目录零引用),且 9 张表从未有 CREATE TABLE 迁移、纯手工执行无法从零建库;
migrations/README.md重写为「启动逻辑事实源」说明 - 移除全部 Go 测试文件(28 个):与死种子脚本 insert_article_golden_hour.sql 一并清理;CI 测试环节将空跑通过
定时任务拆分为独立进程
- 新增
internal/cron+cmd/cron:访问日志清理(1h)、浏览统计聚合(1h)、社区推送失败重试(5min)三个任务移出 api 进程,api 进程不再内嵌长驻协程;任务全部支持 ctx 优雅停止(原for range ticker.C不可停止) - Dockerfile/supervisord 配套新增
novablog-cron进程(SIGTERM 优雅收尾)
架构与规范修复(两轮核查报告落地)
- 缓存层收口:新增 5 个 cache 封装(install_guard/bilibili/cloud_drive/view_stats/mcp_rate_limit),生产代码不再裸调
cache.RedisClient;cloud_drive 为 fail-closed(Redis 不可用拒绝 OAuth) - 主题托管分层:theme_host_logic 去 gin 依赖改为纯决策,HTTP 执行迁入新
controller/theme_host_controller.go - /ready 真实探活:从空壳改为真实
SELECT 1(2s 超时,失败返回 503) - GORM 日志接入 zap;DSN 时区自适应修复(
TimeZone=Local被 pg 拒绝导致启动失败的兼容问题) - 错误信息收敛:未映射错误统一返回「系统内部错误」,不再泄露内部
err.Error();删除response.Error陷阱函数 - 环境变量覆盖:配置支持
NOVABLOG_前缀环境变量(app/seed 双入口) - Shutdown 失败降级:
Fatal改Error,修复退出时跳过 DB/Redis 关闭的 bug
部署与仓库配置
- deploy.sh 新增
--host-nginx宿主机反代配置生成 - 仓库清理:移除
.idea与 docs 内部核查报告的 git 跟踪(仅本地保留),补充 gitignore 规则
升级说明
- 升级路径(必读):
- 老用户:v1.2.x → v1.2.12(完成旧数据兼容迁移)→ v1.3.0
- 新用户:直接部署 v1.3.0
- 数据库:无需手工操作。AutoMigrate 自动同步表结构;废弃对象由启动逻辑幂等清理;迁移 SQL 目录已整体删除,不再需要
- 配置:无新增必填项,现有数据库/Redis/存储配置与已上传文件不受影响
- 行为变化:
- 未映射错误响应文案统一为「系统内部错误」,依赖原始报错文案的客户端需调整
- 自改前端若仍发送
X-Market-Base-URL头,主题市场接口预检将失败 - cron 进程的站点地址为启动时注入,后台修改站点地址后需重启
novablog-cron
- 升级前请备份数据库与上传目录
Full Changelog: v1.2.12...v1.3.0
NovaBlog CMS v1.2.12
NovaBlog CMS v1.2.12
本版本完成配置统一改造:彻底解决配置分散在「容器 env / config.yaml / 数据库」三处、同一语义多处维护导致的 不同步问题。落地为三层分源——容器编排层只管部署事实、config.yaml 只保留启动前置、运行时配置以数据库为唯一主源,管理后台新增「站点信息」配置分组与配置导出/导入(多博客一键复制),并修复存量部署中的多处配置真分裂问题。
补充更新:B 站视频解析修复(同版本镜像重新发布)
本节为 v1.2.12 镜像的重新发布内容,需重新拉取镜像更新容器后生效。
- 修复 412 风控拦截:B 站近期对数据中心 IP 的
x/web-interface/view接口启用 412 风控(返回 HTML 验证页),导致音乐列表/视频作品粘贴 B 站链接解析时报「解析视频信息响应失败: invalid character '<'」。解析现改用官方 WBI 签名接口x/web-interface/wbi/view(nav 签名密钥缓存 1 小时 + spi 访客 Cookie 缓存 24 小时),实测数据中心 IP 服务器可正常解析 - 降级兜底:WBI 请求被风控拦截时自动降级
x/player/pagelist(该接口未被风控),标题/时长/分P/cid 仍可解析(封面与 UP 主需手填);两级均失败时返回明确的「B站风控拦截(HTTP 412)」提示,不再出现 JSON 解析裸错误 - 行为修正:业务错误(如视频不存在 -404)直接返回不再误触发降级;签名失效(-403)自动刷新密钥重试一次
- 修复创建歌曲报错:未选分类时前端传空
category_id落库触发 uuid 列22P02 invalid input syntax错误(报「创建歌曲失败」);新增分类引用统一归一化(空串置 NULL),创建/批量创建/更新三个入口全覆盖 - 覆盖范围:音乐列表解析、视频作品解析、MCP
parse_video_url三条路径共用同一客户端,同步修复
三层分源(新的配置主源约定)
| 层 | 职责 | 变化 |
|---|---|---|
| 容器编排(.env / compose / nginx) | 镜像版本、宿主端口、挂载路径、DB 模式等部署事实 | 不变(后端进程本就不读环境变量) |
| config.yaml | 仅「启动前置」:数据库/Redis 连接、HTTP 端口、日志、JWT/加密密钥 | 大幅瘦身:删除 cors/community/security/image_search/clouddrive 与 themes 的全部运行时键 |
| 数据库 | 一切后台可改的运行时配置,唯一主源,保存即时生效 | 新增 system_configs 通用键值表(migrations/044) |
config.example.yaml 中的 cors.allowed_origins、community.base_url、upload.base_url、geoip.download_url 保留为 [播种] 键:仅首次启动导入数据库作初始值,此后一律以后台为准。
存量配置自动收敛(升级零手工)
- 启动时后台 goroutine 幂等种子导入:存量 config.yaml 旧键自动写入数据库(仅 DB 无值时写入,此后 yaml 不再被读取)——多个旧代理键(themes/image_search/clouddrive/geoip 的 proxy_url)归一为单一「出网代理」,GitHub Token、主题制品上限、云盘限额、站点对外地址等一并迁移
- 升级后 deploy.sh 对被移除的旧键提示「废弃,原样保留」,无任何副作用;无需手工改配置
重复源分裂修复
- 官方站点地址:原先 4 级兜底链(社区推送 DB → community.base_url → 遗留主题市场 DB 列 → themes.market_base_url)收敛为「社区推送 DB 权威值 → 播种键 → 内置默认」,幽灵键
community.site_url(代码读取但所有 yaml 均不存在)与遗留键兜底全部移除 - 站点对外地址:新增
system_configs.site_url为权威值(非空时覆盖 yaml 的 upload.base_url 首装默认),后台修改即时热更媒体 URL 基址,并提示同步检查跨域白名单 - HTTP 代理:4 个独立 yaml 键统一为单一「出网代理」配置,主题下载/开源作品/图片搜索/云盘/IP 库更新共用(空=直连,保留代理不可用自动降级)
- 访问日志保留天数:修复真分裂——原先后台修改数据库值不生效(清理 worker 只读 yaml),现 worker 直接读数据库权威值
- 死键清理:
security.enabled/security.blacklist_ttl_minutes(无任何读取点,生效源一直是数据库)
管理后台:配置中心增强
- 系统配置新增「站点信息」分组(置于首位):站点对外地址、出网 HTTP 代理、GitHub 访问令牌、主题制品下载上限、云盘导入限额(单文件/单批)、IP 库下载地址——保存即时生效,每分组标注「即时生效」徽标
- 补齐安全参数 UI(此前安全开关/黑名单 TTL/日志保留天数只有后端接口无界面)
- 配置导出/导入:页头一键导出全部运行时配置为 JSON(凭据类默认脱敏为占位符,可选包含);导入时展示将覆盖的分组并二次确认,按分组汇总写入结果——新博客导入即复制一套完整配置
工作台加载体验优化
- 工作台不再等待全部统计接口返回才渲染:页面结构与各统计卡片即时呈现,访问趋势、内容产出、模块数据表、访问分布、热门内容、最近评论等区块各自独立展示 loading(骨架屏/转圈),哪个接口先返回就先渲染哪个
- 指标条数值在依赖接口未就绪时展示脉冲骨架占位,接口失败时各区块回落到自身空态文案,不再整页空白
- 切换 7 天/30 天/90 天时间范围时,趋势图表同样展示 loading 反馈(此前切换无任何状态提示)
遗留文件自动收编进媒体库
早期(约 9 月及以前)的头像/博客 icon/页面背景走的是直写磁盘流程——文件只落在存储目录、完整 URL 烙进 bloggers 表,从未登记媒体库。ID 引用统一机制只覆盖"有媒体记录"的文件,这类遗留文件因此仍指向旧域名地址(即使旧域名已弃用)。
- 启动迁移新增遗留文件收编步骤:扫描全部业务表图片字段中引用列为空、URL 含
/files/的行,提取对象 key(自动解码中文路径、不依赖旧域名),media 无记录且磁盘文件存在时自动补建媒体记录(本地存储、归类到所属模块文件夹如「博主资料」)并回填引用列;磁盘缺失的保持 URL 模式 - 幂等设计:仅处理引用列为空的行、media 建行按存储路径防重,重复重启零副作用
- 收编后这些文件出现在媒体库统一管理,头像等地址自动跟随当前站点域名
部署脚本对齐
- 安装生成的 config.yaml 同步瘦身为启动前置 + 播种键;
--market-url不再写废弃键themes.market_base_url,改为播种community.base_url - 修复多博客部署盲点:
NOVABLOG_GEOIP_DIR纳入 .env 管理,IP 离线库目录按博客隔离(此前所有博客共享同一目录)
升级说明
- 数据库:无需手工操作。AutoMigrate 自动建
system_configs表(migrations/044 为等价 SQL 存档);启动种子自动导入存量 yaml 运行时键 - 配置:无新增必填项;现有数据库/Redis/存储配置与已上传文件不受影响
- 公站主题:零改动(媒体 URL 基址、apiBase 注入逻辑不变)
- 升级验证:管理后台「系统配置-站点信息」修改站点对外地址并保存 → 文章封面等媒体链接立即跟随新地址;「导出配置」后在新博客「导入配置」→ 各分组配置一致
Full Changelog: v1.2.11...v1.2.12
NovaBlog CMS v1.2.11
NovaBlog CMS v1.2.11
本版本完成媒体库图片引用架构改造:内容创作与「关于我」全部模块的图片字段不再把完整 URL 写死在业务表,改为引用媒体库文件 ID,读取时按当前存储配置动态拼接访问链接——更换对象存储平台、更换自定义域名后全站图片自动跟随,从根源上消除「迁移存储后旧图断链」的同步问题。
架构改造
业务表存文件 ID,链接动态解析
- 文章/菜谱/书籍/游戏/视频/歌曲/歌单/旅行攻略(内容创作)与个人设备/项目经历/技术栈/个人资料(关于我)共 12 张表的封面、图标、头像等图片字段新增
media_id(及预设preset_id)引用列 - 从媒体库选图/上传时存 ID,读取时实时解析为最新链接;第三方外链(Simple Icons 图标、B站解析封面、手动输入的链接)保持 URL 模式,两种来源互斥共存,历史数据兼容不变
- 落库不固化 URL:保存时 ID 与 URL 互斥写入(模型层 BeforeSave 兜底归一),编辑保存不会把解析出的完整 URL 重新写回数据库
media 表只存相对路径,URL 全动态拼接
media.url/media_presets.output_url统一归一为相对对象键,完整 URL 在读取时按该媒体所在存储平台的当前配置(自定义域名优先)动态拼接- 更换存储平台的自定义域名后立即全站生效,零数据库改写;存储迁移工具迁移文件后仅更新
storage_type,完成即生效
正文与 jsonb 内嵌图使用稳定链接
- 新增公开稳定链接端点
GET /api/v1/public/media/:id/file(支持?preset=指定预设成品图):本地存储流式返回文件,对象存储 302 到当前访问地址 - 富文本/Markdown 正文上传插图、菜谱步骤图、旅行景点/行程图改用按媒体 ID 索引的稳定链接,存储迁移/换域名后历史内容不断链
体验改进
媒体删除的引用确认更精准
- 删除弹窗的引用扫描从「URL 字符串模糊匹配」升级为「文件 ID 精确匹配」(保留 URL 与稳定链接兜底扫描,命中自动去重),ID 引用的内容必定被准确列出
- 强制删除被引用文件时,同一事务内自动清空所有业务表中的引用列,不再遗留死 ID
存储迁移工具加固
- 平台迁移不再需要改写业务表里的 URL 字符串;正文与 jsonb 内嵌图的历史绝对 URL 保留自动 REPLACE,并补齐菜谱步骤图、旅行景点图/行程图两类此前遗漏的同步位置
升级说明
- 数据库:无需手工操作。AutoMigrate 自动为 12 张业务表新增引用列、为
media_presets表补storage_type列;migrations/043_media_reference为等价 SQL 存档 - 存量数据:服务启动后在后台 goroutine 自动幂等回填(按 URL 与
media.url/存储路径匹配填引用列,匹配不上的纯外链保持原样),不阻塞启动;回填未完成的短暂窗口内读取走 URL 兜底,页面无感知 - 配置:无新增配置项;现有存储配置与已上传文件不受影响
- 公站主题:零改动——API 仍下发完整 URL 且字段名不变,主题站/静态导出站无需重建即可正常渲染
- 升级验证方法:在媒体库更换存储自定义域名(或执行一次平台迁移),所有引用中的文章封面、头像等链接应即时跟随新地址
Full Changelog: v1.2.10...v1.2.11
NovaBlog CMS v1.2.10
NovaBlog CMS v1.2.10
本版本修复 v1.2.9 中百度网盘导入文件必现失败的问题,并为云盘导入补充逐文件进度条与实时下载速度展示——第三方网盘普遍限速(如百度非会员约 80KB/s),下载期间不再出现「假 0%」,用户可看到每个文件的真实进度与速率。
问题修复
修复百度网盘导入必现失败(「未获取到下载直链」)
- 根因:百度
filemetas接口响应的文件数组字段为info(仅目录列表接口method=list为list),客户端此前按list解析,导致接口返回成功(errno=0)时始终取不到dlink,所有百度网盘文件导入都会失败 - 现按官方响应结构解析;已用真实账号与文件实测,修复后可正常取直链并流式下载
- 空直链错误信息同步细化为可操作提示:百度个人开发者应用仅能下载「我的应用数据」(
/apps/<应用名>/)目录内的文件,报错时会引导移动文件或申请下载权限
新特性
导入逐文件进度与实时下载速度
- 导入弹窗中每个文件拥有独立进度条(已下载/文件大小百分比)与实时速度(KB/s、MB/s),整体进度条与成功/失败计数保留
- 后端在下载流上计数并节流回写数据库(增量 ≥1MiB 且间隔 ≥1s),前端每 2 秒轮询渲染,限速下载时进度与速度平滑可见
- 完成后逐文件状态保留在结果视图中,可一眼看到每个文件的成败与耗时
下载空闲看门狗(健壮性)
- 网盘直链连接若持续超过 120 秒无任何字节(死挂),自动取消该文件下载并标记失败,任务继续处理其余文件,不再无限期阻塞
升级说明
- 数据库:无需手工操作。AutoMigrate 自动为
cloud_import_items表新增transferred_bytes列;migrations/042 为等价 SQL 存档 - 无配置变更;已绑定的云盘账号与授权状态不受影响
- 拉取新镜像重启后,重新发起导入即可看到逐文件进度
Full Changelog: v1.2.9...v1.2.10
NovaBlog CMS v1.2.9
NovaBlog CMS v1.2.9
本版本的核心是 媒体库支持第三方云盘导入:新增「云盘账号管理」与「云盘导入」能力——WebDAV 账密直连开箱即用(坚果云/Alist 等,零审核),百度网盘与阿里云盘通过开放平台 OAuth 接入(自部署站长自带凭据);云盘文件可批量浏览并转存进媒体库,完全复用现有对象存储与文件夹体系,前台展示链路零改动。
新特性
云盘账号管理页(系统与安全 → 云盘账号)
- WebDAV:填写服务器地址与账密即可绑定(保存前自动测试连通),支持多账号;坚果云请使用「应用密码」;自建 Alist 可将百度/阿里/夸克等网盘聚合为 WebDAV,一次性接入全部网盘
- 百度网盘/阿里云盘:在对应 Tab 配置开放平台应用凭据(AppKey / Client ID + Secret,AES 加密落库),页面提供开放平台申请入口链接;回调地址由当前访问地址自动生成(只读、可复制),复制登记到开放平台即可
- OAuth 授权跳转官方授权页(账密/扫码登录),授权完成后账号页自动刷新;账号卡片展示昵称、容量使用与授权状态,可随时解绑
媒体库「云盘导入」
- 媒体库页头新增「云盘导入」入口:选择账号 → 浏览云盘目录(面包屑导航、进入文件夹、文件多选/全选、游标加载更多)→ 选择目标媒体文件夹 → 批量导入
- 导入为转存:云盘文件下载后写入当前对象存储(本地卷/阿里 OSS/腾讯 COS/MinIO),自动创建媒体记录并归入目标文件夹,引用检查、素材迁移、删除清理等既有体系完全兼容
- 支持图片/视频/音频及任意文件类型(按扩展名归类到媒体库对应 Tab);下载流直通存储(流式入库),GB 级视频不占用额外内存
- 导入过程实时进度条 + 成功/失败计数 + 失败明细(文件名与原因);完成后媒体库自动刷新,可直接用作文章封面等
安全与限流
- 全部管理接口需登录;OAuth 回调使用一次性 state(Redis,5 分钟)防 CSRF;云盘凭据与 token 均加密存储、接口返回脱敏
- 单次导入上限 200 个文件、单文件默认 2048MB;同一账号同时仅允许一个导入任务;服务重启后遗留任务自动标记为失败,不会永久卡住
升级说明
- 数据库:无需手工操作。服务启动时 AutoMigrate 自动创建 4 张新表(cloud_drive_configs / cloud_drive_accounts / cloud_import_tasks / cloud_import_items);migrations/040、041 为等价 SQL 存档
- config.yaml:新增可选
clouddrive配置段(proxy_url / max_file_size_mb / import_batch_limit),不配置走默认值;镜像内置配置自动生效,自行挂载 config.yaml 的部署按需添加 - 云盘接入前提:WebDAV 开箱即用(坚果云需应用密码);百度网盘需在百度网盘开放平台申请应用,阿里云盘需在阿里云盘开放平台申请,并将后台「云盘账号」页展示的回调地址登记到对应平台;平台审核期间可先用 WebDAV
- API 兼容性:纯新增接口(
/api/v1/clouddrive/*)与前端页面,无破坏性变更;已有部署拉取新镜像重启即可
Full Changelog: v1.2.8...v1.2.9
NovaBlog CMS v1.2.8
NovaBlog CMS v1.2.8
本版本的核心是 MCP 服务端能力全面扩展:工具数量由 9 个增至 93 个,覆盖管理后台全部内容模块(文章、媒体库、分类标签、关于我、评论、工作台统计与八大内容创作模块),AI 客户端从此可以开口管理整站内容;同时出厂 CORS 默认白名单补充生产域名,并修复 i18n 部分文案未覆盖到位的问题。
新特性
MCP 工具全面覆盖(9 → 93 个)
- 媒体库:
upload_image新增module参数,上传图片按内容模块自动归档到对应文件夹;新增list_media、list_media_folders、move_media、delete_media(文件被引用时需force=true) - 分类与标签:
list_categories支持全部 12 种内容模块类型;新增create_category/update_category/delete_category与create_tag/update_tag/delete_tag - 关于我:新增博主资料
get_profile/update_profile,以及个人设备、项目经历、技术栈、开源作品(含refresh_open_source重新拉取仓库信息)四组 CRUD 工具 - 内容创作:新增第三方歌单、视频作品(含
parse_video_url链接预解析)、旅行攻略(含set_travel_status发布控制)、摄影作品集(含作品项增删改与排序)、美食菜谱、读书书架、游戏库、健身训练八组模块工具 - 评论管理:新增
list_comments、reply_comment(以博主身份回复)、delete_comment(级联软删其下回复) - 工作台(只读):新增
get_dashboard_overview(各模块文章/发布/评论统计与流量摘要)、get_dashboard_trend(内容产出/流量趋势,7d/30d/90d)、get_top_content(热门内容排行) - 安全约束统一:所有删除类工具必须显式传
confirm=true才会执行,防误删 - 新增 MCP 服务端单元测试;README 五个语言版本的 MCP 章节同步更新为按域分组的 93 工具总览
媒体库系统文件夹随语言显示
- 媒体文件响应新增
folder_module_key字段,前端据此翻译系统文件夹名称(media.module.*);媒体库面包屑、选图弹窗、移动弹窗与列表中的系统文件夹名均跟随当前界面语言,不再显示数据库原名
CORS 出厂默认白名单补充生产域名
- 全新安装的默认白名单由
http://localhost:5173,http://localhost:5174扩充为同时包含https://www.novablog.cn与https://api.novablog.cn(config.example.yaml、中间件硬编码兜底值、模型列默认值三处同步);后台动态修改的白名单仍以数据库持久化值为准
问题修复
- 修复 i18n 部分文案未覆盖到位的问题:MCP 设置页的能力描述与安全提示更新为 93 工具口径;新增系统文件夹模块名翻译(
media.module.*);简体中文、繁體中文、English、日本語、한국어 五语言同步补齐
升级说明
- 数据库:无需手工操作。服务启动时 AutoMigrate 同步表结构;
migrations/039_cors_default_origins仅调整cors_configs列默认值并回填从未被修改过的播种行——由于项目没有自动执行 SQL 迁移的机制,该回填由启动引导逻辑(InitFromFallback)等价完成:只要白名单从未在后台被修改过,重启后会以 config.yaml 的值自动回填 DB;自定义过的配置不受任何影响。如使用外部迁移流程,也可手工执行对应 SQL,与自动回填互不冲突 - config.yaml:
cors.allowed_origins出厂默认值已补充生产域名,镜像内置 config 由 config.example.yaml 生成、自动生效。已有部署若自行挂载了 config.yaml,请同步在cors.allowed_origins中追加https://www.novablog.cn,https://api.novablog.cn后重启;已在后台自定义过白名单的环境以数据库值为准,请按需在后台自行添加生产域名 - MCP 使用方:升级后重新拉取工具列表即可使用全部 93 个工具;如已在 AI 客户端(Codex / ZCode 等)配置了 Skill 接口文档,建议同步更新以获得完整能力。删除类操作现统一要求显式
confirm=true(delete_media、delete_comment等新增工具同样适用) - API 兼容性:媒体文件响应新增可选
folder_module_key字段,向后兼容 - 已有部署拉取新镜像重启即可,无破坏性变更
Full Changelog: v1.2.7...v1.2.8
NovaBlog CMS v1.2.7
NovaBlog CMS v1.2.7
本版本的核心是管理后台多语言国际化:界面全面支持简体中文、繁體中文、English、日本語、한국어 五种语言,切换全链路打通;同时对书籍/游戏/菜谱/视频/项目经历/开源/技术栈/健身八个模块统一接入结构化分类,并将官方站点域名切换为 novablog.cn。
新特性
管理后台多语言(i18n)
- 新增五种界面语言:简体中文(默认)、繁體中文、English、日本語、한국어,覆盖布局、登录页、首装向导及内容创作域(文章/媒体库/音乐/播放列表/评论/分类/视频)、生活与作品域(书籍/游戏/菜谱/健身/器材/旅行/作品集/项目/开源/技术栈)、系统域(主题/系统/存储/安全/地图/MCP/文档/资料/编辑器)全部页面
- 顶栏、登录页与首装向导均提供语言切换入口,初始语言自动检测:本地偏好 → 浏览器语言(精确匹配 → 前缀匹配,繁体地区 zh-Hant/TW/HK/MO 自动映射繁體中文)→ 简体中文;手动切换后持久化到本地
- 图表与格式联动:echarts 图表文案、dayjs 日期、
Intl.NumberFormat数字格式化均跟随当前语言;请求拦截器兜底文案(登录过期/网络错误等)同步国际化 - README 新增繁體中文/English/日本語/한국어 四个语言版本
- 新增
npm run check:i18n校验脚本:五语言命名空间 key 一致性 + 源码静态t()引用检查(当前 1269 个 key、34 个命名空间),防止漏译入库
多模块统一分类体系
- 视频作品、读书书架、美食菜谱、游戏库、项目经历、开源作品、技术栈、健身训练八个模块统一接入
categories结构化分类(新增category_id外键关联),各模块列表接口支持按category_id筛选 - 分类唯一性由全局
slug唯一改为(type, slug)联合唯一,不同模块允许同名分类;API 文档同步更新 - 存量数据自动迁移:项目经历的自由文本分类、技术栈的约定值(语言/框架/工具/数据库/其他)、健身训练的固定枚举(力量/有氧/拉伸)在服务启动时幂等播种为分类并回填
category_id(等价于migrations/037、038,回填失败仅跳过对应步骤、不阻塞启动)
官方域名切换
- 官方站点地址由
novablogapi.ditancafebar.cn切换为api.novablog.cn(注册页www.novablog.cn),出厂配置、主题市场客户端与文档同步更新;后台修改的官方地址仍以数据库持久化值为准
问题修复
- 无
升级说明
- 数据库:无需手工操作。服务启动时 AutoMigrate 同步表结构,并自动完成分类数据的幂等回填(等价于
migrations/037_content_categories、038_unify_tech_stack_fitness的 up 脚本);如使用外部迁移流程,也可手工执行对应 SQL,与自动回填互不冲突 - config.yaml:
community.base_url出厂默认值已更新为http://api.novablog.cn;已在后台修改过官方地址的部署以数据库值为准、无需改动。旧域名作为存量兜底仍可读取,建议尽快更新 - API 兼容性:各内容模块请求/响应新增可选
category_id字段,向后兼容;项目经历、技术栈、健身的旧字段(自由文本category、枚举type)保留为兼容镜像,由逻辑层与分类双向同步 - 已有部署拉取新镜像重启即可,历史数据(项目经历分类、技术栈分类、健身类型)会自动转换为统一分类,无数据丢失
Full Changelog: v1.2.6...v1.2.7
NovaBlog CMS v1.2.6
NovaBlog CMS v1.2.6
本版本的核心是音乐播放列表(音频导入)管理体验优化:修复封面不显示问题,补齐行内编辑/删除,新增拖拽排序与置顶,并支持卡片上直接切换分类。
新特性
音乐列表排序:拖拽 + 置顶
- 鼠标悬停歌曲行首出现拖拽把手,按住拖动到目标位置松手即自动保存,拖动中目标行高亮提示;保存失败自动回滚刷新
- 行尾新增「置顶」按钮,点击将该歌曲移动到列表第一位;置顶后仍可被拖拽换位
- 新增批量排序接口
PUT /api/v1/music/songs/sort(事务内逐条更新);保存时按当前分类拉取全量歌曲统一重编sort_order,分页场景下顺序全局一致
歌曲行内编辑/删除
- 歌曲行尾新增「编辑」「删除」操作按钮(悬停显示):编辑复用歌曲弹窗,可修改标题、歌手、封面、分类、时长;删除需二次确认
卡片分类快改
- 歌曲标题右侧展示所属分类标签,点击弹出分类下拉立即切换,支持移入「未分类」;在分类筛选视图下移走歌曲会同步从列表消失
问题修复
- 音乐封面加载失败:管理端此前将
http://封面地址强转为https://,导致跟随upload.base_url转存的本站封面(无 TLS)全部加载失败、显示 alt 文本。现改为多级降级加载:缩略参数 URL → 原始 URL → 服务端图片代理 → 占位图,列表封面、底部播放器、编辑弹窗预览、批量导入预览四处同步修复 - 编辑歌曲时清空分类不生效:后端此前将空的
category_id视为「不更新」,现修正为传空字符串即清空分类(置为 NULL),并避免写空串触发 uuid 外键错误
升级说明
- 无破坏性变更:
songs表sort_order字段此前已存在,本次无数据库迁移;config.yaml无需改动 - 已有部署拉取新镜像重启即可
- 拖拽排序与置顶保存使用新增的管理端接口,使用已登录的后台会话即可,无需额外配置
Full Changelog: v1.2.5...v1.2.6
NovaBlog CMS v1.2.5
NovaBlog CMS v1.2.5
本版本的核心是社区推送新增「博客归属验证码」:在后台粘贴社区下发的验证码并保存,即可完成博客与社区账号的归属绑定,验证通过后博主的社区账号获得「站长」标识。
新特性
社区推送:博客归属验证码
- 「系统配置 → 社区推送」新增「社区验证码」输入项:在 NovaBlog 社区「个人设置 → 绑定博客」复制验证码,粘贴后保存即可;验证码对外可见、配置读取时直接回显,允许清空
- 保存配置时自动向社区提交归属验证(验证码本身即凭据,无需推送密钥),并即时展示结果:
- 验证成功:提示社区账号「xxx」已获得「站长」标识
- 验证失败:展示社区返回的具体原因;配置本身仍会保存,修正验证码后重新保存即可重新提交
- 未填写验证码:视为跳过,保存流程与此前完全一致,不影响推送配置的日常维护
community_push_configs表新增verify_code列,随配置持久化,重启后依然生效
变更
- README 补充作者博客入口链接
升级说明
- 无破坏性变更:升级后 AutoMigrate 自动为
community_push_configs表新增verify_code列,无手动数据库操作;config.yaml无需改动 - 已有部署拉取新镜像重启即可;如需完成社区「站长」认证,到后台「系统配置 → 社区推送」粘贴社区个人设置页展示的验证码并保存一次即可
- 归属验证失败不影响内容推送:文章等内容同步照常进行,仅社区侧「站长」标识未生效
Full Changelog: v1.2.4...v1.2.5
NovaBlog CMS v1.2.4
NovaBlog CMS v1.2.4
本版本的核心是新增「社区推送」模块——CMS 内容一键同步到 NovaBlog 社区,并将官方站点地址收敛为统一托管,社区推送与主题市场共用同一入口。此外还带来部署脚本全面增强、首装部署密钥即时核验、GeoIP 数据文件后台下载与多架构镜像构建提速。
新特性
社区推送:CMS 内容一键同步到 NovaBlog 社区
- 「系统配置」新增「社区推送」页:维护官方站点地址、博客对外地址与推送密钥(
nbk_...,仅管理员接口可写、读取脱敏),支持一键测试连接;不配置即功能不启用,不影响其他模块 - 支持文章、旅行攻略、美食菜谱、摄影作品集、开源作品五类内容推送,推送时携带原文链接(
source_url)指回博客 - 同步时机:内容创建 / 更新 / 上下架后自动异步推送;删除自动同步社区下架;内容与状态均无变化时(hash 比对一致)自动跳过,不做无效请求
- 失败自动重试:后台每 5 分钟扫描同步失败记录并重推最新内容,单条最多重试 5 次后停止自动重试,等待博主在后台手动处理
- 管理端:五类内容的列表卡片与编辑页新增推送按钮(推送 / 重推 / 撤回,实时展示同步状态),支持查询推送记录
官方站点地址统一托管
- 官方站点地址收敛为单一权威来源(
community_push_configs单行表),后台「系统配置 → 社区推送」是唯一维护入口;社区推送与主题市场共用该地址 - 主题市场登录弹窗不再要求输入官方地址:由后端统一下发,弹窗展示当前官方地址并支持一键跳转修改(系统配置支持
?tab=深链定位) - 「博客 API 地址」设置弹窗同步简化,仅保留
public_api_base - 首装向导填写的官方地址同样写入统一配置,重启后依然生效
首装向导:部署密钥即时核验
- 部署密钥输入框失焦即调用新增的
POST /install/verify-code核验,内联展示校验结果,无需等到提交初始化才暴露错误 - 核验与初始化共享防爆破计数:失败次数与限流策略同
/install/init一致,不会被绕过
部署脚本(deploy.sh)增强
- 新增
--install-code <值|auto>:官方部署可指定首装安装码(防恶意抢先初始化),auto自动生成 UUID,写入 config 并在部署完成后摘要中展示;交互安装也会询问是否启用(自部署默认不启用) - 新增
--delete <名称>:彻底删除指定博客(容器与网络、宿主机反代配置、全部数据),必须交互键入博客名称确认,--yes不允许绕过 - docker-compose 新增应用级健康检查(
/health初始化完成后返回 200,start_period120s 宽限覆盖首次启动 GeoIP 联网下载),并映射host.docker.internal到宿主机网关(Linux 下容器可直连宿主机上的 PG/Redis)
变更
- GeoIP 数据文件缺失/损坏时转为后台下载并加载,不再阻塞启动;下载完成前访问日志的地区字段为空
- Dockerfile 构建阶段固定
$BUILDPLATFORM原生执行、Go 交叉编译替代 QEMU 模拟,多架构镜像构建时间从约 13 分钟缩短至约 2 分钟;CI 钉住 buildx/BuildKit 版本保持发布链路稳定 - README 重构完善并新增项目 Logo,清理仓库内历史设计文档
config.example.yaml:新增community.base_url出厂默认值;移除themes.market_base_url(存量值仍会被读取兜底,无需删除)- 旧版
theme_market_configs表的market_base_url列不再写入(AutoMigrate 不删列,保留只读作存量迁移兜底)
升级说明
- 无破坏性变更:升级后自动创建
community_push_configs、community_sync_records两张新表(AutoMigrate),无手动数据库操作 config.yaml无需改动:官方站点地址按「社区推送 DB 值 →community.base_url→ 旧版主题市场 DB 值 →themes.market_base_url」链路自动兜底,老配置原样可用;如需显式配置,参考config.example.yaml新增的community段- 未配置推送密钥时社区推送为未启用状态,主题市场、首装向导等其他功能不受任何影响
- 已有部署拉取新镜像重启即可,
config.yaml无需改动;部署脚本新增的--install-code、--delete与 compose 健康检查需使用仓库最新版deploy.sh/docker-compose.yml才生效
Full Changelog: v1.2.3...v1.2.4