bytefields/debugger repository overview

⁠Debugger

A docker image with essential debugging tools. Runs on Alpine Linux.

⁠Usage

⁠Docker Run

#To debug container network
docker run -it --net container:<container_name> bytefields/debugger
#To debug host network
docker run -it --net host bytefields/debugger

⁠Docker Compose

version: "3.6"
services:
  tcpdump:
    image: bytefields/debugger
    depends_on:
      - nginx
    command: tcpdump -i eth0 -w /data/nginx.pcap
    network_mode: service:nginx
    volumes:
      - $PWD/data:/data

  nginx:
    image: nginx:alpine
    ports:
      - 80:80

⁠Tools Included

• apache2-utils

  • Lightweight command-line utilities for Apache HTTP Server (e.g., ab, htpasswd).
  • Use case: web server administration and basic HTTP benchmarking/auth management.

• auditd

  • Linux Audit daemon that records security-relevant system events to the audit log.
  • Use case: security/auditing and compliance.

• bash

  • GNU Bourne-Again SHell, an interactive shell and scripting language.
  • Use case: shell/command-line and scripting.

• bind-tools

  • DNS client tools from BIND (e.g., dig, nslookup).
  • Use case: DNS troubleshooting and queries (network).

• bird

  • BGP/OSPF routing daemon (BIRD Internet Routing Daemon).
  • Use case: dynamic routing for networks and routers (network).

• bridge-utils

  • Tools for configuring Linux Ethernet bridges (brctl, etc.).
  • Use case: network bridging and virtualization network setup (network).

• busybox-extras

  • Additional BusyBox applets providing small, single-binary Unix utilities.
  • Use case: general-purpose small utilities for minimal environments (system/tools).

• conntrack-tools

  • Tools to inspect and manipulate the netfilter connection tracking table.
  • Use case: firewall/connection tracking and NAT troubleshooting (network/security).

• curl

  • Command-line tool to transfer data with URL syntax (supports many protocols).
  • Use case: HTTP/FTP/REST API calls and downloads (network).

• dhcping

  • Utility to query DHCP servers and test DHCP responses.
  • Use case: DHCP server testing and network troubleshooting (network).

• drill

  • DNS lookup utility from ldns (similar to dig).
  • Use case: DNS queries and diagnostics (network).

• dtop

  • Terminal-based network traffic and connection monitor that shows per-process bandwidth and socket info in a top-like interface.
  • Use case: real-time per-process network monitoring and troubleshooting (network/system).

• ethtool

  • Utility to query and control network driver and hardware settings.
  • Use case: NIC diagnostics and tuning (network/hardware).

• file

  • Determines file type by inspecting content (magic bytes).
  • Use case: file inspection and identification.

• fping

  • Fast, scriptable ping utility that can ping many hosts in parallel.
  • Use case: host reachability checks and network monitoring (network).

• iftop

  • Real-time console-based bandwidth usage monitor per host/connection.
  • Use case: live network traffic monitoring (network).

• iperf

  • Network bandwidth measurement tool (iperf2 variant).
  • Use case: throughput testing between two endpoints (network).

• iperf3

  • Redesigned version of iperf for measuring TCP/UDP bandwidth with client/server.
  • Use case: modern throughput testing and performance benchmarking (network).

• iproute2

  • Collection of utilities for network and traffic control (ip, ss, tc).
  • Use case: advanced network configuration and diagnostics (network).

• ipset

  • Utility to create and manage sets of IP addresses for use with netfilter/iptables.
  • Use case: scalable firewall rules and IP grouping (network/security).

• iptables

  • Classic Linux IPv4/IPv6 packet filtering and NAT firewall tool.
  • Use case: firewalling, NAT, packet filtering (network/security).

• iptraf-ng

  • Interactive network monitoring tool showing connections and traffic stats.
  • Use case: real-time traffic analysis (network).

• iputils

  • Collection of basic network utilities (ping, tracepath, arping).
  • Use case: core network diagnostics (network).

• ipvsadm

  • Administration tool for Linux Virtual Server (IPVS) load balancer.
  • Use case: managing kernel-level load balancing (network).

• httpie

  • Human-friendly command-line HTTP client with JSON support.
  • Use case: API testing and HTTP requests (network/dev).

