Skip to content
BotServBotServ
RackPeekHomelabRackDocumentaciónAuto-hospedajeOpen SourceInventario

RackPeek: Documentar y visualizar tu Homelab

RackPeek auto-hospedado: herramienta Open Source para visualizar y documentar racks de servidores. Configuración y uso.

S

schutzgeist

3 min read
RackPeek: Documentar y visualizar tu Homelab

RackPeek: Documenta y visualiza tu rack del homelab

Qué cubre este artículo

  • Qué es RackPeek: herramienta open source para documentación y visualización de racks.
  • Cuándo vale la pena usarla (y cuándo no).
  • Instalación y flujo de trabajo típico.
  • Alternativas y su lugar en el conjunto de herramientas del homelab.

Introducción

Cuando un homelab supera los tres dispositivos, el caos empieza: ¿a dónde va cada cable? ¿Qué está conectado en el puerto 5? ¿Qué unidad de altura ocupa el switch? RackPeek es una herramienta open source ligera que resuelve exactamente esto: un plano visual de tu rack o armario. Arrastra dispositivos, documenta puertos, registra las conexiones de cables.

Es el gemelo digital del concepto para tu homelab: antes de tocar algo físicamente, consultas RackPeek para saber qué encontrarás dónde.

Escenarios de uso típicos

  • Planificar el diseño del rack: Antes de recibir hardware, planifica unidades de altura (U) y peso.
  • Documentar cableado: Registra qué puerto va a dónde, invaluable en troubleshooting.
  • Inventario: Todos los dispositivos, números de serie, IPs y MACs en un solo lugar.
  • Preparar reorganizaciones: Visualiza antes y después, estima longitudes de cables.
  • Documentación compartida: Cuando varias personas trabajan en el mismo homelab (familia, asociación, empresa).

Instalación

RackPeek se ejecuta como una aplicación web. La instalación más simple es con Docker, o puedes probar la demo alojada:

services:
  rackpeek:
    image: ghcr.io/rackpeek/rackpeek:latest   # Verifica los nombres de imagen en la documentación del repo
    ports: ["127.0.0.1:8282:80"]
    volumes: [rackpeek_data:/data]
    restart: always

volumes:
  rackpeek_data:

También puedes usarlo como una aplicación estática en el navegador: los datos se mantienen locales (localStorage o exportación de archivos), sin servidor necesario para empezar.

Flujo de trabajo

  1. Crear un rack: Define las unidades de altura, por ejemplo 12U para un mini rack.
  2. Agregar dispositivos: Especifica el tipo (servidor, switch, SAI, patchpanel), altura, nombre, fabricante.
  3. Posicionar mediante arrastre: Coloca los dispositivos en sus posiciones de U, viendo la disposición como en un rack real.
  4. Puertos y conexiones: Documenta los cables de puerto a puerto.
  5. Notas e IPs: Añade interfaces de gestión, números de serie, MACs.

Cuándo vale la pena y cuándo no

Vale la pena:

  • A partir de ~3 dispositivos en el rack; menos que eso, no lo necesitas.
  • Si haces reorganizaciones frecuentes o cambias dispositivos.
  • Con varias personas compartiendo el mismo setup.

No es necesario en:

  • Setups de un solo dispositivo (una mini PC aislada no necesita gestión de rack).
  • Si ya mantienes un wiki o inventario (NetBox es la alternativa más completa).

Alternativas

HerramientaFortalezaDebilidad
RackPeekLigera, visual, sencillaMenos features que herramientas DCIM
NetBoxEl estándar DCIM, muy potenteSignificativamente más compleja, requiere Postgres
Homarr/DashyDashboard con enlaces a serviciosNo visualiza diseño de rack físico
Wiki (ej. Wiki.js)Documentación libreSin visualización del rack

Posición en el ecosistema

RackPeek no es imprescindible, pero la primera vez que busques “ese cable rojo” o necesites encontrar una unidad libre, un rack documentado es una bendición. Combinado con el Homelab-Guide, el flujo es: construye la infraestructura física → documéntala en RackPeek → opera con Monitoring.

Enlaces relacionados

Puntos clave:

  • RackPeek = documentación visual del rack: dispositivos, posiciones de U, cables, IPs.
  • Vale la pena a partir de ~3 dispositivos o si haces reorganizaciones frecuentes.
  • Ligera, no es un monstruo DCIM como NetBox, pero perfecta para homelabs.
  • Úsala como aplicación estática (local) o auto-alojada con Docker.
  • Combinación con Homelab-Guide: construye → documenta → monitorea.

Preguntas frecuentes

¿Qué es RackPeek?

Una herramienta open source para visualizar y documentar racks de servidores: coloca dispositivos en unidades de altura, registra puertos y cables, mantén un inventario, crea un gemelo digital de tu homelab físico.

¿Cuándo vale la pena?

A partir de ~3 dispositivos o si haces reorganizaciones regularmente. Los dispositivos aislados no necesitan gestión de rack; a partir de ese punto, la documentación ahorra tiempo en cada troubleshooting.

¿RackPeek o NetBox?

RackPeek es ligera y visual, ideal para homelabs. NetBox es el estándar DCIM para instalaciones grandes (proveedores, empresas) con API y modelo de datos complejo, excesiva para uso doméstico.

¿Dónde se guardan los datos?

Localmente. En la versión navegador están en localStorage o se exportan como archivo; con Docker en el volumen. Nada se envía a terceros.

¿Es gratuito?

Sí: open source, completamente gratuito.

Fuentes y referencias

Volver al blog
Share:

Entradas relacionadas