用途：把 NetBox 作为基础设施文档与 IPAM 的真实来源，并通过 netbox-powerdns-sync 插件自动生成和同步 DNS 记录。
主要能力：查询 NetBox 中的站点、设备、VM、IP、前缀、VLAN；创建带自动或指定 IP 的 VM；执行可用 IP、前缀利用率和 IP 分配查询；校验 DNS 命名；配置 PowerDNS 同步；使用 Terraform NetBox provider 和 Ansible 动态清单。
使用方式示例： ./tools/netbox_api_client.py sites list ./tools/netbox_api_client.py ips query --dns-name docker-01 ./tools/netbox_ipam_query.py available --prefix 192.168.3.0/24 ./tools/validate_dns_naming.py --name "docker-01-nexus.spaceships.work" pip install netbox-powerdns-sync ansible-playbook -i tools/netbox-dynamic-inventory.yml deploy-from-netbox.yml
DNS 命名遵循 <service>-<number>-<purpose>.<domain> 模式，如 docker-01-nexus.spaceships.work。同步依赖 NetBox 中 IP 的标签与区域标签规则匹配，启用 post_save_enabled 可实时同步。
适用场景：NetBox IPAM 搭建、PowerDNS 自动同步、VM 管理、Terraform/Ansible 集成、从手工表格迁移到 NetBox、故障排查。
限制：需已部署 NetBox 与 PowerDNS，并具备有效 API Token 和插件安装权限；具体版本兼容性、权限和数据以实际环境为准。