Instalar dependências

Instale cada dependência separadamente quando precisar de uma versão específica ou quando a instalação rápida não for concluída com sucesso. Siga as secções por ordem num ambiente novo, ou aceda diretamente à ferramenta que pretende instalar ou depurar.

Pré-requisitos

Instalar o Rust

Os desenvolvedores criam programas Solana usando a linguagem de programação Rust.

  1. Instale o Rust usando rustup digitando o seguinte comando no seu terminal:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Após uma instalação bem-sucedida, você verá a seguinte mensagem:

  1. Recarregue a sua variável de ambiente PATH para incluir o diretório bin do Cargo:
Terminal
$
. "$HOME/.cargo/env"
  1. Verifique se a instalação foi bem-sucedida.
Terminal
$
rustc --version

O comando apresenta a versão do Rust instalada, por exemplo:

rustc x.y.z (...)

Instalar Solana CLI

A Solana CLI fornece todas as ferramentas necessárias para construir e implementar programas Solana.

  1. Instale o conjunto de ferramentas Solana CLI usando o comando de instalação oficial:
Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Pode substituir stable por uma etiqueta de lançamento específica do Agave ou pelo canal de lançamento beta ou edge.

  1. Disponibilize o Solana CLI no seu terminal atual.

O instalador atualiza a configuração do seu shell e apresenta o comando necessário para atualizar a sessão atual. O comando é normalmente:

Terminal
$
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"

Se solana continuar indisponível, reinicie o terminal. Para confirmar qual o ficheiro de configuração do shell que o instalador atualizou, verifique o seu shell atual:

Terminal
$
echo $SHELL
  • Se a saída contiver /bash, reinicie o terminal ou execute source ~/.bashrc.
  • Se a saída contiver /zsh, reinicie o terminal ou execute source ~/.zshrc.
  1. Verifique se a instalação foi bem-sucedida:
Terminal
$
solana --version

O comando apresenta a versão do Solana CLI instalada, por exemplo:

solana-cli x.y.z (..., client:Agave)

Pode ver todas as versões disponíveis no repositório GitHub do Agave. O Agave é o cliente validator da Anza, anteriormente conhecido como cliente validator da Solana Labs.

  1. Para atualizar o Solana CLI mais tarde, execute:
Terminal
$
agave-install update

Instalar Anchor CLI

Anchor é uma framework para desenvolver programas Solana. A framework Anchor utiliza macros Rust para simplificar o processo de escrever programas Solana.

Pré-requisitos

O Node.js e um gestor de pacotes JavaScript só são necessários quando selecionar um modelo de teste TypeScript, como Mocha ou Jest. O modelo de teste LiteSVM predefinido é executado em Rust e não requer ferramentas Node.js.

Instalação

Você pode instalar a CLI e as ferramentas do Anchor de duas formas:

  • Anchor Version Manager (AVM) — Método de instalação recomendado
  • Sem AVM — Instalar diretamente do GitHub

O Anchor Version Manager (AVM) permite instalar e gerir diferentes versões do Anchor no seu sistema e atualizar facilmente as versões do Anchor no futuro. Para instalar o Anchor usando o AVM, siga os passos abaixo:

  1. Instale o AVM com o seguinte comando:
Terminal
$
curl -sSfL https://raw.githubusercontent.com/otter-sec/anchor/master/avm/install | sh
  1. Confirme que o AVM foi instalado com sucesso:
Terminal
$
avm --version
  1. Instale o Anchor CLI usando o AVM:

Para instalar a versão mais recente:

Terminal
$
avm install latest
$
avm use latest

Para instalar uma versão específica, especifique o número da versão:

Terminal
$
avm install 1.1.2
$
avm use 1.1.2

Ao instalar o Anchor CLI no Linux ou WSL, você pode encontrar este erro:

error: could not exec the linker cc = note: Permission denied (os error 13)

Se você vir esta mensagem de erro, siga estas etapas:

  1. Instale as dependências listadas na seção Linux no topo desta página.
  2. Tente instalar o Anchor CLI novamente.
  1. Verifique se a instalação foi bem-sucedida, verificando a versão do Anchor CLI:
Terminal
$
anchor --version

O comando apresenta a versão ativa do Anchor CLI, por exemplo:

anchor-cli 1.1.2

Execute avm use para selecionar a versão do Anchor CLI do seu sistema.

  • Se instalou a versão mais recente, execute avm use latest.
  • Se instalou a versão 1.1.2, execute avm use 1.1.2.

Instalar Surfpool CLI

Surfpool é uma ferramenta para desenvolvimento local e uma substituição aprimorada para solana-test-validator.

  1. Instale o Surfpool com o seguinte comando:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSfL https://run.surfpool.run/ | bash
  1. Verifique se a instalação foi bem-sucedida verificando a versão do Surfpool CLI:
Terminal
$
surfpool --version

O comando apresenta a versão do Surfpool CLI instalada, por exemplo:

surfpool x.y.z

Is this page helpful?

Índice

Editar Página
© 2026 Fundação Solana. Todos os direitos reservados.