Installiere die Solana CLI und Anchor

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.

Terminal

$ 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.1
Node.js: v23.11.0
Yarn: 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:

Terminal

$ 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:

Terminal

$ . "$HOME/.cargo/env"

Um zu überprüfen, ob die Installation erfolgreich war, prüfen Sie die Rust-Version:

Terminal

$ 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:

Terminal

$ 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:

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"

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:

Terminal

$ 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):

Terminal

$ echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
$ source ~/.bashrc

Für Zsh (zshrc):

Terminal

$ 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.

Terminal

$ source ~/.bashrc # If using Bash
$ source ~/.zshrc # If using Zsh

Um zu überprüfen, ob die Installation erfolgreich war, prüfe die Solana CLI-Version:

Terminal

$ solana --version

Du solltest 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 Repo 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:

Terminal

$ agave-install update

Anchor CLI installieren

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:

Terminal

$ cargo install --git https://github.com/coral-xyz/anchor avm --force

Bestätige, dass AVM erfolgreich installiert wurde:

Terminal

$ avm --version

Installiere die neueste Version der Anchor CLI mit AVM:

Terminal

$ avm install latest
$ avm use latest

Du kannst eine bestimmte Version der Anchor CLI installieren, indem du die Versionsnummer angibst:

Terminal

$ 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ühre avm use latest aus.
Wenn du die Version 0.30.1 installiert hast, führe avm use 0.30.1 aus.

Um zu überprüfen, ob die Installation erfolgreich war, prüfe die Anchor CLI-Version:

Terminal

$ 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 standardmäßige 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 du beim Ausführen von anchor build auf folgende Fehler stößt:

Nach Anwendung der vorherigen Lösung versuchen Sie, anchor build erneut auszuführen.

Wenn Sie anchor test nach dem Erstellen eines neuen Anchor-Projekts unter Linux oder WSL ausführen, können folgende Fehler auftreten, wenn 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 verwenden 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-Dokumentation verwenden können.	https://solana.com/llms.txt

Solana CLI Grundlagen

Dieser Abschnitt führt durch einige gängige Solana CLI-Befehle, um dir den Einstieg zu erleichtern.

Solana Config

Um deine aktuelle Konfiguration anzuzeigen:

Terminal

$ solana config get

Du solltest eine Ausgabe wie die folgende sehen:

Config File: /Users/test/.config/solana/cli/config.yml
RPC URL: https://api.mainnet-beta.solana.com
WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)
Keypair Path: /Users/test/.config/solana/id.json
Commitment: confirmed

Die RPC-URL und Websocket-URL geben den Solana-Cluster an, an den die CLI Anfragen sendet.

Du kannst den Solana CLI-Cluster mit den folgenden Befehlen aktualisieren:

Terminal

$ solana config set --url mainnet-beta
$ solana config set --url devnet
$ solana config set --url localhost
$ solana config set --url testnet

Du kannst auch die folgenden Kurzoptionen verwenden:

Terminal

$ 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 die Standard-Solana-Wallet (keypair), die 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ötigst du eine Solana-Wallet mit SOL.

Um ein keypair am Standard-Keypair-Pfad zu generieren, führe den folgenden Befehl aus:

Terminal

$ solana-keygen new

Du solltest eine Ausgabe wie die folgende sehen:

Generating a new keypair

For added security, enter a BIP39 passphrase

NOTE! This passphrase improves security of the recovery seed phrase NOT the
keypair file itself, which is stored as insecure plain text

BIP39 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 du bereits eine Dateisystem-Wallet am Standardspeicherort gespeichert hast, überschreibt dieser Befehl sie nicht, es sei denn, du erzwingst das Überschreiben ausdrücklich mit dem Flag --force.

Um die Adresse deiner Wallet (öffentlicher Schlüssel) anzuzeigen, führe aus:

Terminal

$ solana address

Airdrop SOL

Fordere einen Airdrop von SOL an deine Wallet an, um Transaktionen und Programm- Deployments zu bezahlen.

Stelle deinen Cluster auf devnet ein:

Terminal

$ solana config set -ud

Dann fordere einen Airdrop von devnet SOL an:

Terminal

$ solana airdrop 2

Devnet-Airdrops beschränken Anfragen auf 5 SOL pro Anfrage. Wenn du auf Ratenlimits stößt oder Fehler auftreten, versuche stattdessen den Web Faucet zu verwenden.

Um den SOL-Kontostand deiner Wallet zu überprüfen, führe den folgenden Befehl aus:

Terminal

$ solana balance

Lokalen Validator ausführen

Die Solana CLI enthält einen integrierten Test-Validator für die lokale Entwicklung.

Führe in einem separaten Terminal den folgenden Befehl aus, um einen lokalen Validator zu starten:

Terminal

$ solana-test-validator

Denke daran, deine CLI auch auf localhost zu aktualisieren, bevor du Solana CLI- Befehle ausführst:

Terminal

$ solana config set -ul

Anchor CLI Grundlagen

Dieser Abschnitt führt durch einige gängige Anchor CLI-Befehle, um dir den Einstieg zu erleichtern. Für weitere Informationen zur Anchor CLI, siehe die Anchor-Dokumentation.

Projekt initialisieren

Um ein neues Anchor-Projekt zu erstellen, führen Sie den folgenden Befehl aus:

Terminal

$ anchor init <project-name>

Um beispielsweise ein Projekt namens my-project zu erstellen, führen Sie aus:

Terminal

$ anchor init my-project

Dieser Befehl erstellt ein neues Verzeichnis mit dem Projektnamen und initialisiert ein neues Anchor-Projekt mit einem grundlegenden Rust-Programm und einer TypeScript-Test-Vorlage.

Navigieren Sie zum Projektverzeichnis:

Terminal

$ cd <project-name>

Sehen Sie sich die Dateistruktur des Anchor-Projekts an.

Programm bauen

Um Ihr Projekt zu bauen, führen Sie den folgenden Befehl aus:

Terminal

$ anchor build

Sie finden das kompilierte Programm im Verzeichnis /target/deploy.

Programm bereitstellen

Um Ihr Projekt bereitzustellen, führen Sie den folgenden Befehl aus:

Terminal

$ anchor deploy

Dieser Befehl stellt Ihr Programm auf dem cluster bereit, der in der Anchor.toml Datei angegeben ist.

Programm testen

Um Ihr Projekt zu testen, führen Sie den folgenden Befehl aus:

Terminal

$ anchor test

Dieser Befehl baut, stellt bereit und führt die Tests für Ihr Projekt aus.

Bei Verwendung von localnet als cluster in Anchor.toml startet Anchor automatisch einen lokalen Validator, stellt Ihr Programm bereit, führt Tests aus und stoppt dann den Validator.

Windows Subsystem for Linux (WSL)

Linux

Erfolgsmeldung bei Rust-Installation

Node Installation

Yarn Installation

Fehler: kein Verzeichnis

Lock-Datei Version 4 erfordert `-Znext-lockfile-bump`

Inhaltsverzeichnis