Примеры и устранение неполадок

На этой странице показано полное переопределение, которое можно сохранить напрямую, а также практические рекомендации по устранению распространенных ошибок.

Изменить порт и режим

基础字段.yaml

mixed-port: 7890
mode: rule

基础字段 diff.yaml

mixed-port: 10801
mixed-port: 7890
mode: global
mode: rule

mixed-port и mode являются скалярами, а обычные ключи напрямую перезаписывают исходные значения.

Изменить DNS

Рекурсивная модификация

DNS 子字段.yaml

dns:
  enable: true
  enhanced-mode: fake-ip

DNS 子字段 diff.yaml

dns:
  enable: false
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - 223.5.5.5

Полная замена

DNS 完整替换.yaml

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

dns-force удалит другие поля исходного объекта dns, оставив только указанное выше содержимое.

Добавляем правила прямого подключения

添加直连规则.yaml

rules-start:
  - DOMAIN-SUFFIX,baidu.com,DIRECT
  - DOMAIN-SUFFIX,tencent.com,DIRECT

添加直连规则 diff.yaml

rules:
  - DOMAIN-SUFFIX,baidu.com,DIRECT
  - DOMAIN-SUFFIX,tencent.com,DIRECT
  - DOMAIN-SUFFIX,old.example,PROXY
  - MATCH,PROXY

Добавить провайдера

添加规则 Provider.yaml

rule-providers-merge:
  local:
    type: http
    behavior: domain
    format: yaml
    interval: 86400
    url: https://example.com/local.yaml
    path: ./ruleset/local.yaml

rules-end:
  - RULE-SET,local,PROXY

Исправление среды выполнения нормализует путь поставщика к текущему каталогу конфигурации, чтобы предотвратить выход относительных путей за пределы области конфигурации.

Изменить группу политик

修改策略组.yaml

proxy-groups-end:
  - name: PROXY
    type: select
    proxies:
      - DIRECT

修改策略组 diff.yaml

proxy-groups:
  - name: PROXY
    type: url-test
    proxies: 
      - AUTO
  - name: PROXY
    type: select
    proxies: 
      - DIRECT

Якоря YAML и `<<`

Перезаписанный файл сначала расширит привязки, псевдонимы и ключи слияния << с помощью анализатора YAML.

使用锚点.yaml

provider-default: &provider-default
  type: http
  interval: 86400
  behavior: domain
  format: yaml

rule-providers-merge:
  example:
    <<: *provider-default
    url: https://example.com/rules.yaml
    path: ./ruleset/example.yaml

Явные поля имеют приоритет над содержимым привязки:

锚点覆盖结果 diff.yaml

example:
  type: http
  interval: 86400
  behavior: domain
  format: yaml
  url: https://example.com/rules.yaml
  path: ./ruleset/example.yaml

ДЕРЖАТЬ_101

YumeBox защищает строковое значение reality-opts.short-id в списке proxies верхнего уровня. Таким образом, 0123 и 1e5 не будут анализироваться YAML как числа.

Reality short-id.yaml

proxies-end:
  - name: 示例节点
    type: vless
    server: example.com
    port: 443
    reality-opts:
      short-id: 0123

Reality short-id 预期.yaml

reality-opts:
  short-id: "0123"

short-id, вложенный в другие пользовательские объекты, не активирует эту частную защиту.

Литеральные ключи

Угловые скобки отключают анализ модификаторов и удаляют угловые скобки во время компиляции:

字面量键.yaml

<rules+>:
  enabled: true

字面量键结果 diff.yaml

rules+:
  enabled: true

Если rules+ не упакован, он будет разобран и добавлен к rules; только после переноса будет записано поле с именем rules+.

Несколько перезаписанных файлов

Перезаписанные файлы выполняются в порядке привязки в подписке, и последний файл может изменять результаты предыдущего файла.

第一个覆写.yaml

