Τεκμηρίωση SolanaΞεκινώντας

Εγκατάσταση

Αυτή η ενότητα καλύπτει τα βήματα για τη ρύθμιση του τοπικού σας περιβάλλοντος για ανάπτυξη στο Solana.

Γρήγορη εγκατάσταση

Σε Mac και Linux, εκτελέστε αυτή τη μοναδική εντολή για να εγκαταστήσετε όλες τις εξαρτήσεις.

Terminal
$
curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

Χρήστες Windows: πρέπει πρώτα να εγκαταστήσετε το WSL (δείτε Εγκατάσταση εξαρτήσεων). Στη συνέχεια εκτελέστε την προηγούμενη εντολή στο τερματικό Ubuntu (Linux).

Μετά την εγκατάσταση, θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

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

Αν η εντολή γρήγορης εγκατάστασης δεν λειτουργεί, παρακαλώ ανατρέξτε στην ενότητα Εγκατάσταση εξαρτήσεων παρακάτω για οδηγίες εγκατάστασης κάθε εξάρτησης ξεχωριστά.

Αν η εντολή γρήγορης εγκατάστασης εκτελεστεί με επιτυχία, προχωρήστε στις ενότητες Βασικά του Solana CLI και Βασικά του Anchor CLI παρακάτω.

Εγκατάσταση εξαρτήσεων

Οι παρακάτω οδηγίες σας καθοδηγούν στην εγκατάσταση κάθε εξάρτησης ξεχωριστά.

  • Οι χρήστες Windows πρέπει πρώτα να εγκαταστήσουν το WSL (Windows subsystem for Linux) και στη συνέχεια να εγκαταστήσουν τις εξαρτήσεις που καθορίζονται στην ενότητα Linux παρακάτω.
  • Οι χρήστες Linux θα πρέπει πρώτα να εγκαταστήσουν τις εξαρτήσεις που καθορίζονται στην ενότητα Linux παρακάτω.
  • Οι χρήστες Mac θα πρέπει να ξεκινήσουν με τις οδηγίες εγκατάστασης της Rust παρακάτω.

Εγκατάσταση Rust

Οι προγραμματιστές δημιουργούν προγράμματα Solana χρησιμοποιώντας τη γλώσσα προγραμματισμού Rust.

Εγκαταστήστε τη Rust με το rustup.

Εκτελέστε την ακόλουθη εντολή για να εγκαταστήσετε τη Rust:

Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Θα πρέπει να δείτε το ακόλουθο μήνυμα μετά την ολοκλήρωση της εγκατάστασης:

Εκτελέστε την ακόλουθη εντολή για να επαναφορτώσετε τη μεταβλητή περιβάλλοντος PATH ώστε να συμπεριλάβει τον κατάλογο bin του Cargo:

Terminal
$
. "$HOME/.cargo/env"

Για να επαληθεύσετε ότι η εγκατάσταση ολοκληρώθηκε με επιτυχία, ελέγξτε την έκδοση της Rust:

Terminal
$
rustc --version

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

rustc 1.86.0 (05f9846f8 2025-03-31)

Εγκατάσταση του Solana CLI

Το Solana CLI παρέχει όλα τα εργαλεία που απαιτούνται για την ανάπτυξη και την ανάπτυξη προγραμμάτων Solana.

Εγκαταστήστε τη σουίτα εργαλείων Solana CLI χρησιμοποιώντας την επίσημη εντολή εγκατάστασης:

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

Μπορείτε να αντικαταστήσετε το stable με την ετικέτα έκδοσης που αντιστοιχεί στην έκδοση λογισμικού που επιθυμείτε (π.χ. v2.0.3), ή να χρησιμοποιήσετε ένα από τα τρία συμβολικά ονόματα καναλιών: stable, beta, ή edge.

Για μια πρώτη εγκατάσταση του Solana CLI, μπορεί να δείτε το ακόλουθο μήνυμα που σας προτρέπει να προσθέσετε μια μεταβλητή περιβάλλοντος PATH:

