概览¶
本页提供编写 DNSBuilder 配置的最简路径：按“顶层 → 镜像 → 服务”的顺序搭建项目，其余细节在对应页面展开
结构与职责¶
- 顶层配置：项目名称、网络段、镜像与服务的集合（入口）
- 镜像配置：内部镜像(决定软件类型与构建环境)/外部镜像(社区或用户自定义镜像)
- 服务配置：具体容器的运行参数，支持标准模板与行为脚本
最小可用示例¶
name: demo
inet: 10.88.0.0/24
builds: {}
核心约束（速览）¶
- 镜像与服务：必须使用字典格式，不再支持列表展开
- 镜像：
ref与software/version/from互斥；镜像名不可重复且不能含冒号 - 服务：需要
image或ref；使用std:模板时必须提供image - 引用：同级
ref支持链式继承；出现循环或未知引用会报错 - include：支持相对、绝对与
resource:/路径；按深度合并策略整合配置 - auto：支持在三个阶段（setup、modify、restrict）执行 Python 脚本来动态管理配置