第 23 期 · M4 CDN 刷新与备份
· 阅读需 4 分钟
M4 第四部分:玩家换了皮肤,CDN 会自动丢掉旧缓存;站点可以用一条命令备份,再用一条命令恢复。
CDN 刷新(ADR 0032)
BS 用 refresh-ali-cdn、refresh-qcloud-cdn 等插件做这件事。SkinLoom 内置了它,而且直接用上了上一轮审查加的领域事件:角色创建、改名、换装、删除都会发出事件,CDN 模块订阅这几个事件,刷新这个角色的 6 个地址(CustomSkinLoader、UniSkinMod、旧版 PNG 和头像),改名时新旧名字都刷新。材质被删除或改为私有时,被脱下的角色本来就会发出"角色已更新",不用另外处理。
支持 Cloudflare、阿里云 CDN、腾讯云 CDN,其它 CDN 可以用 Webhook 接入。两家云厂商的签名是最容易出错的部分,测试直接用了官方文档里的示例:阿里云比对最终签名;腾讯云示例的 SecretKey 打了码,就从请求体哈希、规范请求哈希、派生密钥到最终签名逐步核对。写测试时还发现,起初按记忆写的腾讯云示例数据是错的,最后按文档页面上的原始数据改正。
刷新失败时返回错误,由任务队列按 1、5、15、60 分钟重试。只有配置了 CDN 才注册事件处理器:没有处理器时事件根本不会写进队列,所以不用 CDN 的站点没有任何额外开销。在后台改设置就能开关,不用重启。
备份与恢复
skinloom backup把 SQLite 数据库、配置、密钥和材质打成一个.tar.gz。数据库用VACUUM INTO复制,站点不用停;打开数据库时不执行迁移,升级前做的备份保持原样。--keep N只保留最新几份,定时备份交给 cron 或计划任务。- MySQL 和 PostgreSQL 不导出数据库,交给它们自己的
mysqldump/pg_dump,那些工具更可靠。 skinloom restore只认识清单、配置、密钥、数据库和材质这几种条目,带../的条目会被拒绝,写不到数据目录以外。目标已经有站点时要加--force。材质通过存储层写入,本地备份可以恢复到 S3,反过来也行。
验证
- 新测试:两家云的签名示例;四个服务商的假服务端(分批、鉴权失败、签名错误);CDN 模块随设置注册与移除处理器;手动刷新接口(未配置 409、服务商拒绝 502);在运行中的站点上备份,恢复到空目录后设置、材质、密钥都一致,重复恢复被拒绝,
--force可以覆盖;--keep清理旧文件;恶意条目名被拒绝。 go fmt、go vet,完整的go test ./...(SQLite 与 PostgreSQL);前端类型检查、单元测试与生产构建。- 实际跑了一遍:用一个本地 HTTP 服务充当 CDN 的 Webhook,在运行中的站点上创建角色 Steve、改名为 Alex。几秒内通过任务队列先后收到 6 个和 12 个地址的刷新请求,手动刷新又收到 6 个,每个请求都带签名。随后在站点运行时执行
skinloom backup,恢复到新目录,恢复出来的站点名、CDN 设置和管理员令牌都与原站一致;再恢复一次被拒绝。
仍未验证
- 没有接真实的 Cloudflare、阿里云、腾讯云账号,只用官方示例和假服务端验证了签名与请求格式。
- 实际运行的站点里没有材质,材质的备份恢复只在测试里验证过。
- MySQL、staticcheck、govulncheck 交给 CI。
下期计划
M4 最后一部分:Helm、skinloom service install,以及四种部署方式按文档从零部署一遍。