Κλείστε και ανοίξτε ξανά το τερματικό σας για να εφαρμοστούν οι αλλαγές στο PATH ή εκτελέστε τα παρακάτω στο υπάρχον κέλυφος:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"

Εάν χρησιμοποιείτε Linux ή WSL, πρέπει να προσθέσετε το εκτελέσιμο αρχείο του Solana CLI στο PATH ώστε η εντολή να είναι διαθέσιμη στο τερματικό σας.

Πρώτα, εκτελέστε την ακόλουθη εντολή για να ελέγξετε ποιο κέλυφος χρησιμοποιείτε:

Terminal
$
echo $SHELL
  • Εάν η έξοδος περιέχει /bash, χρησιμοποιήστε .bashrc.
  • Εάν η έξοδος περιέχει /zsh, χρησιμοποιήστε .zshrc.

Ανάλογα με το κέλυφός σας, εκτελέστε την κατάλληλη εντολή.

Για Bash (bashrc):

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

Για Zsh (zshrc):

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

Στη συνέχεια, εκτελέστε την ακόλουθη εντολή για να ανανεώσετε τη συνεδρία του τερματικού ή επανεκκινήστε το τερματικό σας.

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

Για να επαληθεύσετε ότι η εγκατάσταση ήταν επιτυχής, ελέγξτε την έκδοση του Solana CLI:

Terminal
$
solana --version

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

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

Μπορείτε να δείτε όλες τις διαθέσιμες εκδόσεις στο αποθετήριο Github του Agave.

Το Agave είναι ο validator client από την Anza, παλαιότερα γνωστός ως validator client της Solana Labs.

Για να ενημερώσετε αργότερα το Solana CLI στην τελευταία έκδοση, μπορείτε να χρησιμοποιήσετε την ακόλουθη εντολή:

Terminal
$
agave-install update

Εγκατάσταση του Anchor CLI

Το Anchor είναι ένα πλαίσιο για την ανάπτυξη προγραμμάτων στο Solana. Το πλαίσιο Anchor χρησιμοποιεί μακροεντολές Rust για να απλοποιήσει τη διαδικασία συγγραφής προγραμμάτων Solana.

Μπορείτε να εγκαταστήσετε το Anchor CLI και τα εργαλεία του με δύο τρόπους:

  1. Anchor Version Manager (AVM) - Προτεινόμενη μέθοδος εγκατάστασης
  2. Χωρίς AVM - Εγκατάσταση απευθείας από το GitHub

Ο διαχειριστής εκδόσεων Anchor (AVM) σας επιτρέπει να εγκαθιστάτε και να διαχειρίζεστε διαφορετικές εκδόσεις του Anchor στο σύστημά σας και να ενημερώνετε εύκολα τις εκδόσεις του Anchor στο μέλλον.

Εγκαταστήστε το AVM με την ακόλουθη εντολή:

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

Επιβεβαιώστε ότι το AVM εγκαταστάθηκε με επιτυχία:

Terminal
$
avm --version

Εγκαταστήστε την τελευταία έκδοση του Anchor CLI χρησιμοποιώντας το AVM:

Terminal
$
avm install latest
$
avm use latest

Μπορείτε να εγκαταστήσετε μια συγκεκριμένη έκδοση του Anchor CLI καθορίζοντας τον αριθμό έκδοσης:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

Μην ξεχάσετε να εκτελέσετε την εντολή avm use για να δηλώσετε την έκδοση του Anchor CLI που θα εκτελείται στο σύστημά σας.

  • Αν εγκαταστήσατε την έκδοση latest, εκτελέστε avm use latest.
  • Αν εγκαταστήσατε την έκδοση 0.30.1, εκτελέστε avm use 0.30.1.

Για να επαληθεύσετε ότι η εγκατάσταση ήταν επιτυχής, ελέγξτε την έκδοση του Anchor CLI:

Terminal
$
anchor --version

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

anchor-cli 0.31.1

