跳到主要内容

第 27 期 · M5 导入站点设置与密钥

· 阅读需 5 分钟

M5 第二部分完成。skinloom import bs 现在还会带过来站点设置、邮件设置、改过的常用称呼、OAuth 应用和 Yggdrasil 签名密钥。导入后不用再到后台重填一遍,游戏服务器也不用重启。

带过来什么(ADR 0036)​

  • 站点设置:站点名称、简介、公告、地址、版权文字、注册与邮箱验证、reCAPTCHA、角色名规则、积分与签到、材质大小与命名规则、自定义 CSS、关键词、Yggdrasil 选项。BS 给每种语言单独存的版本(site_name_en 这类),中文和英文分别导入。
  • 邮件:BS 的邮件设置在 .env 里,用 --env 导入时一起带过来。加密方式按 Laravel 的规则换算:465 端口用 TLS,其它端口用 STARTTLS。
  • 改过的称呼:站长最常改的是"积分"(改成"金币"之类)、"皮肤库"、"衣柜"这些词。导入器有一张人工整理的对照表,这些词在 SkinLoom 里每个单独显示的地方都会换掉。
  • OAuth 应用:ID、所有者、密钥、回调地址都不变,第三方应用不用改配置。BS 存的是明文密钥,SkinLoom 只存它的哈希。
  • 签名密钥:yggdrasil-api 插件的私钥原样导入,公钥不变,用 authlib-injector 的服务器不用重启。

几个决定​

  • 每个值都过一遍 SkinLoom 自己的校验。 映射出来的值交给目标设置的校验器检查,与后台保存时一样。超出范围的改为最接近的允许值,比如材质宽度 4096 改为 2048;不合格的保留 SkinLoom 的默认值。两种情况都写进报告。
  • PHP 的取值规则照搬。 BS 默认的 score_per_storage 存的是字符串 'true',PHP 转成整数是 1,导入后也是 1。BS 实际怎么用这个值,SkinLoom 就怎么用。
  • 翻译不做自动匹配。 SkinLoom 的界面文字是重写的。按文字自动匹配,BS 的 824 个键里只有几十个对得上,而且多是巧合,错配会悄悄改掉不相关的地方。所以只换对照表里的常用词,其它改过的文字逐条列在报告里,到翻译页重新改。
  • BS 的正则换成 Go 的写法。 自定义的角色名、材质名规则是 PCRE,SkinLoom 用 RE2。分隔符和 i、m、s 标志会转换,用了反向引用、环视的保留默认规则,并警告。
  • 只报告站点改过的选项。 与 BS 默认值相同的选项,SkinLoom 即使没有对应的设置也不出现在报告里,报告只留站长需要看的东西。

测试​

  • 密码兼容向量(02 §6 第 3 条):BS 的十种密码方法,分别配空盐、普通盐、带逗号和中文的盐,一共 30 组。每组都要能登录、要求升级到 argon2id、拒绝错误的密码。
  • 迁移回归库(第 4 条):上一期的脏数据站点加上设置、翻译和 OAuth 应用,整份导入报告与一个黄金文件比较。导入器行为的任何变化都会显示为这个文件的 diff。
  • PostgreSQL 与 MySQL 源加上了 language_lines 和 oauth_clients:group、key 在 MySQL 里是保留字,要加反引号。
  • 端到端:编译好的程序把一个 SQLite 的 BS 站导入 PostgreSQL,导入前 SkinLoom 先启动过一次,已经生成了自己的密钥。之后启动后端:
    • Yggdrasil 元数据的公钥与 BS 的私钥配对;
    • 中英文的站点名称、公告、"金币"都对;
    • 论坛应用用原来的密钥通过了客户端认证,错误的密钥被拒绝;
    • BS 的加盐 MD5 密码能登录。

测试发现的问题​

  • 选项表里没有 announcement 时,BS 的默认值是带 {version} 占位符的原文,以前会被当成公告导入。PostgreSQL 的测试库里残留的一行暴露了这个问题,顺带发现测试清理没有清空设置表。
  • 没有一种语言有文字的多语言设置,以前写成空值:保留了 BS 默认简介的站点,导入后 SkinLoom 的简介是空的。现在保留默认值。回归报告里的设置数由 8 变成 7,正是这一处。
  • 发件人名字是中文时,Go 的地址格式化会编码成 =?utf-8?q?...?=,后台就显示成这样。现在存成 "老皮肤站" <noreply@example.com>,发信时再编码。

还没有的​

  • 其它插件的表(邀请码、正版验证等)以后按插件逐个提供转换。
  • 02 §6 要的是一个真实 BS 库的脱敏副本,拿到之前先用这份构造的回归库。

下期计划​

M5 第三部分:契约测试全量,包括黄金文件、authlib-injector 端到端和渲染快照。