Scanopy: Instalación del Servidor Self-Hosted con Docker

 Docker  |  Self-Hosted  |  Network Scanning

Scanopy: Instalación del Servidor Self-Hosted con Docker

Despliega tu propio servidor de escaneo y gestión de red en minutos, bajo tu control total.

 ¿Qué es Scanopy?

Scanopy es una plataforma de descubrimiento y monitorización de red que permite desplegar un servidor propio en tu infraestructura. Mediante daemons distribuidos, realiza escaneos continuos de hosts, puertos, servicios y topología de red, ofreciendo una visión centralizada de todos tus activos de red.





La opción de instalación self-hosted con Docker Compose es la forma recomendada de comenzar: rápida, reproducible y sin dependencias complejas en el sistema operativo anfitrión.

✅ Requisitos del sistema

 Compilar desde código fuente

  • Rust 1.90 o superior
  • Node.js 20 o superior
  • PostgreSQL 17
  • 4 GB RAM mínimo
  • 20 GB de espacio en disco

 Instalación con Docker (paso a paso)

  1. Descargar el archivo Docker Compose

    Descarga el archivo de configuración oficial directamente desde el repositorio:

    curl -O https://raw.githubusercontent.com/scanopy/scanopy/refs/heads/main/docker-compose.yml
  2. Revisar la configuración

    El docker-compose.yml por defecto incluye el servidor Scanopy en el puerto 60072, una base de datos PostgreSQL y un daemon integrado para escaneo inmediato. No se requiere configuración adicional para que el daemon funcione: el servidor lo inicializa automáticamente al arrancar.

    ⚠️ Importante: El daemon integrado asume que tu red bridge de Docker es 172.17.0.1. Si tu entorno usa una dirección diferente, edita la variable SCANOPY_INTEGRATED_DAEMON_URL en el archivo compose antes de continuar.
  3. Iniciar Scanopy

    Lanza todos los servicios en segundo plano:

    docker compose up -d
  4. Verificar la instalación

    Comprueba que los tres servicios están en ejecución: scanopy-server, scanopy-postgres y scanopy-daemon.

    docker compose ps
  5. Acceder a la interfaz web

    Abre tu navegador y navega a la IP de tu servidor. En el primer acceso verás la página de registro.

    http://<tu-ip-servidor>:60072
 Si algún servicio no arranca, revisa sus logs con docker compose logs <nombre-servicio> para identificar el problema.

️ Instrucciones por plataforma

Proxmox LXC

Usa el helper script oficial para crear un contenedor LXC en Proxmox con Scanopy preconfigurado. En LXC puede ser necesario cambiar SCANOPY_INTEGRATED_DAEMON_URL a 172.31.0.1.

Unraid

Scanopy está disponible como aplicación de comunidad en Unraid. Instálala directamente desde el panel de apps de la plataforma.

Proxmox (host directo)

Si ejecutas Scanopy directamente en el host y aparece el error could not create any Unix-domain sockets, añade security_opt: - apparmor:unconfined a los servicios de PostgreSQL y Scanopy en el compose.

️ Desinstalación

Para eliminar Scanopy completamente de tu sistema:

# Detener y eliminar contenedores
docker compose down

# Eliminar volúmenes (borra todos los datos)
docker compose down -v

# Eliminar imágenes
docker rmi ghcr.io/scanopy/scanopy/server:latest
docker rmi ghcr.io/scanopy/scanopy/daemon:latest
⚠️ Atención: El flag -v eliminará todos los datos almacenados de forma permanente. Realiza una copia de seguridad antes si necesitas conservar la información.

Comentarios