Skip to content

这个区块是干什么的

编辑器的「远程配置文件」区块,负责把你在配置项里填的内容生成一份 OSS 配置文件。把这份文件放到你自己的资源存储(OSS)上,客户端每次启动时都会去拉取它,按里面的内容确定站点地址、站点列表和更新提示。

区块的标题与副标题(界面原文):

远程配置文件

按配置项生成 OSS 配置文件,可直接下载使用;如需更高安全性,再执行 AES-256-GCM 加密。

区块分成两个页签:

  • 配置项表单:填写面板类型、官网地址、站点分组名称、站点列表和静态更新配置,表单会实时生成 OSS 配置文件
  • 「remote.config.json 源码」:实时显示当前将要导出的最终 JSON,提交打包前可以在这里核对格式和字段,也可以直接复制或下载。

每个字段具体怎么填,见远程配置与 OSS;密钥与加密的更多说明见加密与密钥

操作流程

界面里给出的操作流程是四步,原文如下。

1. 填写配置项

直接填写面板类型、官网地址、站点分组名称、站点列表和静态更新配置,系统会实时生成 OSS 配置文件

2. 检查源码预览

上方「remote.config.json 源码」页签会实时显示最终 JSON,提交前可先核对格式和字段。

3. 按需加密配置文件(角标 推荐操作

首次加密建议点击「生成密钥并加密配置文件」;如果是后续更新配置,直接填写已保存的密钥,再点击「使用当前密钥加密」。

4. 保存密钥并下载配置文件

如果不需要加密,可直接下载 OSS 配置文件;若已加密,请保存好密钥,并将它填写到远程配置源的「加密密钥(可选)」中。

提示

不需要加密时,第 3 步可以整段跳过:直接点「下载配置好的 JSON」拿到未加密的 OSS 配置文件 就能用。加密只是给配置多加一层保护,不是必做步骤。

可用按钮逐个说明

  • 下载配置好的 JSON:下载当前表单生成的未加密 OSS 配置文件,文件名就是 remote.config.json。在「remote.config.json 源码」页签里,同一个动作的按钮叫「下载 JSON」,两者下载的是同一份内容。
  • 生成密钥并加密配置文件:由系统随机生成一把新密钥,自动填入「加密密钥(Base64,32字节)」框,并用它加密当前配置。如果密钥框里原本已经有内容,会先弹出确认:「当前已填写密钥,继续将生成新的密钥并覆盖当前输入。若你是要复用旧密钥进行二次加密,请点击“使用当前密钥加密”。确定继续吗?」——要沿用旧密钥就点「取消」,改走下一个按钮。加密完成后的提示原文:「已生成新密钥并完成加密。请先复制保存密钥,再下载加密后的配置文件上传到 OSS,并将该密钥填写到远程配置源的“加密密钥(可选)”中。」
  • 使用当前密钥加密:用密钥框里已经填好的那把密钥加密当前配置,适合更新已有配置时沿用同一把密钥,避免新旧两份文件对不上。密钥框为空时会提示:「请先填写已保存的密钥;如果是首次加密,请点击“生成密钥并加密配置文件”。」密钥填错会提示「当前密钥无效:密钥长度错误:需要 32 字节,当前 N 字节」或「当前密钥无效:Base64 格式无效」。
  • 下载加密后的配置文件:把加密结果下载下来,文件名同样是 remote.config.json,内容是加密后的文本。还没执行过加密就点它会提示:「请先执行加密,生成可下载的加密配置文件。」
  • 复制源码:把当前 OSS 配置文件 源码复制到剪贴板;成功提示「remote.config.json 源码已复制到剪贴板。」,失败提示「复制源码失败,请手动复制。」

同一区块还有几个按钮:

  • 保存当前配置:把当前内容存进下方的「最近保存记录」,方便以后载入。
  • 上传配置文件:把一份未加密的 JSON 读回表单继续编辑。上传时不要求文件名必须叫 remote.config.json,系统会按文件内容识别;文件缺少 panels 字段会提示「配置文件缺少 panels 字段,请上传未加密的 remote.config.json」。
  • 复制密钥:把「加密密钥(Base64,32字节)」框里的密钥复制走。加密完成后请第一时间点它,把密钥存到自己的密码管理器或安全的地方。

最近保存记录

原文说明:「仅保留当前浏览器最近保存的 10 条 remote.config.json 记录,可直接载入、下载或删除。」

注意

这些记录保存在你当前使用的这个浏览器里,不是跟着激活码走的。换一台电脑、换一个浏览器,或者清理了浏览器数据,记录就会消失。需要长期保留的配置,请及时点「下载 JSON」存到本地。

密钥只有一次保存机会

重要

加密用的密钥不会跟着「最近保存记录」一起存下来:那 10 条记录里只有未加密的配置内容,没有密钥。密钥只显示在「加密密钥(Base64,32字节)」输入框里,离开当前浏览器或清掉浏览器数据就再也找不回来了。

密钥一旦丢失,已经加密的 OSS 配置文件 就再也打不开,也无法继续用同一把密钥加密新内容,只能重新加密一遍:把密钥框清空,点「生成密钥并加密配置文件」拿到一把新密钥,立刻点「复制密钥」保存好,再点「下载加密后的配置文件」重新上传到 OSS,最后把新密钥填写到远程配置源的「加密密钥(可选)」里。旧密钥加密的那份文件请直接替换掉。

相关页面

本文档依据 Xboard-Mihomo-builds 源码整理