ZOYKU火线榜

netboxlabs/netbox-custom-objects技术文档

NetBox Custom Objects plugin

目录大纲 (TOC) (3 章节)▾
多语言回退提示:当前仓库原作者暂未发布本地化文档,已为您无缝切换至官方英文原版(English),排版及代码实例完整保真。
极速安装
pip install netbox-custom-objects

NetBox Custom Objects

This NetBox plugin introduces the ability to create new object types in NetBox so that users can add models to suit their own needs. NetBox users have been able to extend the NetBox data model for some time using both Tags & Custom Fields and Plugins. Tags and Custom Fields are easy to use, but they have limitations when used at scale, and Plugins are very powerful but require Python/Django knowledge, and ongoing maintenance. Custom Objects provides users with a no-code "sweet spot" for data model extensibility, providing a lot of the power of NetBox plugins, but with the ease of use of Tags and Custom Fields.

You can find further documentation here. See the compatibility matrix for supported NetBox versions.

Installation

  1. Install the NetBox Custom Objects package.
pip install netboxlabs-netbox-custom-objects
  1. Add netbox_custom_objects to PLUGINS in configuration.py.
PLUGINS = [
    # ...
    'netbox_custom_objects',
]
  1. Run NetBox migrations and collect static files:
$ ./manage.py migrate
$ ./manage.py collectstatic
  1. Restart NetBox
sudo systemctl restart netbox netbox-rq

Custom Objects Tab

When a custom object references a NetBox object, or another custom object, through an object or multi-object field, the referenced object's page gets a Custom Objects tab listing every custom object that links to it. See the documentation for details.

Roadmap

NetBox Custom Objects is Generally Available, which means you can use it in production and migrations to future versions will work. The best place to see what's on the way is the issues list on the GitHub repository.

文档镜像归档自 GitHub 官方源路径 · 访问原项目 GitHub
最后同步快照:2026-11-11