netbox-cli连不上API主因是未配置NETBOX_TOKEN和NETBOX_URL环境变量或Token权限不足；需确保Token启用对应模块权限，URL含https://，且前缀状态为active才可调用available-ips接口。
Netbox安装后为什么netbox-cli连不上API？
默认安装的Netbox不自带命令行客户端，netbox-cli是第三方工具，需单独安装且必须匹配Netbox的API版本。常见错误是执行netbox-cli devices list时报401 Unauthorized或403 Forbidden——这基本是因为没配NETBOX_TOKEN环境变量，或Token权限不足。
- 用
curl -X GET https://your-netbox/api/dcim/devices/ -H "Authorization: Token YOUR_TOKEN"先手动验证Token是否有效 -
netbox-cli需通过export NETBOX_TOKEN=xxx和export NETBOX_URL=https://your-netbox设置，不能只写IP不加https:// - Web UI里生成Token时，务必勾选
dcim、ipam、virtualization对应权限，否则ip-addresses或prefixes接口会拒绝访问
用Python脚本批量创建IP地址时，available-ips接口返回空列表？
这不是Bug，而是Netbox的/api/ipam/prefixes/{id}/available-ips/接口只对未分配的前缀（status=active）生效，且要求该前缀下没有已分配的IP或已有IP但未填role字段。常见误操作是直接对container或reserved状态的前缀调用该接口。
- 先查前缀状态：
curl -s "$NETBOX_URL/api/ipam/prefixes/?prefix=10.20.30.0/24" | jq '.results[0].status.value'，确认返回active - 创建IP时必须显式指定
address（如"10.20.30.10/24"），不能只传IP段；assigned_object_type和assigned_object_id要成对出现，否则报Invalid data - 并发创建多个IP时，建议用
POST /api/ipam/ip-addresses/单条提交，避免available-ips接口因缓存延迟返回重复地址
Ansible如何把服务器网卡信息同步到Netbox设备接口？
关键在netbox.netbox.netbox_device和netbox.netbox.netbox_interface这两个模块的联动顺序——必须先确保设备存在（含device_role、site、platform），再创建接口，否则接口会因找不到归属设备而失败。
-
netbox_device中name字段必须全局唯一；若用FQDN作设备名，注意Netbox默认限制长度为64字符 - 接口名别硬写
eth0，用{{ ansible_facts['interfaces'] | first }}动态取值，避免不同发行版命名差异（如ens33或enp0s3） - 绑定IP时，
netbox_interface的form_factor参数要设为virtual（虚拟机）或1000base-t（物理口），否则Web UI里接口类型显示为空
用netbox-exporter拉取拓扑数据时Prometheus查不到netbox_device_status指标？
因为netbox-exporter默认只暴露基础指标，设备状态、IP使用率等需手动开启采集器。它不会自动读取Netbox的自定义字段或标签，所有拓扑关系都依赖dcim.device、dcim.interface、ipam.ipaddress三张表的关联查询结果。
- 启动exporter时加
--collectors=device,interface,ipaddress参数，否则device相关指标全为空 - 如果设备有大量未连接的接口（
connected=False），这些接口仍会被exporter拉取，但netbox_interface_connected指标值为0，需在Prometheus里用count by (device_name)(netbox_interface_connected == 0)过滤 - 拓扑图渲染依赖
netbox_interface_connected和netbox_interface_cable两个指标，后者需要Netbox开启Circuits插件并配置cable连接，否则永远是NaN
status字段和custom_fields的实际值，而不是只看API返回的HTTP状态码。 
