Como instalar o Ghidra no Ubuntu

Antes de instalar o Ghidra no Ubuntu

O Ghidra é um software Java portátil, não um instalador DEB tradicional do Ubuntu. O projeto upstream publica um ZIP multiplataforma com a aplicação, scripts de inicialização, documentação e componentes da plataforma. Uma instalação normal significa preparar o Java, extrair o arquivo e executar o inicializador. Não é preciso copiar arquivos para /usr/bin nem iniciar a interface gráfica como root.

Use um ambiente Ubuntu compatível de 64 bits com espaço gravável para o arquivo, a aplicação extraída, caches do Java, projetos, programas importados e bancos de dados de análise. A documentação do Ghidra indica 4 GB de RAM e 1 GB de armazenamento para os binários instalados como ponto de partida; firmwares grandes e tarefas de decompilação precisam de mais. Uma instalação em ~/tools ou ~/opt costuma evitar problemas de permissão.

Analise somente softwares, firmwares ou imagens de memória que você está autorizado a examinar. Um guia de download explica a procedência e a inicialização, mas não concede permissão para fazer engenharia reversa. Mantenha cada versão do Ghidra em uma pasta separada para comparar resultados e voltar atrás sem sobrescrever a instalação anterior.

Instale o JDK 21 de 64 bits no Ubuntu

O Ghidra 12.1 exige um Java 21 Runtime and Development Kit. Instale um JDK completo, e não apenas um runtime, porque o inicializador e alguns fluxos dependem de java e javac. Nas versões do Ubuntu que oferecem Java 21 nos repositórios, o nome comum do pacote é openjdk-21-jdk. Se o seu repositório não tiver o pacote, use uma distribuição confiável de JDK 21 e siga as instruções dela para Ubuntu.

Depois que o gerenciador de pacotes terminar, abra um terminal novo e confirme a versão ativa. A saída deve mostrar Java 21 e um ambiente de 64 bits. Se outro aplicativo precisar de uma versão diferente, mantenha as duas e escolha o JDK do Ghidra usando JAVA_HOME ou as ferramentas alternatives do Ubuntu. Não remova um JDK apenas porque o Ghidra precisa de um mais recente.

Se o Ghidra disser que não encontrou Java, verifique JAVA_HOME e confirme que ele aponta para a pasta do JDK, não diretamente para o executável java. Essa pasta deve conter bin com java e javac.

Baixe o ZIP oficial do Ghidra

Abra a versão oficial Ghidra 12.1.2 e expanda Assets. Escolha ghidra_12.1.2_PUBLIC_20260605.zip. Esse é o pacote pré-compilado identificado pelo projeto. O GitHub também mostra Source code (zip) e Source code (tar.gz), mas esses arquivos são snapshots do repositório para quem pretende compilar o Ghidra a partir do código-fonte; eles não são o arquivo normal de instalação no Ubuntu.

O ZIP PUBLIC verificado tem 572.803.866 bytes, aproximadamente 546,3 MiB. Este site aponta para o recurso oficial do GitHub e não hospeda, renomeia, envolve ou recompõe o arquivo. Se o navegador salvar uma página HTML, um arquivo muito pequeno ou uma extensão de instalador inesperada, não execute. Volte à versão oficial e escolha o recurso PUBLIC.

Ao pesquisar Ghidra no Ubuntu, você pode encontrar pacotes Snap, apt ou de distribuições de segurança. Eles podem ser úteis em um ambiente controlado, mas sua versão, manutenção e patches podem ser diferentes do projeto upstream. Use o recurso oficial do GitHub quando a prioridade for o build upstream atual e um checksum que possa ser verificado diretamente.

Verifique o ZIP com SHA-256

As notas da versão publicam um digest SHA-256 para o ZIP executável. Verificar o hash é útil quando o download foi interrompido, passou por um proxy ou precisa ter sua procedência registrada. A verificação detecta bytes modificados ou corrompidos; ela não torna um espelho desconhecido oficial e não substitui uma auditoria completa de segurança.