Κατά την εγκατάσταση του Anchor CLI σε Linux ή WSL, ενδέχεται να αντιμετωπίσετε αυτό το σφάλμα:

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

Αν δείτε αυτό το μήνυμα σφάλματος:

  1. Εγκαταστήστε τις εξαρτήσεις που αναφέρονται στην ενότητα Linux στην αρχή αυτής της σελίδας.
  2. Δοκιμάστε ξανά την εγκατάσταση του Anchor CLI.

Node.js και Yarn

Το προεπιλεγμένο αρχείο δοκιμών του Anchor project (TypeScript) που δημιουργείται με την εντολή anchor init απαιτεί Node.js και Yarn. (Το πρότυπο δοκιμών Rust είναι διαθέσιμο χρησιμοποιώντας anchor init --test-template rust)

Κατά την εκτέλεση του anchor build, αν αντιμετωπίσετε τα ακόλουθα σφάλματα:

Αφού εφαρμόσετε την προηγούμενη λύση, προσπαθήστε να εκτελέσετε ξανά την εντολή anchor build.

Όταν εκτελείτε την εντολή anchor test μετά τη δημιουργία ενός νέου project Anchor σε Linux ή WSL, ενδέχεται να αντιμετωπίσετε τα παρακάτω σφάλματα αν δεν έχετε εγκατεστημένο το Node.js ή το Yarn:

Permission denied (os error 13)
No such file or directory (os error 2)

Ρύθμιση εργαλείων τεχνητής νοημοσύνης για ανάπτυξη στο Solana

Αυτή η ενότητα περιγράφει την προαιρετική ρύθμιση εργαλείων τεχνητής νοημοσύνης που μπορείτε να χρησιμοποιήσετε για να επιταχύνετε την ανάπτυξή σας στο Solana.

ΕργαλείοΠεριγραφήΣύνδεσμος
MCPΔιακομιστής MCP στον οποίο μπορείτε να συνδεθείτε με cursor για βελτιωμένη ανάπτυξη με τη βοήθεια AI στο Solana.https://mcp.solana.com/
LLMs.txtΒελτιστοποιημένη τεκμηρίωση για LLM που μπορείτε να χρησιμοποιήσετε για την εκπαίδευση LLMs στα έγγραφα του Solana.https://solana.com/llms.txt

Βασικές λειτουργίες του Solana CLI

Αυτή η ενότητα παρουσιάζει μερικές συνηθισμένες εντολές του Solana CLI για να ξεκινήσετε.

Ρύθμιση παραμέτρων Solana

Για να δείτε τις τρέχουσες ρυθμίσεις σας:

Terminal
$
solana config get

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

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

Το RPC URL και το Websocket URL καθορίζουν το cluster του Solana στο οποίο το CLI στέλνει αιτήματα.

Μπορείτε να ενημερώσετε το cluster του Solana CLI χρησιμοποιώντας τις παρακάτω εντολές:

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

Μπορείτε επίσης να χρησιμοποιήσετε τις παρακάτω συντομεύσεις:

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

Η διαδρομή του keypair δείχνει στο προεπιλεγμένο πορτοφόλι Solana (keypair) που χρησιμοποιείται από το Solana CLI για την πληρωμή χρεώσεων συναλλαγών και την ανάπτυξη προγραμμάτων. Από προεπιλογή, αυτό το αρχείο αποθηκεύεται στο ~/.config/solana/id.json.

Δημιουργία πορτοφολιού

Για να στείλετε συναλλαγές χρησιμοποιώντας το Solana CLI, χρειάζεστε ένα πορτοφόλι Solana με SOL.

Για να δημιουργήσετε ένα keypair στην προεπιλεγμένη διαδρομή keypair, εκτελέστε την ακόλουθη εντολή:

Terminal
$
solana-keygen new

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

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
===========================================================================

Αν έχετε ήδη ένα πορτοφόλι αποθηκευμένο στο σύστημα αρχείων στην προεπιλεγμένη τοποθεσία, αυτή η εντολή δεν το αντικαθιστά εκτός αν επιβάλετε ρητά την αντικατάσταση χρησιμοποιώντας τη σημαία --force.

