跳到主要内容

导入与导出

对应后台:Web 设置进阶导入与导出

这一页用于复制当前站点配置包,或者把其他环境导出的配置包应用到当前站点。

导出结果是 Base64 编码的 JSON
导入时会解析这段配置包,并把其中受支持的字段覆盖到当前表单里。

注意

应用配置包后,还需要点击页面底部的「保存配置」才会真正写入站点配置。
如果只是点了「应用配置包」然后刷新页面,普通设置可能不会保存。

主要功能

  • 复制当前站点配置包
  • 应用来自其他环境的配置包
  • 迁移时保留现有配置,便于对照和回滚

复制当前配置包

点击「复制当前配置包」后,系统会把当前站点配置导出,并复制到剪贴板。

这个配置包可以用来:

  • 修改设置前留一份备份
  • 把本地调好的配置复制到服务器
  • 把测试环境配置同步到正式环境
  • 从旧部署迁移到新部署时保留外观和行为设置
提示

如果你准备大改主题、背景图、规则或运行时行为,建议先复制一次配置包。
这样改坏了还有东西可以贴回去,心态会稳定很多x

应用配置包

点击「应用配置包」后,会弹出输入框。

一般流程是:

  1. 粘贴之前复制出来的 Base64 配置包
  2. 点击「应用配置包」
  3. 检查页面上的设置是否符合预期
  4. 点击底部「保存配置」

应用后,配置会先进入当前表单状态。
也就是说,在真正保存之前,你还可以继续调整,或者撤销本次改动。

会覆盖什么

导入会覆盖受支持的站点配置字段。

一般包括:

  • 基础资料,例如网页标题、首页名称、简介、备注
  • 前台展示设置,例如过渡加载、平滑滚动、一言、字体选项
  • 主题和背景相关配置
  • 运行时行为,例如活动展示、状态卡片、更新方式、Steam 配置等
  • 规则工具配置,例如应用文案规则、黑白名单、媒体来源规则

如果配置包里包含当前版本不支持的字段,通常会被忽略。

不会完整迁移什么

配置包不是完整数据库备份。

它不等同于迁移整个站点,一般不会完整包含:

  • 活动历史记录
  • 设备列表和审核状态
  • API Token 明文
  • 管理员账号密码
  • 上传资源的原始存储环境
  • 数据库里的全部业务数据
注意

页面锁密码在导入时会被清空,不会直接沿用配置包里的值。
导入后如果需要页面锁,请重新填写密码并保存。

关于图片和资源

配置包可以带上图片地址或相关配置,但它不一定能保证图片资源在新环境里一定可用。

例如:

  • 如果配置里是远程图片 URL,新环境需要能访问这个 URL
  • 如果配置里是本站上传资源,新环境需要对应资源仍然存在
  • 如果你换了存储方式或域名,旧图片地址可能需要重新上传或替换

所以迁移后建议重点检查头像、网页图标、背景图、状态卡片头图等内容。

适合的使用方式

比较推荐:

  • 同版本或相近版本之间迁移配置
  • 做主题备份
  • 在本地调好前台样式后同步到线上
  • 修改运行时或规则前先留一份配置

不太推荐:

  • 跨很多版本直接导入旧配置包
  • 把它当作完整备份方案
  • 在不了解内容的情况下导入别人给的配置包

如果跨版本跨度比较大,建议先升级旧环境,再复制配置包。

导入失败怎么办

如果提示配置包无效,可以检查:

  • 是否完整复制了整段 Base64
  • 中间是否混入了多余文字
  • 是否来自 Waken-Wa 的站点配置导出
  • 配置包版本是否过旧

如果导入成功但效果不对,先不要保存,可以直接撤销本次未保存更改,或者重新粘贴之前备份的配置包。