README.md

docker-dbg

Python package to effortlessly debug any process running in a x86_64 Linux docker container

Demo

docker-dbg-demo2.mp4

Checkout the demo directory for more demos.

Installation

pip install git+https://github.com/junron/docker-dbg

Usage

Docker-dbg mirrors the pwntools GDB module's debug and attach:

from docker_dbg import *

# Execute and debug the `/demo` binary in `container`:
p, docker_process = docker_debug("/demo", container="container")

# Attach to an existing process `demo` in `container`:
docker_process = docker_attach(proc="demo", container="container")

docker_process.gdb provides access to the pwntools GDB module. The docker_process.libc provides access to the libc executing in the container.

Checkout ubuntu/demo.py for an example of docker_debug and redpwn_jail/demo.py for docker_attach.

How it works

Docker-dbg copies gdbserver into the docker container, then uses fast reverse proxy to proxy the gdbserver port out of the docker container.

Dependencies

On the host

• Python 3 with pwntools
• gdb
• Docker (current user should be added to the docker group)

In the container

• root user
• Commands: cat, cp, chmod, ps, rm
• Optional: killall, kill, ip, awk
• A functional /proc filesystem
• / must be writable by root

These requirements shouldn't be a problem for most Linux docker containers.

Packaged binaries

• Statically compiled gdbserver (13.2, compiled with ./configure CXXFLAGS="-fPIC -static" --disable-inprocess-agent )
• Statically compiled frps and frpc (v0.58.1, from https://github.com/fatedier/frp/releases/tag/v0.58.1)