blacktop/ghidra

Ghidra客户端/服务器Docker镜像

https://github.com/blacktop/docker-ghidra https://github.com/blacktop/docker-ghidra

Ghidra客户端/服务器Docker镜像

https://hub.docker.com/r/blacktop/ghidra/ https://hub.docker.com/r/blacktop/ghidra/ https://hub.docker.com/r/blacktop/ghidra/

镜像概述和主要用途

Ghidra是由NSA开发的工程框架，本Docker镜像提供了Ghidra的容器化部署方案，支持客户端、服务器及无头（Headless）三种运行模式。无需在本地安装Java和Ghidra依赖，即可便捷地进行工程分析，适用于单机分析、团队协作及自动化分析流程。

核心功能和特性

• 容器化部署：避免本地环境污染，简化Ghidra安装与配置流程
• 多模式支持：提供客户端（图形界面）、服务器（项目共享）及无头模式（自动化分析）
• 资源可控：可配置CPU、内存等资源限制，优化性能
• 数据持久化：支持挂载本地样本目录和项目目录，确保数据不丢失
• 版本标签：提供多个版本标签（如latest、10、beta），满足不同需求

使用场景和适用范围

• ***工程分析人员：无需配置本地环境，快速启动Ghidra进行二进制分析
• 团队协作：通过服务器模式共享项目，支持多人协同分析
• 自动化流程：结合无头模式，将Ghidra集成到脚本或CI/CD pipeline中实现自动化分析

为何使用？

因为在Mac上安装Java很麻烦。😉

依赖项

• https://hub.docker.com/_/openjdk

镜像标签

bash
REPOSITORY               TAG                 SIZE
blacktop/ghidra          latest              1.33GB
blacktop/ghidra          10                  1.33GB
blacktop/ghidra          10-beta             1.4GB
blacktop/ghidra          9.2                 1.33GB
blacktop/ghidra          9.1                 1.18GB
blacktop/ghidra          9.0                 1.18GB

注意： 标签 beta 基于 master 分支构建

快速开始

客户端

在macOS上

1. 安装XQuartz：brew cask install xquartz
2. 安装socat：brew install socat
3. 打开XQuartz（open -a XQuartz），确保勾选“允许来自网络客户端的连接”
4. 使用Xhost添加IP：xhost + 127.0.0.1 或 xhost + $(ipconfig getifaddr en0)
5. 启动socat：socat TCP-LISTEN:6000,reuseaddr,fork UNIX-CLIENT:\"$DISPLAY\"
6. 启动Ghidra

bash
$ docker run --init -it --rm \
             --name ghidra \
             --cpus 2 \
             --memory 4g \
             -e MAXMEM=4G \
             -e DISPLAY=host.docker.internal:0 \
             -v /path/to/samples:/samples \
             -v /path/to/projects:/root \
             blacktop/ghidra

服务器

bash
$ docker run --init -it --rm \
             --name ghidra-server \
             --cpus 2 \
             --memory 500m \
             -e MAXMEM=500M \
             -e GHIDRA_USERS="root blacktop" \
             -v /path/to/repos:/repos \
             blacktop/ghidra server

无头模式

bash
$ docker run --init -it --rm \
             --name ghidra-headless \
             --cpus 2 \
             --memory 4g \
             -e MAXMEM=4G \
             -v `pwd`:/samples \
             --link ghidra-server \
             blacktop/ghidra:beta support/analyzeHeadless ghidra://ghidra-server:13100/Apple/12.4.1/ -import /samples/dyld_shared_cache -connect blacktop -p -commit "加载Dyld。"

环境变量说明

待办事项

• 研究如何添加--network none 😉
• 研究如何添加--read-only

问题反馈

发现bug？需要更多功能？文档有遗漏？请随时https://github.com/blacktop/docker-ghidra/issues/new

致谢

• NSA研究总局 [***]

许可证

Apache许可证（版本2.0）