Execute sha256sum na pasta que contém o arquivo baixado e compare o valor completo com o digest oficial: b62e81a0390618466c019c60d8c2f796ced2509c4c1aea4a37644a77272cf99d. Se um único caractere for diferente, remova o arquivo e baixe novamente a partir da versão oficial.

Extraia o Ghidra e execute ./ghidraRun

Crie uma pasta tools pertencente ao seu usuário, extraia todo o arquivo e preserve sua estrutura. Não inicie o Ghidra de dentro do arquivo compactado. Uma extração completa deve deixar pastas como Ghidra, Extensions, support, docs e server ao lado do script ./ghidraRun.

Execute o inicializador a partir da pasta extraída como seu usuário normal do Ubuntu. Na primeira instalação, o Java pode demorar um pouco mais para inicializar módulos e criar configurações. Quando a janela de projetos aparecer, crie um Non-Shared Project em uma pasta de projetos separada. Manter aplicação e dados separados deixa as atualizações mais seguras.

Se o shell mostrar Permission denied, verifique o modo do inicializador e adicione o bit de execução somente a esse script. Não marque recursivamente todos os arquivos da distribuição como executáveis. Se a aplicação fechar imediatamente, execute-a pelo terminal ou use o inicializador de depuração para manter o erro visível.

1. 1

   Criar uma pasta pessoal de ferramentas

   Separe a aplicação dos projetos e evite uma instalação gráfica pertencente ao root.

   mkdir -p ~/tools
2. 2

   Extrair o ZIP completo

   Preserve todas as pastas e use um destino novo para essa versão.

   unzip ghidra_12.1.2_PUBLIC_20260605.zip -d ~/tools
3. 3

   Entrar na pasta extraída

   Confirme que o inicializador e support estão visíveis antes de continuar.

   cd ~/tools/ghidra_12.1.2_PUBLIC
4. 4

   Iniciar o Ghidra como usuário

   Execute a aplicação de desktop sem sudo.

   ./ghidraRun

Solução de problemas no Ubuntu, WSL2 e desktop

Para erros como java not found ou unsupported JDK, execute java -version e javac -version novamente no mesmo terminal usado para iniciar o Ghidra. Se eles apontarem para Java 17 ou apenas para um pacote runtime, instale ou selecione um JDK 21 de 64 bits. Defina JAVA_HOME para a pasta do JDK, e não para /usr/bin/java, que é apenas um link de inicialização.

O WSL2 pode executar o Ghidra, mas a experiência depende de o Windows fornecer um caminho gráfico como WSLg ou um servidor X. Um shell Linux sem display ainda pode usar support/analyzeHeadless para trabalhos em lote, enquanto a janela de projetos precisa de uma tela funcional. Confira echo $DISPLAY e a configuração WSLg/X antes de considerar uma janela em branco como falha de instalação.

No Wayland, em desktops remotos ou em gerenciadores de janelas que não fazem reparenting, o Java pode precisar da propriedade de inicialização documentada pelo Ghidra. Altere uma variável por vez, mantenha uma cópia de support/launch.properties e registre o erro do terminal. Para erros de permissão, mova a aplicação para um sistema de arquivos executável pertencente ao seu usuário em vez de executá-la como root.

Crie o primeiro projeto e atualize com segurança

Use File > New Project e escolha Non-Shared Project para uma instalação local no Ubuntu. Salve o projeto fora de ~/tools/ghidra_12.1.2_PUBLIC para que substituir a pasta da aplicação não remova os dados de análise. Faça backup do arquivo .gpr e da pasta .rep correspondente quando o projeto for importante.

Para atualizar, baixe a nova versão oficial ao lado da pasta antiga, verifique o checksum e teste uma cópia dos projetos importantes antes de remover a versão anterior. O Ghidra não usa um desinstalador de desktop tradicional: feche a aplicação, preserve projetos e scripts e remova a pasta extraída. Revise configurações e caches do usuário separadamente se quiser uma redefinição completa.

Se você precisa de automação em vez da interface gráfica, use support/analyzeHeadless a partir da mesma distribuição verificada. Fixe a versão do Ghidra e do JDK em scripts ou contêineres, grave projetos em caminhos controlados e não processe amostras não confiáveis com privilégios elevados.