后端网络数据建模【免费下载链接】netboxThe premier source of truth powering network automation. Open source under Apache 2. Try NetBox Cloud free: https://netboxlabs.com/products/free-netbox-cloud/项目地址https://gitcode.com/gh_mirrors/ne/netbox点击查看免费下载ASN Range自治系统号段是 NetBox IPAM 模块中用于按数值区间归组并自动供给 AS 号的建模工具本文以官方模型文档为核心结合netbox/ipam/models/asns.py、字段定义与查询集源码系统讲解 ASN Range 的字段语义、边界校验、ASDOT 表示法、可用号查询、过滤检索与 REST API帮助读者在 NetBox 中落地 BGP 自治系统号的空间管理与自动化分配。一、为什么需要 ASN Range在 BGP 网络中每个自治系统Autonomous System由唯一编号 ASN 标识。NetBox 支持 16 位与 32 位两种 ASN并且要求 ASN 在系统内全局唯一见 ASNs 模型文档。当一个组织从 RIR如 ARIN、RIPE、APNIC、LACNIC、AFRINIC申请到一段连续的 AS 号或为内部规划保留一段号段时逐个手工登记不仅繁琐也难以直观掌握哪些号已用、哪些号可分配。ASN Range 正是为此设计将一段连续的 AS 号定义为闭区间[start, end]并关联到负责该号段分配的权威机构RIR从而实现对 AS 号空间的成组管理与自动供给automatic provisioning。每个 ASN Range 都必须归属于一个 RIR——RIR 既可以是五大区域性互联网注册机构也可以是把 RFC 1918、RFC 6598 等保留地址空间视为所有者的自定义机构。二、字段详解官方模型文档 asnrange.md 定义了 ASN Range 的核心字段其底层实现位于 asns.py。Name一个人类可读且全局唯一的名称用于标识该号段的用途或来源。源码实现asns.pyname models.CharField( verbose_name_(name), max_length100, uniqueTrue, db_collationnatural_sort )最长 100 字符uniqueTrue保证全局唯一db_collationnatural_sort使列表按自然排序数字部分按数值而非字典序排列默认排序即Meta.ordering (name,)。Slug一个全局唯一、URL 友好的标识符由名称自动生成如asn-range-64512-65534。文档特别指出该值可以用于过滤filtering例如通过 REST API 的?slug查询参数精确检索。slug models.SlugField( verbose_name_(slug), max_length100, uniqueTrue )RIR负责该号段内 AS 号分配的区域互联网注册机构或类似权威机构即 RIR 模型文档 中描述的对象。rir models.ForeignKey( toipam.RIR, on_deletemodels.PROTECT, related_nameasn_ranges, verbose_name_(RIR) )使用PROTECT约束只要存在关联的 ASN Range该 RIR 便不可被删除防止号段记录悬空反向关系名为asn_ranges可通过rir.asn_ranges.all()获取其下全部号段。Start End号段的起始与结束 AS 号闭区间包含两端。二者使用自定义字段ASNField定义于 fields.py# BGP ASN bounds BGP_ASN_MIN 1 BGP_ASN_MAX 2**32 - 1 class ASNField(models.BigIntegerField): description 32-bit ASN field default_validators [ MinValueValidator(BGP_ASN_MIN), MaxValueValidator(BGP_ASN_MAX), ]关键约束约束取值依据最小值10 为保留不参与分配BGP_ASN_MIN最大值42949672952³²−1BGP_ASN_MAX底层类型64 位整数BigIntegerFieldASNField继承同时模型层在clean()中强制校验区间合法性asns.pydef clean(self): super().clean() if self.end self.start: raise ValidationError( _(Starting ASN ({start}) must be lower than ending ASN ({end}).).format( startself.start, endself.end ) )即起始号必须严格小于结束号不允许空区间或倒序区间。这意味着start end的单号段也无法直接通过校验——如需登记单个 AS 号应使用 ASN 模型 而非 Range。三、源码级实现模型方法解析ASNRange继承OrganizationalModel组织模型基类自动附带description、comments、tags、custom_fields、created、last_updated、owner等通用字段并额外挂载tenant外键可空指向 tenancy.Tenant实现多租户隔离下的号段管理。除字段外模型提供了丰富的辅助方法asns.py方法/属性作用range返回 Pythonrange(start, end 1)整数序列用于枚举号段内全部 AS 号range_as_string()返回64512-65534形式的字符串start_asdot/end_asdot返回大于 16 位≥ 65536的 AS 号的 ASDOT 表示range_as_string_with_asdot()结束号 ≥ 65536 时附带 ASDOT 标注如65536-131071 (1.0-1.65535)get_child_asns()查询落在区间内的所有 ASN 对象get_available_asns()返回区间内尚未被使用的可用 AS 号列表ASDOT 表示法对 32 位 AS 号社区常用 ASDOT 形式high.low提高可读性。NetBox 的实现位于 fields.pystaticmethod def to_asdot(value) - str: if value is None: return if value BGP_ASN_ASDOT_BASE: # BGP_ASN_ASDOT_BASE 2**16 hi, lo divmod(value, BGP_ASN_ASDOT_BASE) return f{hi}.{lo} return str(value)例如AS 65536显示为1.0AS 131071显示为1.65535。这是 NetBox 对 32 位 AS 号的标准展示方式同时体现在 ASN 模型 的asn_with_asdot属性中如AS 65536 (1.0)。四、AS 号的自动供给与可用号查询ASN Range 的核心价值在于自动供给从号段中为 ASN 记录 分配编号并即时得知哪些号仍可用。get_available_asns()的实现逻辑asns.pydef get_available_asns(self): range set(self.range) # 号段内全部 AS 号 existing_asns set(self.get_child_asns().values_list(asn, flatTrue)) # 已占用的 AS 号 available_asns sorted(range - existing_asns) # 集合差即可用号 return available_asnsget_child_asns()通过asn__gtestart AND asn__lteend的区间过滤取得已登记 ASNasns.py可用号 区间全集 − 已占用号结果升序排列由于ASN.asn字段全局唯一占用集合天然无重复。统计每个号段的使用量查询集ASNRangeQuerySet提供了annotate_asn_counts()querysets.py通过子查询统计每个号段内已登记的 ASN 数量asns ASN.objects.filter( asn__gteOuterRef(start), asn__lteOuterRef(end) ).order_by().annotate(_Value(1)).values(_).annotate(cCount(*)).values(c) return self.annotate(asn_countSubquery(asns))由于ASN与ASNRange之间没有外键ASN 只通过数值落入区间该实现利用OuterRef引用外层start/end做数值范围关联实现一对多的聚合统计。这一统计结果通过 REST API 的asn_count只读字段暴露给客户端。五、过滤与检索ASNRangeFilterSet定义于 filtersets.py继承OrganizationalModelFilterSet与TenancyFilterSetclass ASNRangeFilterSet(OrganizationalModelFilterSet, TenancyFilterSet): rir_id django_filters.ModelMultipleChoiceFilter( querysetRIR.objects.all(), distinctFalse, label_(RIR (ID)), ) rir django_filters.ModelMultipleChoiceFilter( field_namerir__slug, querysetRIR.objects.all(), distinctFalse, to_field_nameslug, label_(RIR (slug)), ) class Meta: model ASNRange fields (id, name, slug, start, end, description) def search(self, queryset, name, value): if not value.strip(): return queryset return queryset.filter( Q(name__icontainsvalue) | Q(description__icontainsvalue) )支持的过滤维度精确字段过滤id、name、slug、start、end、descriptionRIR 过滤既可按主键rir_id也可按 slugrir过滤——这也印证了官方文档中Slug 可用于过滤的说明全文搜索search方法对name、description做不区分大小写的包含匹配租户过滤通过TenancyFilterSet支持按tenant、tenant_id过滤NetBox 4.0 起的通用能力。对应的测试用例ASNRangeTestCase位于 test_filtersets.py覆盖了上述过滤与搜索行为。六、REST API 与 GraphQLASN Range 通过 REST API 暴露为ASNRangeSerializerserializers_/asns.pyclass ASNRangeSerializer(OrganizationalModelSerializer): rir RIRSerializer(nestedTrue) tenant TenantSerializer(nestedTrue, requiredFalse, allow_nullTrue) asn_count serializers.IntegerField(read_onlyTrue) class Meta: model ASNRange fields [ id, url, display_url, display, name, slug, rir, start, end, tenant, description, owner, comments, tags, custom_fields, created, last_updated, asn_count, ] brief_fields (id, url, display, name, description)要点rir与tenant以嵌套对象返回asn_count为只读统计字段对应上文annotate_asn_counts()用于展示每个号段的已占用数量从源码结构看该序列化器注册于 ipam 的 API 路由中可在 NetBox 的 IPAM API 文档浏览器访问/api/即可查看交互式文档中找到 ASN Range 的增删改查端点与可用号查询接口同样地graphql/types.py 与 graphql/filters.py 中注册了对应的 GraphQL 类型与过滤器支持通过 GraphQL API 查询号段及其统计信息。七、在 UI 中创建 ASN Range 的完整流程创建 ASN Range 的前提是目标 RIR 已存在见 RIR 模型文档。典型操作路径在 NetBox UI 导航至IPAM → ASN Ranges点击Add填写表单Name如RIPE 32-bit AllocationsSlug留空自动生成也可手动指定注意全局唯一RIR选择负责该号段分配的注册机构Start / End填写闭区间边界如131072与196607注意end必须大于start且均在1 ~ 4294967295范围内Tenant可选指定归属租户Description可选补充说明用途。保存后可在 ASN Range 列表页看到该号段以及通过asn_count反映的已占用数量随后在IPAM → ASNs中创建 ASN 记录时可从此号段内取值ASN 模型文档asn.md要求 ASN 全局唯一故重复的号会被拒绝写入。八、与相关模型的协同ASN Range 在 NetBox 的 IPAM 数据模型中与以下对象协同工作ASNRange 管理的对象本体。ASN 具有rir必填、role可选指向 Role、tenant可选并可分配给多个 SiteRIRRange 与 ASN 都必填的权威机构外键采用PROTECT删除保护TenantRange 与 ASN 均可选挂租户便于按租户隔离管理Site已分配的 ASN 可关联站点形成RIR 分配号段 → 号段内 ASN → 站点使用的完整溯源链。从数据模型看asns.pyASN通过数值asn而非外键归属 Range因此同一 Range 内的 ASN 变更不会破坏 Range 记录Range 始终是纯数值区间定义这一设计保证了查询集上集合运算get_available_asns的简洁与可靠。结语ASN Range 是 NetBox 对自治系统号空间管理的核心抽象通过[start, end]闭区间 RIR 归属配合全局唯一的name/slug、clean()边界校验、get_available_asns()可用号计算与annotate_asn_counts()用量统计将号段规划—自动分配—使用追踪串成完整闭环。无论是管理 RIR 分配的 16 位号段还是规划 32 位扩展号空间都可以依托该模型获得可审计、可过滤、可 API 驱动的号段治理能力。进一步可参考 IPAM 功能文档 了解 ASN 与其他 IP 资源聚合、前缀、IP 地址在 NetBox 中的整体协作方式。赞分享后端网络数据建模【免费下载链接】netboxThe premier source of truth powering network automation. Open source under Apache 2. Try NetBox Cloud free: https://netboxlabs.com/products/free-netbox-cloud/项目地址https://gitcode.com/gh_mirrors/ne/netbox点击查看免费下载相关推荐zimfw 构建系统完全指南init.zsh 生成机制与自定义配置zimfw 构建系统完全指南init.zsh 生成机制与自定义配置 Zim Framework 是 Zsh 配置框架中速度最快的选择之一其核心功能之一就是强开发工具CLINocoBase 字段校验完全指南基于 Joi 的配置规则、校验规则与双端验证机制NocoBase 字段校验完全指南基于 Joi 的配置规则、校验规则与双端验证机制 字段校验是 NocoBase 数据建模中保障数据准确性、安全性与一致性的核低代码后端前端人工智能AI 应用工作流自动化NetBox Circuit 模型全解析运营商物理线路的建模字段、状态机与数据校验NetBox Circuit 模型全解析运营商物理线路的建模字段、状态机与数据校验 本文围绕 NetBox 的 Circuits线路模块核心数据模型 Ci后端网络数据建模上一篇2025年免费3D设计与建模认证零基础到专业设计师的完整学习路径下一篇让文档无障“爱”Typst通用访问设计全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考