YAML 语法概览

只写需要修改的字段，不要复制整份订阅.

生成一个符合 YumeBox 语法的 YAML 覆写

已复制复制提示词

​

执行流程

1. 读取原始配置

   先解析订阅或本地配置.原始 YAML 错误会停止本次编译.

2. 读取覆写链

   按绑定顺序读取 .yaml 和 .yml 文件.空文件会跳过并记录提示.

3. 应用当前文件

   解析键名修饰符，再根据字段类型执行替换、追加、合并或强制覆盖.

4. 生成运行配置

   用户覆写完成后，YumeBox 才会补充运行时需要的 DNS、Tun、监听器和 Provider 路径设置.

​

修饰符速查

写法	作用	详细说明
key	普通写入.	对象递归、数组替换、标量覆盖.
key-start	插入列表开头.	列表与规则
key-end	追加列表末尾.	列表与规则
key-merge	合并对象或追加列表项.	字段行为
key-force	直接替换整个字段.	字段行为
+key	key-start 简写.	列表与规则
key+	key-end 简写.	列表与规则
<key>	保留字面量键名.	示例与排错

显式的 -start、-end、-merge、-force 优先于 +key 和 key+.例如 <rules+> 最终写入真实键名 rules+.

​

最小示例

修改端口.yaml

mixed-port: 7890

添加规则.yaml

rules-start:
  - DOMAIN-SUFFIX,lan,DIRECT

替换 DNS.yaml

dns-force:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - 1.1.1.1