mixed-port: 7890
rules-start:
  - DOMAIN-SUFFIX,first.example,DIRECT

第二个覆写.yaml

mixed-port: 7891
rules-end:
  - DOMAIN-SUFFIX,last.example,DIRECT

覆写链最终 diff.yaml

mixed-port: 7890
mixed-port: 7891
rules:
  - DOMAIN-SUFFIX,first.example,DIRECT
  - DOMAIN-SUFFIX,original.example,DIRECT
  - DOMAIN-SUFFIX,last.example,DIRECT
  - MATCH,PROXY

Пустой файл

Пустые файлы или файлы, содержащие только пробельные символы, будут пропущены, а конфигурация не будет изменена:

空覆写.yaml

Результат компиляции будет успешным, но в предупреждениях появится skip empty override file.

Ошибка анализа YAML

Ошибки отступов, недопустимые сопоставления или незамкнутые строки остановят текущую цепочку перезаписи:

错误的缩进.yaml

proxy-groups:
  -
  name: PROXY

Ожидаемые результаты:

parse yaml override <覆写文件路径>: <YAML 解析错误>

В сообщении об ошибке будет указан путь к перезаписанному файлу, и последующая перезапись не будет продолжена.

Неправильный тип корня

Если верхний уровень YAML не является объектом, механизм переопределения заменяет корневую конфигурацию этим значением; компилятор затем отклоняет его:

错误的根类型.yaml

- this-is-a-list

Ожидаемые результаты:

compiled root config must be an object

`geosite-matcher` Ошибка проверки

Само переопределение может записывать строки, но финальная проверка принимает только mph и succinct:

错误的 Matcher.yaml

geosite-matcher: unknown

Ожидаемые результаты:

geosite-matcher must be one of: mph, succinct

Границы времени выполнения

После завершения перезаписи пользователя YumeBox по-прежнему будет выполнять исправления во время выполнения:

Сценарий	Финальное действие
DNS не включен	Дополнительный DNS по умолчанию, `fake-ip` и фильтры.
`Vpn Service` или `eBPF`	Выключите `tun.enable`, `auto-route` и `auto-detect-interface`.
`Tun`	Сохраняет настройки Tun в конфигурации.
`listeners`	Удалите прослушиватели типов `redir` и `tun`.
Предварительный просмотр конфигурации	Очистите порты, прослушиватели и записи Tun.

Таким образом, успешная перезапись не означает, что все поля станут окончательными текущими значениями; настройки, связанные с режимом бега, можно отрегулировать, применив патч в конце.

Начало

Руководства

Переопределения

Другое

Примеры и устранение неполадок

Изменить порт и режим

Изменить DNS

Рекурсивная модификация

Полная замена

Добавляем правила прямого подключения

Добавить провайдера

Изменить группу политик

Якоря YAML и `<<`

ДЕРЖАТЬ_101

Литеральные ключи

Несколько перезаписанных файлов

Пустой файл

Ошибка анализа YAML

Неправильный тип корня

`geosite-matcher` Ошибка проверки

Границы времени выполнения

​Изменить порт и режим

​Изменить DNS

​Рекурсивная модификация

​Полная замена

​Добавляем правила прямого подключения

​Добавить провайдера

​Изменить группу политик

​Якоря YAML и <<

​ДЕРЖАТЬ_101

​Литеральные ключи

​Несколько перезаписанных файлов

​Пустой файл

​Ошибка анализа YAML

​Неправильный тип корня

​geosite-matcher Ошибка проверки

​Границы времени выполнения

Изменить порт и режим

Изменить DNS

Рекурсивная модификация

Полная замена

Добавляем правила прямого подключения

Добавить провайдера

Изменить группу политик

Якоря YAML и `<<`

ДЕРЖАТЬ_101

Литеральные ключи

Несколько перезаписанных файлов

Пустой файл

Ошибка анализа YAML

Неправильный тип корня

`geosite-matcher` Ошибка проверки

Границы времени выполнения