Skip to main content
このページはリスト修飾子専用です.すべての例では、対応するフィールドが元の構成にすでに存在していることを前提としています.

key-start

元のリストの先頭に配列項目を挿入します.
插入列表开头.yaml
key-start 结果 diff.yaml
間違った使用法または無効な使用法:
key-start 无效类型.yaml
これら 2 つの項目はエラーを報告しませんが、mixed-port はスカラーであり、dns はオブジェクトであるため、リストの挿入は行われません.

key-end

配列項目を元のリストの末尾に追加します. rules の場合、元の構成のターミナル MATCH セクションは新しいコンテンツの後に残ります.新しいコンテンツの内部順序は変更されません.
追加列表末尾.yaml
key-end 结果 diff.yaml
間違った使用法または無効な使用法:
key-end 无效类型.yaml
mode はスカラーであり、mode-end はそれをリストに変換せず、mode をオーバーライドしません.

key-merge

key-merge では、フィールドの種類ごとに異なる結果が得られます.

リストの追加

key-merge 列表.yaml
key-merge 列表结果 diff.yaml

マップのマージ

key-merge 映射.yaml
key-merge 映射结果 diff.yaml
間違った使用法または無効な使用法:
key-merge 标量.yaml
mixed-port はスカラーであり、key-merge は無視され、ポートはオブジェクトに変換されません.

key-force

key-force はフィールド全体を直接置き換え、フィールド タイプの処理をスキップします.元のリストのクリア、オブジェクト全体の置換、または未知の構造の上書きに適しています.
key-force 列表.yaml
key-force 结果 diff.yaml
同じ基本キーに対して同時に複数の操作がある場合は、force が優先されます.
force 优先.yaml
最終的には MATCH,PROXY だけが残り、rules-start は実行を継続しません.

略語

これら 2 つの記述方法は、リスト操作の短縮形です.
列表简写.yaml
列表简写结果 diff.yaml
間違った使用法または無効な使用法:
简写用于标量.yaml
+modemode+ はリスト操作としてのみ認識され、スカラー mode は変更されません.

null リスト項目

リスト修飾子の値は、単一の値、配列、または null にすることができます.
null 列表项.yaml
最終的には DOMAIN-SUFFIX,example.com,DIRECT のみが挿入されます.

複数の操作のシーケンス

同じ YAML ファイルに対して複数の操作を同時に使用できます.リストフィールドの順序は次のとおりです.
多个列表操作.yaml
多个列表操作结果 diff.yaml
同じベースキーに key-force も存在する場合、上記の操作はすべてスキップされます.

MATCH ルール

元のリスト内の最初のコンマ区切りセグメントが MATCH (大文字と小文字を区別しない) である文字列のみが終端ルールとして認識されます.オブジェクト、数字、その他のルールは動きを引き起こしません.ファイルの上書きによって追加されたルールは再度スキャンされません.
终端规则判断.yaml
DreamBox は、元のリストの最初に認識された位置から開始し、後続のコンテンツを終端ルール セグメントとして最後に保持します.
最終更新日 2026年8月14日