DNSB

DNSBuilder 是用于构建与模拟 DNS 环境的工具，包含：

• CLI：完整功能，可直接从配置生成构建产物，支持容器管理
• API：基于 FastAPI，提供项目、构建、资源等接口；当前 UI 尚未完工
• DNSSEC：自动签名和密钥管理，透明集成
• 构建器服务模式：智能镜像复用，避免并发冲突

本文档帮助你快速了解、安装、使用与扩展 DNSB

端口与运行提醒

• 后端 API：
  • 执行 dnsb ui 将启动后端服务，默认地址为 http://localhost:8000
  • API 使用示例见 API使用 与 OpenAPI
• 文档预览：本地预览文档默认使用 http://localhost:8001（示例命令：mkdocs serve -a 127.0.0.1:8001）
• 端口占用：如 8000/8001 被占用，请关闭占用进程或临时调整预览端口以避免冲突

快速路径

• CLI 命令：查看CLI 命令参考了解所有可用命令和选项
• 文件路径与挂载：建议先阅读资源路径与文件系统的说明，了解 resource:/、相对/绝对路径的复制与挂载行为。详见文件路径与FS
• 快速开始：按要求安装后，参考快速开始，按示例运行 dnsb build config.yml
• 容器管理：使用 dnsb run、dnsb up、dnsb down 等命令管理容器生命周期
• DNSSEC 支持：查看 DNSSEC 文档了解自动签名功能
• 遇到问题请查看配置参考与FAQ，重点关注循环引用、模板使用与路径挂载等常见误区
• 需要在配置生成或修改阶段执行自定义逻辑时，使用 Auto 自动化脚本
• 想要理解配置的完整处理流程时，参考配置处理流程