Repository navigation
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