Установка
В этом разделе описаны шаги по настройке локальной среды для разработки на Solana.
Быстрая установка
На Mac и Linux выполните эту единственную команду для установки всех зависимостей.
$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.1Node.js: v23.11.0Yarn: 1.22.1
Если команда быстрой установки не работает, обратитесь к разделу Установка зависимостей ниже для получения инструкций по установке каждой зависимости по отдельности.
Если команда быстрой установки выполняется успешно, перейдите к разделам Основы Solana CLI и Основы Anchor CLI ниже.
Установка зависимостей
Инструкции ниже проведут вас через процесс установки каждой зависимости по отдельности.
- Пользователи Windows должны сначала установить WSL (подсистему Windows для Linux), а затем установить зависимости, указанные в разделе Linux ниже.
- Пользователи Linux должны сначала установить зависимости, указанные в разделе Linux ниже.
- Пользователи Mac должны начать с инструкций по установке Rust ниже.
Установка Rust
Разработчики создают программы Solana, используя язык программирования Rust.
Установите Rust с помощью rustup.
Выполните следующую команду для установки Rust:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
После завершения установки вы должны увидеть следующее сообщение:
Выполните следующую команду, чтобы перезагрузить переменную среды PATH, включив в нее каталог bin Cargo:
$. "$HOME/.cargo/env"
Чтобы проверить успешность установки, проверьте версию Rust:
$rustc --version
Вы должны увидеть вывод, подобный следующему:
rustc 1.86.0 (05f9846f8 2025-03-31)
Установка Solana CLI
Solana CLI предоставляет все инструменты, необходимые для создания и развертывания программ Solana.
Установите набор инструментов Solana CLI, используя официальную команду установки:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Вы можете заменить stable
на тег релиза, соответствующий версии программного
обеспечения желаемого выпуска (например, v2.0.3
), или использовать одно из
трех символических имен каналов: stable
, beta
или edge
.
При первой установке Solana CLI вы можете увидеть следующее сообщение,
предлагающее добавить переменную окружения PATH
:
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"
Если вы используете Linux или WSL, вам необходимо добавить бинарный файл
Solana CLI в ваш PATH
, чтобы команда была доступна в вашем терминале.
Сначала выполните следующую команду, чтобы проверить, какую оболочку вы используете:
$echo $SHELL
- Если вывод содержит
/bash
, используйте.bashrc
. - Если вывод содержит
/zsh
, используйте.zshrc
.
В зависимости от вашей оболочки выполните соответствующую команду.
Для Bash (bashrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Для Zsh (zshrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
Затем выполните следующую команду, чтобы обновить сессию терминала или перезапустите терминал.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Чтобы проверить успешность установки, проверьте версию Solana CLI:
$solana --version
Вы должны увидеть вывод, подобный следующему:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Вы можете просмотреть все доступные версии в репозитории Agave на Github.
Agave — это клиент validator от Anza, ранее известный как клиент validator от Solana Labs.
Чтобы позже обновить Solana CLI до последней версии, вы можете использовать следующую команду:
$agave-install update
Установка Anchor CLI
Anchor — это фреймворк для разработки программ Solana. Фреймворк Anchor использует макросы Rust для упрощения процесса написания программ Solana.
Вы можете установить Anchor CLI и инструменты двумя способами:
- Anchor Version Manager (AVM) - Рекомендуемый метод установки
- Без AVM - Установка напрямую из GitHub
Менеджер версий Anchor (AVM) позволяет устанавливать и управлять различными версиями Anchor в вашей системе и легко обновлять версии Anchor в будущем.
Установите AVM с помощью следующей команды:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
Подтвердите, что AVM установлен успешно:
$avm --version
Установите последнюю версию Anchor CLI с помощью AVM:
$avm install latest$avm use latest
Вы можете установить определенную версию Anchor CLI, указав номер версии:
$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:
$anchor --version
Вы должны увидеть вывод, подобный следующему:
anchor-cli 0.31.1
При установке Anchor CLI на Linux или WSL вы можете столкнуться с этой ошибкой:
error: could not exec the linker cc = note: Permission denied (os error 13)
Если вы видите это сообщение об ошибке:
- Установите зависимости, перечисленные в разделе Linux в начале этой страницы.
- Повторите попытку установки Anchor CLI.
Node.js и Yarn
Файл тестирования проекта Anchor по умолчанию (TypeScript), созданный с помощью
команды anchor init
, требует Node.js и Yarn. (Шаблон теста на Rust
доступен с помощью anchor init --test-template rust
)
При запуске anchor build
, если вы столкнетесь со следующими ошибками:
После применения вышеуказанного решения попробуйте снова запустить
anchor build
.
При запуске anchor test
после создания нового проекта Anchor на Linux
или WSL, вы можете столкнуться со следующими ошибками, если у вас не установлены
Node.js или Yarn:
Permission denied (os error 13)
No such file or directory (os error 2)
Настройка инструментов ИИ для разработки на Solana
В этом разделе описана настройка дополнительных инструментов ИИ, которые вы можете использовать для ускорения разработки на Solana.
Инструмент | Описание | Ссылка |
---|---|---|
MCP | Сервер MCP, к которому вы можете подключиться с помощью курсора для улучшения разработки с поддержкой ИИ на Solana. | https://mcp.solana.com/ |
LLMs.txt | Оптимизированная документация для LLM, которую вы можете использовать для обучения LLM на документации Solana. | https://solana.com/llms.txt |
Основы работы с Solana CLI
В этом разделе рассматриваются некоторые основные команды Solana CLI, чтобы помочь вам начать работу.
Конфигурация Solana
Чтобы увидеть текущую конфигурацию:
$solana config get
Вы должны увидеть вывод, подобный следующему:
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
RPC URL и Websocket URL указывают кластер Solana, к которому CLI отправляет запросы.
Вы можете обновить кластер Solana CLI с помощью следующих команд:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
Вы также можете использовать следующие короткие опции:
$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, выполните следующую команду:
$solana-keygen new
Вы должны увидеть вывод, подобный следующему:
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===========================================================================
Если у вас уже есть кошелёк файловой системы, сохранённый в стандартном
расположении, эта команда не перезапишет его, если вы явно не укажете
принудительное перезаписывание с помощью флага --force
.
Чтобы просмотреть адрес вашего кошелька (публичный ключ), выполните команду:
$solana address
Airdrop SOL
Запросите airdrop SOL на ваш кошелёк, чтобы оплачивать транзакции и развертывание программ.
Установите ваш кластер на devnet:
$solana config set -ud
Затем запросите airdrop devnet SOL:
$solana airdrop 2
Airdrop в devnet ограничивает запросы до 5 SOL за один запрос. Если вы достигли лимита запросов или столкнулись с ошибками, попробуйте использовать Web Faucet.
Чтобы проверить баланс SOL вашего кошелька, выполните следующую команду:
$solana balance
Запуск локального валидатора
Solana CLI включает встроенный тестовый валидатор для локальной разработки.
В отдельном терминале выполните следующую команду, чтобы запустить локальный валидатор:
$solana-test-validator
Не забудьте также обновить ваш CLI для использования localhost перед выполнением команд Solana CLI:
$solana config set -ul
Основы Anchor CLI
В этом разделе рассматриваются некоторые распространённые команды Anchor CLI, чтобы помочь вам начать работу. Для получения дополнительной информации о Anchor CLI см. документацию Anchor.
Инициализация проекта
Чтобы создать новый проект Anchor, выполните следующую команду:
$anchor init <project-name>
Например, чтобы создать проект с именем my-project
, выполните:
$anchor init my-project
Эта команда создаёт новую директорию с именем проекта и инициализирует новый проект Anchor с базовой программой на Rust и шаблоном теста на TypeScript.
Перейдите в директорию проекта:
$cd <project-name>
См. структуру файлов проекта проекта Anchor.
Сборка программы
Чтобы собрать ваш проект, выполните следующую команду:
$anchor build
Собранная программа будет находиться в директории /target/deploy
.
Развёртывание программы
Чтобы развернуть ваш проект, выполните следующую команду:
$anchor deploy
Эта команда развёртывает вашу программу в cluster
, указанном в файле
Anchor.toml
.
Тестирование программы
Чтобы протестировать ваш проект, выполните следующую команду:
$anchor test
Эта команда собирает, развёртывает и запускает тесты для вашего проекта.
При использовании localnet
в качестве cluster
в Anchor.toml
Anchor
автоматически запускает локальный валидатор, развёртывает вашу программу,
выполняет тесты, а затем останавливает валидатор.
Is this page helpful?