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.

Compilando desde el código fuente

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:

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.

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.

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

Contribuir

Véase CONTRIBUTING.md.

Licencia

MIT