Solana-DokumentationErste Schritte

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.

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:

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:

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ü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)

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:

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

  1. Anchor Version Manager (AVM) - Empfohlene Installationsmethode
  2. 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:

  1. Installiere die Abhängigkeiten, die im Abschnitt Linux am Anfang dieser Seite aufgeführt sind.
  2. 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.

ToolBeschreibungLink
MCPMCP-Server, mit dem Sie sich über Cursor verbinden können, um die KI-unterstützte Solana-Entwicklung zu verbessern.https://mcp.solana.com/
LLMs.txtLLM-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:

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

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

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 Solana-Wallet mit SOL.

Um ein Keypair am Standard-Keypair-Pfad zu generieren, führen Sie den 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 --force Flag.

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 für Ihr Wallet an, um Transaktionen und Programm- Deployments zu bezahlen.

Stellen Sie Ihren Cluster auf devnet ein:

Terminal
$
solana config set -ud

Dann fordern Sie einen Airdrop von Devnet-SOL an:

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

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

Terminal
$
solana-test-validator

Denken Sie daran, Ihre CLI auch auf localhost zu aktualisieren, bevor Sie Solana CLI-Befehle ausführen:

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

Terminal
$
anchor init <project-name>

Um beispielsweise ein Projekt mit dem Namen 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 einer grundlegenden Rust-Programm- und TypeScript-Test-Vorlage.

Navigieren Sie zum Projektverzeichnis:

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

Terminal
$
anchor build

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

Programm bereitstellen

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

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

Terminal
$
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?