Installation
Dieser Abschnitt behandelt die Schritte zur Einrichtung deiner lokalen Umgebung für die Solana-Entwicklung.
Schnellinstallation
Auf Mac und Linux führe diesen einzelnen Befehl aus, um alle Abhängigkeiten zu installieren.
$curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash
Windows-Benutzer: du musst zuerst WSL installieren (siehe Abhängigkeiten installieren). Führe dann den vorherigen Befehl im Ubuntu (Linux)-Terminal aus.
Nach der Installation solltest du eine Ausgabe wie die folgende sehen:
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
Wenn der Schnellinstallationsbefehl nicht funktioniert, beziehe dich bitte auf den Abschnitt Abhängigkeiten installieren unten für Anweisungen zur individuellen Installation jeder Abhängigkeit.
Wenn der Schnellinstallationsbefehl erfolgreich ausgeführt wird, springe zu den Abschnitten Solana CLI Grundlagen und Anchor CLI Grundlagen unten.
Abhängigkeiten installieren
Die Anweisungen unten führen dich durch die individuelle Installation jeder Abhängigkeit.
- Windows-Benutzer müssen zuerst WSL (Windows Subsystem for Linux) installieren und dann die im Linux-Abschnitt unten angegebenen Abhängigkeiten installieren.
- Linux-Benutzer sollten zuerst die im Linux-Abschnitt unten angegebenen Abhängigkeiten installieren.
- Mac-Benutzer sollten mit den Rust-Installationsanweisungen unten beginnen.
Rust installieren
Entwickler erstellen Solana-Programme mit der Rust-Programmiersprache.
Installieren Sie Rust mit rustup.
Führen Sie den folgenden Befehl aus, um Rust zu installieren:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Nach Abschluss der Installation sollte die folgende Meldung angezeigt werden:
Führen Sie den folgenden Befehl aus, um Ihre PATH-Umgebungsvariable neu zu laden, damit sie das bin-Verzeichnis von Cargo enthält:
$. "$HOME/.cargo/env"
Um zu überprüfen, ob die Installation erfolgreich war, prüfen Sie die Rust-Version:
$rustc --version
Sie sollten eine Ausgabe wie die folgende sehen:
rustc 1.86.0 (05f9846f8 2025-03-31)
Installation der Solana CLI
Die Solana CLI stellt alle erforderlichen Tools zum Erstellen und Bereitstellen von Solana-Programmen zur Verfügung.
Installieren Sie die Solana CLI-Tool-Suite mit dem offiziellen Installationsbefehl:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Sie können stable
durch das Release-Tag ersetzen, das der Softwareversion
Ihres gewünschten Releases entspricht (z.B. v2.0.3
), oder verwenden Sie einen
der drei symbolischen Kanalnamen: stable
, beta
oder edge
.
Bei einer Erstinstallation der Solana CLI wird möglicherweise die folgende
Meldung angezeigt, die Sie auffordert, eine PATH
-Umgebungsvariable
hinzuzufügen:
Schließen und öffnen Sie Ihr Terminal erneut, um die PATH-Änderungen zu übernehmen, oder führen Sie Folgendes in Ihrer bestehenden Shell aus:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
Wenn Sie Linux oder WSL verwenden, müssen Sie die Solana CLI-Binärdatei
zu Ihrem PATH
hinzufügen, damit der Befehl in Ihrem Terminal verfügbar ist.
Führen Sie zunächst den folgenden Befehl aus, um zu überprüfen, welche Shell Sie verwenden:
$echo $SHELL
- Wenn die Ausgabe
/bash
enthält, verwenden Sie.bashrc
. - Wenn die Ausgabe
/zsh
enthält, verwenden Sie.zshrc
.
Führen Sie je nach Ihrer Shell den entsprechenden Befehl aus.
Für Bash (bashrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Für Zsh (zshrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
Führen Sie dann den folgenden Befehl aus, um die Terminal-Sitzung zu aktualisieren oder starten Sie Ihr Terminal neu.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Um zu überprüfen, ob die Installation erfolgreich war, prüfen Sie die Solana CLI-Version:
$solana --version
Sie sollten eine Ausgabe wie die folgende sehen:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Du kannst alle verfügbaren Versionen im Agave Github-Repository einsehen.
Agave ist der Validator-Client von Anza, früher bekannt als Solana Labs Validator-Client.
Um die Solana CLI später auf die neueste Version zu aktualisieren, kannst du den folgenden Befehl verwenden:
$agave-install update
Installation der Anchor CLI
Anchor ist ein Framework für die Entwicklung von Solana Programmen. Das Anchor-Framework nutzt Rust-Makros, um den Prozess des Schreibens von Solana-Programmen zu vereinfachen.
Du kannst die Anchor CLI und die Tools auf zwei Arten installieren:
- Anchor Version Manager (AVM) - Empfohlene Installationsmethode
- Ohne AVM - Direkte Installation von GitHub
Der Anchor Version Manager (AVM) ermöglicht es dir, verschiedene Anchor-Versionen auf deinem System zu installieren und zu verwalten sowie Anchor-Versionen in Zukunft einfach zu aktualisieren.
Installiere AVM mit dem folgenden Befehl:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
Bestätige, dass AVM erfolgreich installiert wurde:
$avm --version
Installiere die neueste Version der Anchor CLI mit AVM:
$avm install latest$avm use latest
Du kannst eine bestimmte Version der Anchor CLI installieren, indem du die Versionsnummer angibst:
$avm install 0.30.1$avm use 0.30.1
Vergiss nicht, den Befehl avm use
auszuführen, um die zu verwendende
Anchor CLI Version auf deinem System festzulegen.
- Wenn du die Version
latest
installiert hast, führeavm use latest
aus. - Wenn du die Version
0.30.1
installiert hast, führeavm use 0.30.1
aus.
Um zu überprüfen, ob die Installation erfolgreich war, prüfe die Anchor CLI-Version:
$anchor --version
Du solltest eine Ausgabe wie die folgende sehen:
anchor-cli 0.31.1
Bei der Installation der Anchor CLI unter Linux oder WSL kann dieser Fehler auftreten:
error: could not exec the linker cc = note: Permission denied (os error 13)
Wenn du diese Fehlermeldung siehst:
- Installiere die Abhängigkeiten, die im Abschnitt Linux am Anfang dieser Seite aufgeführt sind.
- Versuche erneut, die Anchor CLI zu installieren.
Node.js und Yarn
Die Standard-Anchor-Projekt-Testdatei (TypeScript), die mit dem
anchor init
Befehl erstellt wird, benötigt Node.js und Yarn. (Eine
Rust-Test-Vorlage ist verfügbar mit anchor init --test-template rust
)
Wenn Sie beim Ausführen von anchor build
auf folgende Fehler stoßen:
Nach Anwendung der vorherigen Lösung versuchen Sie erneut, anchor build
auszuführen.
Wenn Sie anchor test
nach der Erstellung eines neuen Anchor-Projekts
unter Linux oder WSL ausführen, können folgende Fehler auftreten, falls Node.js
oder Yarn nicht installiert sind:
Permission denied (os error 13)
No such file or directory (os error 2)
Einrichtung von KI-Tools für die Solana-Entwicklung
Dieser Abschnitt beschreibt die optionale Einrichtung von KI-Tools, die Sie zur Beschleunigung Ihrer Solana-Entwicklung nutzen können.
Tool | Beschreibung | Link |
---|---|---|
MCP | MCP-Server, mit dem Sie sich über Cursor verbinden können, um die KI-unterstützte Solana-Entwicklung zu verbessern. | https://mcp.solana.com/ |
LLMs.txt | LLM-optimierte Dokumentation, die Sie zur Schulung von LLMs mit Solana-Dokumenten verwenden können. | https://solana.com/llms.txt |
Grundlagen der Solana CLI
Dieser Abschnitt führt durch einige gängige Solana CLI-Befehle, um Ihnen den Einstieg zu erleichtern.
Solana-Konfiguration
Um Ihre aktuelle Konfiguration anzuzeigen:
$solana config get
Sie sollten eine Ausgabe wie die folgende sehen:
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
Die RPC-URL und Websocket-URL geben den Solana-Cluster an, an den die CLI Anfragen sendet.
Sie können den Solana CLI-Cluster mit den folgenden Befehlen aktualisieren:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
Sie können auch die folgenden Kurzoptionen verwenden:
$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
Der Keypair-Pfad verweist auf das Standard-Solana-Wallet (Keypair), das von der
Solana CLI verwendet wird, um Transaktionsgebühren zu bezahlen und Programme zu
deployen. Standardmäßig wird diese Datei unter ~/.config/solana/id.json
gespeichert.
Wallet erstellen
Um Transaktionen mit der Solana CLI zu senden, benötigen Sie ein Solana-Wallet mit SOL.
Um ein Keypair am Standard-Keypair-Pfad zu generieren, führen Sie den folgenden Befehl aus:
$solana-keygen new
Sie sollten eine Ausgabe wie die folgende sehen:
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===========================================================================
Wenn Sie bereits ein Dateisystem-Wallet am Standardspeicherort gespeichert
haben, überschreibt dieser Befehl es nicht, es sei denn, Sie erzwingen das
Überschreiben ausdrücklich mit dem --force
Flag.
Um die Adresse (öffentlichen Schlüssel) Ihres Wallets anzuzeigen, führen Sie aus:
$solana address
SOL per Airdrop erhalten
Fordern Sie einen Airdrop von SOL für Ihr Wallet an, um Transaktionen und Programm- Deployments zu bezahlen.
Stellen Sie Ihren Cluster auf devnet ein:
$solana config set -ud
Dann fordern Sie einen Airdrop von Devnet-SOL an:
$solana airdrop 2
Devnet-Airdrops begrenzen Anfragen auf 5 SOL pro Anfrage. Wenn Sie auf Ratenlimits stoßen oder Fehler auftreten, versuchen Sie stattdessen den Web Faucet zu verwenden.
Um den SOL-Kontostand Ihres Wallets zu überprüfen, führen Sie den folgenden Befehl aus:
$solana balance
Lokalen Validator ausführen
Die Solana CLI enthält einen integrierten Test-Validator für die lokale Entwicklung.
Führen Sie in einem separaten Terminal den folgenden Befehl aus, um einen lokalen Validator zu starten:
$solana-test-validator
Denken Sie daran, Ihre CLI auch auf localhost zu aktualisieren, bevor Sie Solana CLI-Befehle ausführen:
$solana config set -ul
Anchor CLI Grundlagen
Dieser Abschnitt führt durch einige gängige Anchor CLI-Befehle, um Ihnen den Einstieg zu erleichtern. Weitere Informationen zur Anchor CLI finden Sie in der Anchor-Dokumentation.
Projekt initialisieren
Um ein neues Anchor-Projekt zu erstellen, führen Sie den folgenden Befehl aus:
$anchor init <project-name>
Um beispielsweise ein Projekt mit dem Namen my-project
zu erstellen, führen
Sie aus:
$anchor init my-project
Dieser Befehl erstellt ein neues Verzeichnis mit dem Projektnamen und initialisiert ein neues Anchor-Projekt mit einer grundlegenden Rust-Programm- und TypeScript-Test-Vorlage.
Navigieren Sie zum Projektverzeichnis:
$cd <project-name>
Sehen Sie sich die Dateistruktur des Anchor-Projekts an.
Programm bauen
Um dein Projekt zu erstellen, führe den folgenden Befehl aus:
$anchor build
Du findest das kompilierte Programm im Verzeichnis /target/deploy
.
Programm bereitstellen
Um dein Projekt bereitzustellen, führe den folgenden Befehl aus:
$anchor deploy
Dieser Befehl stellt dein Programm auf dem in der Datei
Anchor.toml
angegebenen cluster
bereit.
Programm testen
Um dein Projekt zu testen, führe den folgenden Befehl aus:
$anchor test
Dieser Befehl erstellt und stellt dein Projekt bereit und führt die Tests für dein Projekt aus.
Wenn du localnet
als cluster
in Anchor.toml
verwendest, startet Anchor
automatisch einen lokalen Validator, stellt dein Programm bereit, führt Tests
aus und stoppt dann den Validator.
Is this page helpful?