例とトラブルシューティング

このページには、直接保存できる完全なオーバーライドと、一般的なエラーの実際的な予想が表示されます。

ポートとモードを変更する

基础字段.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

`reality-opts.short-id`

DreamBox は、最上位の proxies リスト内の reality-opts.short-id の文字列値を保護します。こうすることで、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 アンカーと `<<`

`reality-opts.short-id`

リテラルキー

複数の上書きファイル

空のファイル

YAML 解析エラー

ルートの種類が間違っています

`geosite-matcher` 検証エラー

実行時の境界

​ポートとモードを変更する

​DNS を変更する

​再帰的変更

​完全交換

​直接接続ルールを追加する

​プロバイダーを追加

​ポリシーグループを変更する

​YAML アンカーと <<

​reality-opts.short-id

​リテラルキー

​複数の上書きファイル

​空のファイル

​YAML 解析エラー

​ルートの種類が間違っています

​geosite-matcher 検証エラー

​実行時の境界

ポートとモードを変更する

DNS を変更する

再帰的変更

完全交換

直接接続ルールを追加する

プロバイダーを追加

ポリシーグループを変更する

YAML アンカーと `<<`

`reality-opts.short-id`

リテラルキー

複数の上書きファイル

空のファイル

YAML 解析エラー

ルートの種類が間違っています

`geosite-matcher` 検証エラー

実行時の境界