NetBox 实战：基于 Docker 快速构建网络基础设施管理中心

# 拉取仓库
git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker

# 复制codker-compose覆盖文件，这个文件只是修改了端口映射到8000
cp docker-compose.override.yml.example docker-compose.override.yml

# 拉取所需镜像，主要是netbox、postgres、redis
docker compose pull

# 启动容器，第一次启动需要初始化数据库等，建议不加-d，在前台观察输出是否报错
docker compose up

docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser

# 以root用户进入容器
docker compose exec -it --user root netbox /usr/bin/bash
# 直接以root权限运行命令
docker compose exec -u root netbox apt-get install -y vim

mkdir plugins
touch plugins/requirements-plugins.txt 

services:
  netbox:
    environment:
      PYTHONPATH: "/opt/netbox/netbox/plugins"
    volumes:
      - ./plugins:/opt/netbox/netbox/plugins:rw

docker compose up -d netbox

docker compose exec -it -u root netbox bash

uv pip install --target /opt/netbox/netbox/plugins netbox-topology-views

echo "netbox-topology-views==4.5.0" >> plugins/requirements-plugins.txt

# 编辑 netbox-docker/configuration/extra.py
# 容器中挂载到 /etc/netbox/config/extra.py

## Enable installed plugins. Add the name of each plugin to the list.
from netbox.configuration.configuration import PLUGINS
PLUGINS.append('netbox_topology_views')

## Plugins configuration settings. These settings are used by various plugins that the user may have installed.
## Each key in the dictionary is the name of an installed plugin and its value is a dictionary of settings.
from netbox.configuration.configuration import PLUGINS_CONFIG
PLUGINS_CONFIG['netbox_topology_views'] = { 
    'static_image_directory': 'netbox_topology_views/img',
    'allow_coordinates_saving': True,
    'always_save_coordinates': True
}

# 编辑 netbox-docker/configuration/plugins.py
# 容器中挂载到 /etc/netbox/config/plugins.py
PLUGINS = ["netbox_topology_views"]
PLUGINS_CONFIG = {
  "netbox_topology_views": {
    'static_image_directory': 'netbox_topology_views/img',
    'allow_coordinates_saving': True,
    'always_save_coordinates': True
  }
}

# 在容器中执行
uv run --active  manage.py migrate
uv run --active  manage.py collectstatic

docker compose restart netbox

docker compose down

git checkout release &&
git pull -p origin release

docker compose pull
docker compose up -d

cd <path_to>/netbox-docker
# Stop all containers
docker compose down
# Only start the DB
docker compose up -d postgres
# Take a DB backup
docker compose exec -T postgres sh -c 'pg_dump -cU $POSTGRES_USER $POSTGRES_DB' | gzip > db_dump.sql.gz
# Stop the database
docker compose down
# Remove the database volume
# 
# !!!
# THIS STEP WILL REMOVE ALL DATA IN YOUR DATABASE
# !!!
# 注意这个卷的名字，必要时用docker volume ls 查看下
docker volume rm netbox-netbox-postgres-data
# Update NetBox Docker files and containers
git checkout release && git pull -p origin release
docker compose pull
# Restore the database
docker compose up -d postgres
gunzip -c db_dump.sql.gz | docker compose exec -T postgres sh -c 'psql -U $POSTGRES_USER $POSTGRES_DB'
# Start all other containers
docker compose up -d