Instalacja
Ta sekcja opisuje kroki konfiguracji lokalnego środowiska do rozwoju Solana.
Szybka instalacja
Na Mac i Linux uruchom jedno polecenie, aby zainstalować wszystkie zależności.
$curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash
Użytkownicy Windows: najpierw musisz zainstalować WSL (zobacz Instalacja zależności). Następnie uruchom powyższe polecenie w terminalu Ubuntu (Linux).
Po instalacji powinieneś zobaczyć wynik podobny do poniższego:
Installed Versions:Rust: rustc 1.86.0 (05f9846f8 2025-03-31)Solana CLI: solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)Anchor CLI: anchor-cli 0.31.1Node.js: v23.11.0Yarn: 1.22.1
Jeśli polecenie szybkiej instalacji nie działa, zapoznaj się z sekcją Instalacja zależności poniżej, aby uzyskać instrukcje instalacji każdej zależności osobno.
Jeśli polecenie szybkiej instalacji zakończy się powodzeniem, przejdź do sekcji Podstawy Solana CLI i Podstawy Anchor CLI poniżej.
Instalacja zależności
Poniższe instrukcje prowadzą przez instalację każdej zależności osobno.
- Użytkownicy Windows muszą najpierw zainstalować WSL (Windows Subsystem for Linux), a następnie zainstalować zależności określone w sekcji Linux poniżej.
- Użytkownicy Linux powinni najpierw zainstalować zależności określone w sekcji Linux poniżej.
- Użytkownicy Mac powinni zacząć od instrukcji instalacji Rust poniżej.
Zainstaluj Rust
Deweloperzy tworzą programy Solana, używając języka programowania Rust.
Zainstaluj Rust za pomocą rustup.
Uruchom następujące polecenie, aby zainstalować Rust:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Po zakończeniu instalacji powinien pojawić się następujący komunikat:
Uruchom następujące polecenie, aby przeładować zmienną środowiskową PATH, aby uwzględniała katalog bin Cargo:
$. "$HOME/.cargo/env"
Aby zweryfikować, czy instalacja zakończyła się sukcesem, sprawdź wersję Rust:
$rustc --version
Powinieneś zobaczyć wynik podobny do poniższego:
rustc 1.86.0 (05f9846f8 2025-03-31)
Zainstaluj Solana CLI
Solana CLI dostarcza wszystkie narzędzia potrzebne do tworzenia i wdrażania programów Solana.
Zainstaluj pakiet narzędzi Solana CLI za pomocą oficjalnego polecenia instalacyjnego:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Możesz zastąpić stable
tagiem wydania odpowiadającym wersji oprogramowania
twojego pożądanego wydania (np. v2.0.3
), lub użyć jednej z trzech
symbolicznych nazw kanałów: stable
, beta
, lub edge
.
Podczas pierwszej instalacji Solana CLI możesz zobaczyć następujący komunikat,
który zachęca do dodania zmiennej środowiskowej PATH
:
Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
Jeśli używasz Linuxa lub WSL, musisz dodać binarkę Solana CLI do twojego
PATH
, aby polecenie było dostępne w terminalu.
Najpierw uruchom następujące polecenie, aby sprawdzić, której powłoki używasz:
$echo $SHELL
- Jeśli wynik zawiera
/bash
, użyj.bashrc
. - Jeśli wynik zawiera
/zsh
, użyj.zshrc
.
W zależności od używanej powłoki uruchom odpowiednie polecenie.
Dla Bash (bashrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Dla Zsh (zshrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
Następnie uruchom następujące polecenie, aby odświeżyć sesję terminala lub zrestartuj swój terminal.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Aby zweryfikować, czy instalacja zakończyła się sukcesem, sprawdź wersję Solana CLI:
$solana --version
Powinieneś zobaczyć wynik podobny do poniższego:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Możesz zobaczyć wszystkie dostępne wersje w repozytorium Agave na GitHubie.
Agave to klient walidatora od Anza, wcześniej znany jako klient walidatora Solana Labs.
Aby później zaktualizować Solana CLI do najnowszej wersji, możesz użyć następującego polecenia:
$agave-install update
Instalacja Anchor CLI
Anchor to framework do tworzenia programów Solana. Framework Anchor wykorzystuje makra w języku Rust, aby uprościć proces pisania programów Solana.
Możesz zainstalować Anchor CLI i narzędzia na dwa sposoby:
- Anchor Version Manager (AVM) - zalecana metoda instalacji
- Bez AVM - instalacja bezpośrednio z GitHuba
Anchor Version Manager (AVM) pozwala na instalację i zarządzanie różnymi wersjami Anchor na twoim systemie oraz łatwą aktualizację wersji Anchor w przyszłości.
Zainstaluj AVM za pomocą następującego polecenia:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
Potwierdź, że AVM został pomyślnie zainstalowany:
$avm --version
Zainstaluj najnowszą wersję Anchor CLI za pomocą AVM:
$avm install latest$avm use latest
Możesz zainstalować konkretną wersję Anchor CLI, podając numer wersji:
$avm install 0.30.1$avm use 0.30.1
Nie zapomnij uruchomić polecenia avm use
, aby zadeklarować wersję
Anchor CLI, która ma działać na Twoim systemie.
- Jeśli zainstalowałeś wersję
latest
, uruchomavm use latest
. - Jeśli zainstalowałeś wersję
0.30.1
, uruchomavm use 0.30.1
.
Aby zweryfikować, czy instalacja zakończyła się sukcesem, sprawdź wersję Anchor CLI:
$anchor --version
Powinieneś zobaczyć wynik podobny do poniższego:
anchor-cli 0.31.1
Podczas instalacji Anchor CLI na Linuksie lub WSL możesz napotkać ten błąd:
error: could not exec the linker cc = note: Permission denied (os error 13)
Jeśli zobaczysz ten komunikat o błędzie:
- Zainstaluj zależności wymienione w sekcji Linux na początku tej strony.
- Spróbuj ponownie zainstalować Anchor CLI.
Node.js i Yarn
Domyślny plik testowy projektu Anchor (TypeScript) utworzony za pomocą polecenia
anchor init
wymaga Node.js i Yarn. (Szablon testowy w Rust jest
dostępny przy użyciu anchor init --test-template rust
)
Podczas uruchamiania anchor build
, jeśli napotkasz następujące błędy:
Po zastosowaniu powyższego rozwiązania spróbuj ponownie uruchomić
anchor build
.
Podczas uruchamiania anchor test
po utworzeniu nowego projektu Anchor
na Linuxie lub WSL możesz napotkać następujące błędy, jeśli nie masz
zainstalowanego Node.js lub Yarn:
Permission denied (os error 13)
No such file or directory (os error 2)
Podstawy Solana CLI
Ta sekcja przeprowadza przez niektóre popularne polecenia Solana CLI, aby pomóc Ci zacząć.
Konfiguracja Solana
Aby zobaczyć swoją aktualną konfigurację:
$solana config get
Powinieneś zobaczyć wynik podobny do poniższego:
Config File: /Users/test/.config/solana/cli/config.ymlRPC URL: https://api.mainnet-beta.solana.comWebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)Keypair Path: /Users/test/.config/solana/id.jsonCommitment: confirmed
Adresy URL RPC i Websocket określają klaster Solana, do którego CLI wysyła żądania.
Możesz zaktualizować klaster Solana CLI za pomocą następujących poleceń:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
Możesz również użyć następujących skróconych opcji:
$solana config set -um # For mainnet-beta$solana config set -ud # For devnet$solana config set -ul # For localhost$solana config set -ut # For testnet
Ścieżka Keypair wskazuje na domyślny portfel Solana (keypair) używany przez
Solana CLI do opłacania opłat transakcyjnych i wdrażania programów. Domyślnie
ten plik jest przechowywany w ~/.config/solana/id.json
.
Utwórz portfel
Aby wysyłać transakcje za pomocą Solana CLI, potrzebujesz portfela Solana zasilonego w SOL.
Aby wygenerować keypair w domyślnej ścieżce Keypair, uruchom następujące polecenie:
$solana-keygen new
Powinieneś zobaczyć wynik podobny do poniższego:
Generating a new keypairFor added security, enter a BIP39 passphraseNOTE! This passphrase improves security of the recovery seed phrase NOT thekeypair file itself, which is stored as insecure plain textBIP39 Passphrase (empty for none):Wrote new keypair to /Users/test/.config/solana/id.json===========================================================================pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT===========================================================================Save this seed phrase and your BIP39 passphrase to recover your new keypair:cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing===========================================================================
Jeśli masz już portfel systemu plików zapisany w domyślnej lokalizacji, to
polecenie nie nadpisze go, chyba że wyraźnie wymusisz nadpisanie za pomocą flagi
--force
.
Aby wyświetlić adres (klucz publiczny) swojego portfela, uruchom:
$solana address
Airdrop SOL
Poproś o airdrop SOL do swojego portfela, aby opłacić transakcje i wdrożenia programów.
Ustaw swój klaster na devnet:
$solana config set -ud
Następnie poproś o airdrop devnet SOL:
$solana airdrop 2
Airdropy na devnecie ograniczają żądania do 5 SOL na żądanie. Jeśli napotkasz limity lub błędy, spróbuj skorzystać z Web Faucet.
Aby sprawdzić saldo SOL w swoim portfelu, uruchom następujące polecenie:
$solana balance
Uruchom lokalny walidator
Solana CLI zawiera wbudowany testowy walidator do lokalnego developmentu.
W osobnym terminalu uruchom następujące polecenie, aby uruchomić lokalny walidator:
$solana-test-validator
Pamiętaj, aby również zaktualizować CLI do używania localhost przed uruchomieniem poleceń Solana CLI:
$solana config set -ul
Podstawy Anchor CLI
Ta sekcja przeprowadza przez kilka podstawowych poleceń Anchor CLI, aby pomóc Ci zacząć. Więcej informacji o Anchor CLI znajdziesz w dokumentacji Anchor.
Inicjalizacja projektu
Aby utworzyć nowy projekt Anchor, uruchom następujące polecenie:
$anchor init <project-name>
Na przykład, aby utworzyć projekt o nazwie my-project
, uruchom:
$anchor init my-project
To polecenie tworzy nowy katalog o nazwie projektu i inicjalizuje nowy projekt Anchor z podstawowym programem w języku Rust oraz szablonem testów w TypeScript.
Przejdź do katalogu projektu:
$cd <project-name>
Zobacz strukturę plików projektu Anchor.
Budowanie programu
Aby zbudować swój projekt, uruchom następujące polecenie:
$anchor build
Skompilowany program znajdziesz w katalogu /target/deploy
.
Wdrażanie programu
Aby wdrożyć swój projekt, uruchom następujące polecenie:
$anchor deploy
To polecenie wdraża Twój program do cluster
określonego w pliku
Anchor.toml
.
Testowanie programu
Aby przetestować swój projekt, uruchom następujące polecenie:
$anchor test
To polecenie buduje, wdraża i uruchamia testy dla Twojego projektu.
Kiedy używasz localnet
jako cluster
w Anchor.toml
, Anchor automatycznie
uruchamia lokalny validator, wdraża Twój program, uruchamia testy, a następnie
zatrzymuje validator.
Is this page helpful?