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, überspringe die Abschnitte 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üfe die Rust-Version:

Terminal

$ rustc --version

Du solltest eine Ausgabe wie die folgende sehen:

rustc 1.86.0 (05f9846f8 2025-03-31)

Installiere die Solana CLI

Die Solana CLI stellt alle erforderlichen Tools zum Erstellen und Bereitstellen von Solana-Programmen zur Verfügung.

Installiere die Solana CLI-Tool-Suite mit dem offiziellen Installationsbefehl:

Terminal

$ sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Du kannst stable durch das Release-Tag ersetzen, das der Softwareversion deiner gewünschten Version entspricht (z.B. v2.0.3), oder einen der drei symbolischen Kanalnamen verwenden: stable, beta oder edge.

Bei einer Erstinstallation der Solana CLI wird möglicherweise die folgende Meldung angezeigt, die dich 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 du Linux oder WSL verwendest, musst du die Solana CLI-Binärdatei zu deinem PATH hinzufügen, damit der Befehl in deinem Terminal verfügbar ist.

Führe zunächst den folgenden Befehl aus, um zu überprüfen, welche Shell du verwendest:

Terminal

$ echo $SHELL

Wenn die Ausgabe /bash enthält, verwende .bashrc.
Wenn die Ausgabe /zsh enthält, verwende .zshrc.

Führe je nach deiner 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ühre dann den folgenden Befehl aus, um die Terminal-Sitzung zu aktualisieren oder starte dein Terminal neu.

Terminal

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

Terminal

$ solana --version

Sie sollten eine Ausgabe wie die folgende sehen:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

Sie können 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, können Sie 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.

Sie können 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 Ihnen, verschiedene Anchor-Versionen auf Ihrem System zu installieren und zu verwalten sowie Anchor-Versionen in Zukunft einfach zu aktualisieren.

Installieren Sie AVM mit dem folgenden Befehl:

Terminal

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

Bestätigen Sie, dass AVM erfolgreich installiert wurde:

Terminal

$ avm --version

Installieren Sie die neueste Version der Anchor CLI mit AVM:

Terminal

$ avm install latest
$ avm use latest

Sie können eine bestimmte Version der Anchor CLI installieren, indem Sie die Versionsnummer angeben:

Terminal

$ avm install 0.30.1
$ avm use 0.30.1

Vergessen Sie nicht, den Befehl avm use auszuführen, um die zu verwendende Anchor CLI-Version auf Ihrem System festzulegen.

Wenn Sie die Version latest installiert haben, führen Sie avm use latest aus.
Wenn Sie die Version 0.30.1 installiert haben, führen Sie avm use 0.30.1 aus.

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

Terminal

$ anchor --version

Sie sollten eine Ausgabe wie die folgende sehen:

anchor-cli 0.31.1

Bei der Installation der Anchor CLI unter Linux oder WSL könnte dieser Fehler auftreten:

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

Wenn Sie diese Fehlermeldung sehen:

Installieren Sie die Abhängigkeiten, die im Abschnitt Linux am Anfang dieser Seite aufgeführt sind.
Versuchen Sie 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 Sie beim Ausführen von anchor build auf folgende Fehler stoßen:

Nachdem Sie die vorherige Lösung angewendet haben, versuchen Sie erneut, anchor build 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)

Solana CLI Grundlagen

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

Solana-Konfiguration

Um Ihre aktuelle Konfiguration anzuzeigen:

Terminal

$ solana config get

Sie sollten 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 spezifizieren den Solana-Cluster, an den die CLI Anfragen sendet.

Sie können den Solana CLI-Cluster mit 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

Sie können 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 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 mit SOL finanziertes Solana-Wallet.

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

Terminal

$ solana-keygen new

Sie sollten 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 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 Flag --force.

Um die Adresse (öffentlichen Schlüssel) Ihres Wallets anzuzeigen, führen Sie aus:

Terminal

$ solana address

SOL per Airdrop erhalten

Fordern Sie einen Airdrop von SOL an Ihr Wallet an, um für Transaktionen und Deployments zu bezahlen.

Stelle deinen Cluster auf devnet ein:

Terminal

$ solana config set -ud

Fordere dann ein Airdrop von devnet SOL an:

Terminal

$ solana airdrop 2

Devnet-Airdrops beschränken Anfragen auf 5 SOL pro Anfrage. Wenn du auf Ratenbegrenzungen 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ühre den folgenden Befehl aus:

Terminal

$ anchor init <project-name>

Um beispielsweise ein Projekt mit dem Namen my-project zu erstellen, führe folgenden Befehl 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-Testvorlage.

Wechsle in das Projektverzeichnis:

Terminal

$ cd <project-name>

Sieh dir die Dateistruktur des Anchor-Projekts an.

Programm bauen

Um dein Projekt zu bauen, führe folgenden Befehl aus:

Terminal

$ anchor build

Du findest das kompilierte Programm im Verzeichnis /target/deploy.

Programm bereitstellen

Um dein Projekt bereitzustellen, führe folgenden Befehl aus:

Terminal

$ anchor deploy

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

Programm testen

Um dein Projekt zu testen, führe folgenden Befehl aus:

Terminal

$ anchor test

Dieser Befehl baut, stellt 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.

Windows Subsystem for Linux (WSL)

Linux

Erfolgsmeldung bei Rust-Installation

Node Installation

Yarn Installation

error: not a directory

lock file version 4 requires `-Znext-lockfile-bump

Inhaltsverzeichnis