1 unstable release
0.1.0 | Nov 5, 2024 |
---|
#236 in Unix APIs
23KB
441 lines
Dockerdump
- extract files from Docker images
Dockerdump is an interactive tool for fetching and extracting files from Docker container images. It allows you to download images from Docker Hub or custom registries and browse their contents with an intuitive interface.
Suppose there is some binary that you know is compatible with your system, but the building process is complex or time-consuming. You can use Dockerdump to extract the binary from a Docker image and run it on your machine without the overhead of using Docker or dealing with the docker daemon.
Features
- Interactive file browser with directory navigation
- Support for both Docker Hub and custom registries
- Multi-file selection capabilities
Installation
Prerequisites
- Rust toolchain (1.56 or later)
- Cargo package manager
Steps
Option 1: Install from Crates.io
cargo install dockerdump
Option 2: Build from Source
- Clone the repository:
git clone https://github.com/saefstroem/dockerdump.git
cd dockerdump
- Build the project:
cargo build --release
- Run the binary:
./target/release/dockerdump
Usage
- Launch the application via the terminal:
dockerdump
- Enter a Docker image tag (e.g.,
ubuntu:latest
) - Choose between Docker Hub or a custom registry
- Navigate through the extracted files using:
- Arrow keys to move up/down
- Space to select files
- Enter to confirm selection
- Select "[Done browsing]" to exit
License
This project is licensed under the MIT License - see the LICENSE file for details.
Security Note
Dockerdump extracts files with controlled permissions (666) for safety. Be cautious when exploring untrusted container images.
Support my work
kaspa:qphqua5wghak5umtmv8h9cdkfg46up42wjwr0eam528htx945ymdz9sa0fvpn
0x0d96F733969ED1ae8C58Bcad6F6B11993B051cC4
Note: Always verify the source and content of Docker images before using them in production environments.
Dependencies
~17–31MB
~499K SLoC