Un bot para vigilar quién se conecta a tu red
10K+
VERSIÓN EN ESPAÑOL | ENGLISH VERSION
Lleva el control de los dispositivos que se conectan a tu red.
IP_RANGE📦 Código fuente, incidencias y documentación completa en GitHub.
/newbot. Sigue las instrucciones (un nombre y un username acabado en bot).TELEGRAM_TOKEN.TELEGRAM_ADMIN), habla con @MissRose_bot y envíale /id.TELEGRAM_GROUP./setuserpic.| Comando | Descripción |
|---|---|
/start | Panel con el estado de la red (o de cada red): dispositivos conocidos y conectados, último y próximo escaneo |
/list | Dispositivos conocidos. Con varias redes, primero eliges la red (o todas). Pulsa en un dispositivo para ver sus detalles, renombrarlo u olvidarlo |
/scan | Escanea la red ahora mismo |
/help | Lista de comandos |
/version | Muestra la versión actual |
/donate /donors | Dona al desarrollador / lista de donantes |
Cada HOURS_BETWEEN_SCANS horas el bot lanza una petición ARP a todas las direcciones vigiladas (IP_RANGE, o cada red de NETWORKS). Todo dispositivo IPv4 de la red local tiene que responder a ARP (aunque tenga cortafuegos y no conteste al ping), y la respuesta trae su MAC, que es lo que lo identifica.
Si una red solo es accesible a través del router (o la interfaz que indica la tabla de rutas no existe), el ARP no llega y el bot recurre al ping, como hacía la 1.x. Ver Requisito: una interfaz en cada VLAN.
ℹ️ Nota Muchos móviles y portátiles usan una MAC privada (aleatoria) para cada red Wi-Fi. El bot las marca como (privada): en ellas no se puede conocer el fabricante y, si el dispositivo decide cambiarla, aparecerá como uno nuevo.
| CLAVE | OBLIGATORIO | VALOR |
|---|---|---|
| TELEGRAM_TOKEN | ✅ | Token del bot |
| TELEGRAM_ADMIN | ✅ | ChatId del administrador (se puede obtener hablándole al bot Rose escribiendo /id). Admite múltiples administradores separados por comas. Por ejemplo 12345,54431,55944 |
| TELEGRAM_GROUP | ❌ | ChatId del grupo. Si este bot va a formar parte de un grupo, es necesario especificar el chatId de dicho grupo. Es necesario que el bot sea administrador del grupo |
| TELEGRAM_THREAD | ❌ | Thread del tema dentro de un supergrupo; valor numérico (2,3,4..). Por defecto 1. Se utiliza en conjunción con la variable TELEGRAM_GROUP |
| TZ | ✅ | Timezone (Por ejemplo Europe/Madrid) |
| IP_RANGE | ✅* | Direcciones a vigilar. Admite rangos (192.168.1.1-192.168.1.254), redes (192.168.1.0/24) y direcciones sueltas, separados por comas. Máximo 65536 direcciones |
| NETWORKS | ✅* | En lugar de IP_RANGE, para vigilar varias redes o VLAN: nombre=rango[@interfaz] separados por ;. Por ejemplo Casa=192.168.1.0/24; IoT=192.168.20.0/[email protected]. Ver Varias redes o VLAN |
| HOURS_BETWEEN_SCANS | ❌ | Horas entre escaneos; admite decimales (0.5 = 30 minutos). Mínimo un minuto. Por defecto 1 |
| NETWORK_INTERFACE | ❌ | Interfaz de red por la que escanear IP_RANGE (por ejemplo eth0). Por defecto, la que tenga la ruta hacia esas direcciones. Con NETWORKS se usa @interfaz en cada red |
| LANGUAGE | ❌ | Idioma, puede ser ES / EN. Por defecto ES (Spanish) |
* Hace falta IP_RANGE o NETWORKS. Si están las dos, manda NETWORKS.
services:
intrubot:
environment:
- TELEGRAM_TOKEN=
- TELEGRAM_ADMIN=
- TZ=Europe/Madrid
- IP_RANGE=192.168.1.0/24
#- NETWORKS=Casa=192.168.1.0/24; IoT=192.168.20.0/24 # En lugar de IP_RANGE, para varias redes
#- TELEGRAM_GROUP=
#- TELEGRAM_THREAD=1
#- HOURS_BETWEEN_SCANS=1
#- NETWORK_INTERFACE=
#- LANGUAGE=ES
volumes:
- /ruta/para/guardar/los/datos:/app/data # CAMBIAR LA PARTE IZQUIERDA
image: dgongut/intrubot:latest
container_name: intrubot
restart: always
network_mode: host
network_mode: host es imprescindible (o bien redes macvlan, ver Varias redes o VLAN): el escaneo ARP solo funciona si el contenedor ve directamente la red local. Con la red bridge de Docker solo vería otros contenedores.NET_RAW), que Docker concede por defecto. Si la has quitado con cap_drop, añádela con cap_add: [NET_RAW]./app/data/devices.json, así que hay que mapear ese volumen para no perderla al recrear el contenedor.HEALTHCHECK: el contenedor aparece como unhealthy si el bot deja de hablar con Telegram.Un solo bot puede vigilar varias redes a la vez. Usa NETWORKS en lugar de IP_RANGE, con una entrada nombre=rango por red separadas por ; y, opcionalmente, @interfaz:
- NETWORKS=Casa=192.168.1.0/24; IoT=192.168.20.0/[email protected]; Invitados=192.168.30.0/24
IP_RANGE: rangos, redes CIDR y direcciones sueltas separadas por comas. Una dirección no puede estar en dos redes, y entre todas no pueden pasar de 65536 direcciones.@interfaz, el bot escanea cada dirección por la interfaz que indique la tabla de rutas. Pon @interfaz cuando la pata de esa VLAN no tenga IP propia en el equipo.El ARP no atraviesa routers. Si en una red no responde nadie por ARP y, según la tabla de rutas, solo se llega a ella a través del router, el bot hace ping a sus direcciones. Funciona sin tocar nada, pero con límites:
Para verlo todo, con su MAC, el contenedor necesita una interfaz dentro de esa red. Cuando la tenga, los dispositivos que ya conocía por IP pasan a identificarse por su MAC sin perder el nombre y sin volver a avisar. Hay dos formas de darle esas interfaces:
1. network_mode: host y una subinterfaz por VLAN en el equipo. El puerto del switch al que va conectado el servidor tiene que llevar esas VLAN etiquetadas (modo trunk). En Linux, por ejemplo, para la VLAN 20:
ip link add link eth0 name eth0.20 type vlan id 20
ip addr add 192.168.20.5/24 dev eth0.20
ip link set eth0.20 up
Esto no sobrevive a un reinicio: hazlo persistente con la herramienta de red de tu sistema (netplan, /etc/network/interfaces, NetworkManager…). En Unraid basta con activar las VLAN en Settings → Network Settings, que crea br0.20 y similares.
2. Una red macvlan de Docker por VLAN, sin network_mode: host y sin tocar el equipo. Docker crea la subinterfaz eth0.20 si no existe. Reserva para el contenedor una IP fuera del rango de tu DHCP:
services:
intrubot:
environment:
- TELEGRAM_TOKEN=
- TELEGRAM_ADMIN=
- TZ=Europe/Madrid
- NETWORKS=Casa=192.168.1.0/24; IoT=192.168.20.0/24
volumes:
- /ruta/para/guardar/los/datos:/app/data
image: dgongut/intrubot:latest
container_name: intrubot
restart: always
networks:
casa:
ipv4_address: 192.168.1.250
iot:
ipv4_address: 192.168.20.250
networks:
casa:
driver: macvlan
driver_opts:
parent: eth0
ipam:
config:
- subnet: 192.168.1.0/24
gateway: 192.168.1.1
iot:
driver: macvlan
driver_opts:
parent: eth0.20
ipam:
config:
- subnet: 192.168.20.0/24
ℹ️ Nota Con
macvlanel equipo que ejecuta Docker no se ve desde sus propios contenedores (es una limitación de macvlan), así que ese equipo no aparecerá en la lista.
/start muestra cada red con sus dispositivos conocidos y conectados, y avisa si su último escaneo falló./list empieza preguntando qué red quieres ver, o todas./app/data.NETWORKS, o pasas de IP_RANGE a NETWORKS, cada dispositivo pasa a la red que contiene su IP, sin perder su nombre y sin volver a avisar de él.La 2.0 se ha reescrito por completo. Mantén el mismo volumen /app/data y el bot migrará solo tu known_devices.json (lo renombra a known_devices.json.bak):
/delete, /deleteall y /rename desaparecen: ahora todo se hace con botones desde /list.tty: true ya no hace falta. Hasta la 1.x el compose lo llevaba para que los logs del bot salieran en docker logs; desde la 2.0 la imagen los escribe al momento sin él. Puedes quitarlo, o dejarlo: no molesta.IP_RANGE y HOURS_BETWEEN_SCANS siguen funcionando igual. IP_RANGE acepta además redes CIDR y varias entradas separadas por comas, y si tienes varias VLAN puedes pasarte a NETWORKS.Content type
Image
Digest
sha256:19cbbce9a…
Size
33.5 MB
Last updated
9 days ago
docker pull dgongut/intrubot