https://github.com/l7mp/net-debug
Docker image with assorted network debugging goodies for troubleshooting Kubernetes networking issues.
https://github.com/l7mp/net-debug
docker-image kubernetes-troubleshooting network troubleshooting
Last synced: 12 days ago
JSON representation
Docker image with assorted network debugging goodies for troubleshooting Kubernetes networking issues.
- Host: GitHub
- URL: https://github.com/l7mp/net-debug
- Owner: l7mp
- License: mit
- Created: 2022-09-22T18:24:24.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-12-29T11:41:42.000Z (6 months ago)
- Last Synced: 2026-02-04T12:47:31.570Z (5 months ago)
- Topics: docker-image, kubernetes-troubleshooting, network, troubleshooting
- Language: Dockerfile
- Homepage:
- Size: 28.3 KB
- Stars: 37
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# net-debug
## Description
Assorted network debugging goodies, like `tcpdump`, `socat`/`websocat`, `iperf`, `nmap`, `nslookup`, `dig`, `tcpreplay`, and `ping`/`traceroute`, all packaged in a self-contained Docker image. The intended use is to sideload the container as a sidecar to Kubernetes pods in order to debug network reachability and performance issues.
## Usage examples
### Create a Deployment
Config: [yaml](examples/net-debug.yaml)
Usage:
```console
kubectl apply -f examples/net-debug.yaml
```
or
```console
kubectl apply -f https://raw.githubusercontent.com/l7mp/net-debug/refs/heads/main/examples/net-debug.yaml
```
### Create a Deployment in host network
Config: [yaml](examples/net-debug-host.yaml)
Usage:
```console
kubectl apply -f examples/net-debug-host.yaml
```
or
```console
kubectl apply -f https://raw.githubusercontent.com/l7mp/net-debug/refs/heads/main/examples/net-debug-host.yaml
```
### Create a DeamonSet in host network
Config: [yaml](examples/net-debug-daemonset.yaml)
Usage:
```console
kubectl apply -f examples/net-debug-dameonset.yaml
```
or
```console
kubectl apply -f https://raw.githubusercontent.com/l7mp/net-debug/refs/heads/main/examples/net-debug-daemonset.yaml
```
### Attach to a pod as debug container
To attach net-debug to an existing pod as a [debug container](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_debug/):
```console
kubectl debug -it --image=docker.io/l7mp/net-debug -- bash
```
## Help
Development is coordinated in Discord, feel free to [join](https://discord.gg/DyPgEsbwzc).
## License
MIT License - see [LICENSE](LICENSE) for full text.