Για να δείτε τη διεύθυνση του πορτοφολιού σας (δημόσιο κλειδί), εκτελέστε:

Terminal
$
solana address

Airdrop SOL

Ζητήστε ένα airdrop SOL στο πορτοφόλι σας για να πληρώσετε για συναλλαγές και αναπτύξεις προγραμμάτων.

Ορίστε το cluster σας στο devnet:

Terminal
$
solana config set -ud

Στη συνέχεια ζητήστε ένα airdrop devnet SOL:

Terminal
$
solana airdrop 2

Τα airdrops στο devnet περιορίζουν τα αιτήματα σε 5 SOL ανά αίτημα. Αν συναντήσετε περιορισμούς ρυθμού ή σφάλματα, δοκιμάστε να χρησιμοποιήσετε το Web Faucet αντί αυτού.

Για να ελέγξετε το υπόλοιπο SOL του πορτοφολιού σας, εκτελέστε την ακόλουθη εντολή:

Terminal
$
solana balance

Εκτέλεση τοπικού validator

Το Solana CLI περιλαμβάνει έναν ενσωματωμένο test validator για τοπική ανάπτυξη.

Σε ξεχωριστό τερματικό, εκτελέστε την ακόλουθη εντολή για να ξεκινήσετε έναν τοπικό validator:

Terminal
$
solana-test-validator

Θυμηθείτε να ενημερώσετε το CLI σας ώστε να χρησιμοποιεί το localhost πριν εκτελέσετε εντολές Solana CLI:

Terminal
$
solana config set -ul

Βασικά στοιχεία του Anchor CLI

Αυτή η ενότητα παρουσιάζει μερικές συνηθισμένες εντολές του Anchor CLI για να ξεκινήσετε. Για περισσότερες πληροφορίες σχετικά με το Anchor CLI, δείτε την τεκμηρίωση του Anchor.

Αρχικοποίηση έργου

Για να δημιουργήσετε ένα νέο έργο Anchor, εκτελέστε την ακόλουθη εντολή:

Terminal
$
anchor init <project-name>

Για παράδειγμα, για να δημιουργήσετε ένα έργο με όνομα my-project, εκτελέστε:

Terminal
$
anchor init my-project

Αυτή η εντολή δημιουργεί έναν νέο κατάλογο με το όνομα του έργου και αρχικοποιεί ένα νέο έργο Anchor με ένα βασικό πρόγραμμα Rust και ένα πρότυπο δοκιμών TypeScript.

Μεταβείτε στον κατάλογο του έργου:

Terminal
$
cd <project-name>

Δείτε τη δομή αρχείων του έργου Anchor.

Δημιουργία προγράμματος

Για να δημιουργήσετε το έργο σας, εκτελέστε την ακόλουθη εντολή:

Terminal
$
anchor build

Μπορείτε να βρείτε το μεταγλωττισμένο πρόγραμμα στον κατάλογο /target/deploy.

Ανάπτυξη προγράμματος

Για να αναπτύξετε το έργο σας, εκτελέστε την ακόλουθη εντολή:

Terminal
$
anchor deploy

Αυτή η εντολή αναπτύσσει το πρόγραμμά σας στο cluster που καθορίζεται στο αρχείο Anchor.toml.

Δοκιμή προγράμματος

Για να δοκιμάσετε το έργο σας, εκτελέστε την ακόλουθη εντολή:

Terminal
$
anchor test

Αυτή η εντολή δημιουργεί, αναπτύσσει και εκτελεί τις δοκιμές για το έργο σας.

Όταν χρησιμοποιείτε το localnet ως cluster στο Anchor.toml, το Anchor ξεκινά αυτόματα έναν τοπικό validator, αναπτύσσει το πρόγραμμά σας, εκτελεί δοκιμές και στη συνέχεια σταματά τον validator.

Is this page helpful?