• jq

  • Command-line JSON processor for querying and transforming JSON.
  • Use case: parsing, filtering, and formatting JSON (data/tools).

• libc6-compat

  • Compatibility runtime libraries for glibc-based binaries on musl systems.
  • Use case: run software expecting glibc on non-glibc distributions (system/runtime).

• liboping

  • Library and tools for ICMP echo (ping) monitoring with latency stats.
  • Use case: programmatic ping/latency measurements (network).

• ltrace

  • Traces library calls made by a program and signals.
  • Use case: debugging and reverse engineering of programs (development).

• mtr

  • Combines traceroute and ping to show path and per-hop latency/loss.
  • Use case: path/latency troubleshooting (network).

• net-snmp-tools

  • SNMP command-line utilities (snmpget, snmpwalk).
  • Use case: network device monitoring and management via SNMP (network/monitoring).

• netcat-openbsd

  • Netcat variant: versatile TCP/UDP network utility for reading/writing sockets.
  • Use case: raw network connections, debugging, simple servers/clients (network/dev).

• nftables

  • Modern packet filtering framework replacing iptables (nft command).
  • Use case: firewalling, NAT, packet classification (network/security).

• ngrep

  • Network grep: match regular expressions against network traffic payloads.
  • Use case: application-layer packet inspection (network/security).

• nmap

  • Network scanner for host discovery and port/service detection.
  • Use case: security auditing, host/service discovery (network/security).

• nmap-nping

  • Packet generation and response analysis tool from Nmap (nping).
  • Use case: custom packet testing and latency/response measurement (network).

• nmap-scripts

  • Collection of NSE (Nmap Scripting Engine) scripts for advanced scanning.
  • Use case: extensible checks, vulnerability detection, service enumeration (network/security).

• openssl

  • Toolkit for TLS/SSL and general cryptography operations and certificate handling.
  • Use case: generating keys/certs, encryption, testing TLS services (security/crypto).

• py3-pip

  • Python 3 package installer (pip).
  • Use case: install Python packages and dependencies (development).

• py3-setuptools

  • Python packaging utilities for building and installing Python packages.
  • Use case: Python package development and installation (development).

• scapy

  • Python library for packet crafting, sending, sniffing, and dissecting.
  • Use case: network testing, protocol research, and packet manipulation (network/dev).

• socat

  • Multipurpose relay for bidirectional data transfer between two endpoints.
  • Use case: port forwarding, tunneling, proxying, and socket debugging (network/dev).

• speedtest-cli

  • Command-line client to test internet bandwidth using Speedtest.net.
  • Use case: measure internet speed (network).

• openssh

  • SSH client and server for secure remote login and file transfer (sshd/ssh).
  • Use case: remote administration and secure file transfer (network/security).

• strace

  • Traces system calls and signals made by a program.
  • Use case: debugging, performance analysis, and troubleshooting (development).

• tcpdump

  • Command-line packet capture tool for inspecting network traffic.
  • Use case: packet capture and network forensics (network/security).

• tcping

  • Tool that sends TCP SYN probes to a specified port to test TCP connectivity and measure response time (TCP ping).
  • Use case: check TCP service availability and latency when ICMP ping is blocked (network).

• tcptraceroute

  • Traceroute using TCP packets (bypasses some ICMP filtering).
  • Use case: path discovery to TCP services (network).

• trippy

  • Lightweight tool for traceroute-like path probing using UDP/TCP/ICMP.
  • Use case: network path probing and diagnostics (network).

• tshark

  • Terminal-based network protocol analyzer (command-line Wireshark).
  • Use case: packet capture and protocol analysis (network/security).

• util-linux

  • Collection of essential system utilities (mount, fdisk, login, etc.).
  • Use case: general system administration and utilities.

• vim

  • Modal text editor (Vi Improved).
  • Use case: editing files and code (editor/development).

• git

  • Distributed version control system.
  • Use case: source code management and collaboration (development).

• websocat

  • Command-line WebSocket client and server utility.
  • Use case: testing and interacting with WebSocket endpoints (network/dev).

• swaks

  • Swiss Army Knife SMTP: flexible SMTP testing tool.
  • Use case: SMTP server testing and email delivery debugging (network/mail).