bandwhich

Esta es una utilidad CLI para mostrar la utilización actual de la red por proceso, conexión y IP/hostname remoto.

Tabla de contenidos

• bandwhich
  • Table of contents
  • Project status
  • How does it work?
  • Installation
    • Downstream packaging status
    • Download a prebuilt binary
  • Building from source
    • Cross-compiling
      • Android
  • Post install (Linux)
    • 1. setcap
      • Capabilities explained
    • 2. sudo (or alternative)
  • Post install (Windows)
  • Usage
  • Contributing
  • License

Estado del proyecto

Este proyecto se encuentra en mantenimiento pasivo. Los problemas críticos serán abordados, pero no se están desarrollando nuevas funcionalidades. Sin embargo, esto se debe principalmente a la falta de financiación y/o personal, por lo que las solicitudes de extracción (pull requests) son más que bienvenidas. Además, si puedes y estás dispuesto a contribuir a este proyecto a largo plazo, te invitamos a solicitar ser co-mantenedor.

Para más detalles, consulte The Future of Bandwhich #275.

¿Cómo funciona?

bandwhich husmea una interfaz de red determinada y registra el tamaño de los paquetes IP, cruzándolo con el sistema de archivos /proc en Linux, lsof en macOS, o usando WinApi en Windows. Responde al tamaño de la ventana del terminal, mostrando menos información si no hay espacio suficiente. También intenta resolver las IP a sus nombres de host en segundo plano mediante DNS inverso en el mejor de los casos.

Instalación

Estado del empaquetado downstream

Para instrucciones detalladas de cada plataforma, consulte INSTALL.md.

Descargar un binario precompilado

Ofrecemos varios binarios genéricos en releases para varios SO.

SO	Arquitectura	Soporte	Uso
Android	aarch64	Mejor esfuerzo	Dispositivos Android modernos. Nótese que es un archivo binario puro, no un APK adecuado para uso general.
Linux	aarch64	Completo	ARMv8+ de 64 bits (servidores, algunos enrutadores modernos, RPi-4+).
	armv7hf	Mejor esfuerzo	ARMv7 de 32 bits (enrutadores antiguos, pre-RPi-4).
	x64	Completo	La mayoría de los escritorios y servidores Linux.
MacOS	aarch64	Completo	Macs con chip Apple silicon (2021+).
	x64		Macs Intel (pre-2021).
Windows	x64	Completo	La mayoría de los escritorios y servidores Windows.

Compilando desde el código fuente

git clone https://github.com/imsnif/bandwhich.git
cd bandwhich
cargo build --release

Para la versión mínima compatible de Rust actualizada, consulte el campo rust-version en Cargo.toml.

Compilación cruzada

La compilación cruzada para otros objetivos es compatible mediante cross. Aquí el procedimiento aproximado:

1. Verifique la arquitectura objetivo. Si está en Linux, puede usar uname -m.
2. Consulte la compatibilidad de plataformas de rustc para el triple objetivo correspondiente.
3. Instale cross.
4. Ejecute cross build --release --target <TARGET_TRIPLE>.

Android

Hasta que se resuelva cross-rs/cross#1222, use la última versión HEAD:

cargo install --git https://github.com/cross-rs/cross.git cross
cross build --release --target aarch64-linux-android

Post-instalación (Linux)

Dado que bandwhich husmea paquetes de red, requiere privilegios elevados. En Linux, hay dos formas principales de lograr esto:

1. setcap

• Permite permanentemente al binario bandwhich los privilegios necesarios (llamados "capacidades" en Linux).
• Hágalo si desea dar a todos los usuarios no privilegiados acceso completo a las capacidades de monitoreo de bandwhich.
  • Esta es la configuración recomendada para máquinas de un solo usuario, o si todos los usuarios son de confianza.
  • No se recomienda si desea asegurar que los usuarios no puedan ver el tráfico de otros.

# asignar capacidades
sudo setcap cap_sys_ptrace,cap_dac_read_search,cap_net_raw,cap_net_admin+ep $(command -v bandwhich)
# ejecutar como usuario no privilegiado
bandwhich

Capacidades explicadas

• cap_sys_ptrace,cap_dac_read_search: permiten el acceso a /proc/<pid>/fd/, para que bandwhich pueda determinar qué puerto abierto pertenece a qué proceso.
• cap_net_raw,cap_net_admin: permiten capturar paquetes en su sistema.

2. sudo (o alternativa)

• Requiere escalada de privilegios cada vez.
• Hágalo si es administrador de un entorno multiusuario.

sudo bandwhich

Tenga en cuenta que si su método de instalación colocó bandwhich en algún lugar de su directorio personal (puede verificarlo con command -v bandwhich), es posible que reciba un error de command not found. Esto se debe a que en muchas distribuciones, sudo por defecto no conserva el $PATH del usuario por motivos de seguridad.

Para solucionarlo, puede hacer una de las siguientes opciones:

1. hacer que sudo conserve su variable de entorno $PATH;
2. establecer explícitamente $PATH al ejecutar bandwhich: sudo env "PATH=$PATH" bandwhich;
3. pasar la ruta completa a sudo: sudo $(command -v bandwhich).

Post-instalación (Windows)

Es posible que primero necesite instalar npcap para capturar paquetes en Windows.

Uso

Usage: bandwhich [OPTIONS]