groales/netbox
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: Configuración Inicial
Pages
Actualización Backup y Restauración Configuración Inicial Home NPM Personalización Solución de Problemas Traefik
Clone
2
Configuración Inicial
groales edited this page 2025-12-04 11:28:13 +01:00
Unescape Escape
Table of Contents
This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Configuración Inicial

Pasos para configurar NetBox tras el primer despliegue.

Primer Acceso

  1. Accede a NetBox mediante tu dominio configurado
  2. Login con:
    • Username: admin
    • Password: El valor de SUPERUSER_PASSWORD

ℹ️ Nota: El username es siempre admin. El SUPERUSER_EMAIL se usa solo para notificaciones.

El primer inicio puede tardar 1-2 minutos mientras NetBox inicializa la base de datos.

Panel de Administración

Usuarios y Permisos

Admin → Users

  1. Crear usuario adicional:

    • Click en Add
    • Username, email, password
    • Asignar a grupos
    • Marcar Staff status si necesita acceso admin

  2. Crear grupos:

    • Admin → Groups → Add
    • Asignar permisos granulares por modelo
    • Ejemplo: Grupo "Network Team" con permisos IPAM

  3. Tokens de API:

    • Admin → Tokens → Add
    • Seleccionar usuario
    • Definir permisos (read-only, write)
    • Usar para automatización

Configuración Básica

Sites (Ubicaciones)

Organization → Sites → Add

Crea tus ubicaciones físicas:

  • Name: Madrid DC1
  • Status: Active
  • Region: España
  • Facility: Equinix
  • Physical Address: Calle ejemplo 123
  • GPS: 40.4168, -3.7038

Racks

DCIM → Racks → Add

Define racks para inventario:

  • Name: RACK-01
  • Site: Madrid DC1
  • U Height: 42
  • Type: 4-post cabinet
  • Width: 19 inches

Device Types

DCIM → Device Types → Add

O importa desde Device Type Library:

# Desde el contenedor
docker exec -it netbox bash
cd /app/netbox
python manage.py import_device_types --url https://github.com/netbox-community/devicetype-library.git

Prefijos de Red

IPAM → Prefixes → Add

Define tus redes:

  • Prefix: 192.168.1.0/24
  • Site: Madrid DC1
  • VLAN: VLAN 10 - Servidores
  • Status: Active
  • Role: Servers
  • Description: Red de servidores producción

VLANs

IPAM → VLANs → Add

  • ID: 10
  • Name: Servidores
  • Site: Madrid DC1
  • Status: Active

Configuración Avanzada

Custom Fields

Customization → Custom Fields → Add

Añade campos personalizados a cualquier modelo:

Ejemplo: Número de contrato para dispositivos

  • Object Types: DCIM > Device
  • Type: Text
  • Name: contract_number
  • Label: Nº Contrato
  • Required: No

Tags

Organization → Tags → Add

Etiquetas para organizar objetos:

  • Name: Producción
  • Slug: produccion
  • Color: Red

Webhooks

System → Webhooks → Add

Integra con sistemas externos:

  • Name: Notificar a Slack
  • Object Types: DCIM > Device
  • Events: Created, Updated, Deleted
  • URL: https://hooks.slack.com/services/...
  • HTTP Method: POST

Importar Datos

Desde CSV

Import (en cada sección)

Ejemplo para IPs:

address,status,dns_name,description
192.168.1.10,active,server01.local,Web Server
192.168.1.11,active,server02.local,DB Server

Desde API

import requests

headers = {
    'Authorization': 'Token tu_token_aqui',
    'Content-Type': 'application/json'
}

data = {
    'address': '192.168.1.20/32',
    'status': 'active',
    'dns_name': 'router01.local'
}

response = requests.post(
    'https://netbox.tudominio.com/api/ipam/ip-addresses/',
    headers=headers,
    json=data
)

Próximos Pasos

  1. Personalización - LDAP, plugins, scripts
  2. Backup - Protege tus datos
  3. API Docs - Explora la API REST

NetBox Wiki

🚀 Inicio

📦 Despliegue

⚙️ Configuración

💾 Mantenimiento