{"id":15199889,"url":"https://github.com/p3gleg/whaler","last_synced_at":"2025-05-14T21:07:24.950Z","repository":{"id":39098313,"uuid":"136115520","full_name":"P3GLEG/Whaler","owner":"P3GLEG","description":"Program to reverse Docker images into Dockerfiles","archived":false,"fork":false,"pushed_at":"2025-04-16T23:32:24.000Z","size":6147,"stargazers_count":1121,"open_issues_count":3,"forks_count":97,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-05-13T23:52:11.186Z","etag":null,"topics":["docker-image","docker-security","dockerfile","passwords","reverse-engineering","secrets","security","security-tools"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/P3GLEG.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-06-05T03:37:18.000Z","updated_at":"2025-04-25T09:31:59.000Z","dependencies_parsed_at":"2025-04-11T06:39:24.686Z","dependency_job_id":null,"html_url":"https://github.com/P3GLEG/Whaler","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/P3GLEG%2FWhaler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/P3GLEG%2FWhaler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/P3GLEG%2FWhaler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/P3GLEG%2FWhaler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/P3GLEG","download_url":"https://codeload.github.com/P3GLEG/Whaler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254227612,"owners_count":22035669,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker-image","docker-security","dockerfile","passwords","reverse-engineering","secrets","security","security-tools"],"created_at":"2024-09-28T02:20:22.682Z","updated_at":"2025-05-14T21:07:19.919Z","avatar_url":"https://github.com/P3GLEG.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n  Title: Whaler\n  Description: reverse docker images easily \n  Author: pegleg\n  --\u003e\n\n# Whaler\n\n\nWhaler is a Go program which is designed to reverse engineer docker images into the Dockerfile that created it.  It currently performs the following actions\n\n  - Generates a Dockerfile from an Image\n  - Searches added filenames for potential secret files\n  - Extracts files that were added by the Docker ADD/COPY Instructions\n  - It also displays misc. information such as ports open, the user it runs as and environment variables. \n\n\n### How to run it\n\nThe easiest way is to run the tool in docker container:\n\n```bash\ndocker pull pegleg/whaler\ndocker run -t --rm -v /var/run/docker.sock:/var/run/docker.sock:ro pegleg/whaler -sV=1.36 nginx:latest\n```\n\n```bash\ndocker build --rm -t pegleg/whaler .\nalias whaler=\"docker run -t --rm -v /var/run/docker.sock:/var/run/docker.sock:ro pegleg/whaler\"\nwhaler -sV=1.36 nginx:latest\n```\n\nThis tool will pull target docker image automatically. Parameter `-sV=1.36` is not always required.\n\n### How to build it\nGit clone the project into your $GOPATH/src directory and perform the following command\n```bash\ngo get -u github.com/P3GLEG/Whaler\ncd $GOPATH/src/github.com/P3GLEG/Whaler\ngo build .\n```\n\n### How to run it\n```go\n./Whaler\nUsage of ./Whaler:\n  -f string\n    \tFile containing images to analyze seperated by line\n  -filter\n    \tFilters filenames that create noise such as node_modules. Check ignore.go file for more details (default true)\n  -sV string\n    \tSet the docker client ID to a specific version -sV=1.36\n  -v\tPrint all details about the image\n  -x\tSave layers to current directory\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fp3gleg%2Fwhaler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fp3gleg%2Fwhaler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fp3gleg%2Fwhaler/lists"}