Руководство по настройке локального окружения для разработки на Solana. Узнайте, как установить Rust, Solana CLI и Anchor Framework на Windows (WSL), Linux и Mac. Используйте это руководство, если вы предпочитаете устанавливать каждую зависимость отдельно или если быстрая установка не сработала по какой-либо причине.
Предварительные требования
Установка Rust
Разработчики создают программы для Solana с помощью языка программирования Rust.
- Установите Rust с помощью rustup, введя следующую команду в терминале:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
После успешной установки вы увидите следующее сообщение:
- Перезагрузите переменную окружения PATH, чтобы добавить директорию bin из Cargo:
$. "$HOME/.cargo/env"
- Проверьте, что установка прошла успешно.
$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.
- Добавьте переменную окружения PATH
При первой установке Solana CLI вам может быть предложено добавить переменную
окружения PATH. Для этого закройте и откройте терминал заново или выполните
следующую команду в вашей оболочке:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Обновите переменную окружения PATH
Если вы используете Linux или WSL, необходимо добавить бинарный файл Solana CLI в PATH, чтобы команда была доступна в терминале. Для этого выполните следующие шаги:
a. Проверьте, какую оболочку вы используете:
$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 по умолчанию (TypeScript), созданный с помощью
команды anchor init, требует наличия Node.js и Yarn. (Шаблон теста на
Rust доступен с помощью anchor init --test-template rust)
Установка
Вы можете установить Anchor CLI и инструменты двумя способами:
- Anchor Version Manager (AVM) — рекомендуемый способ установки
- Без AVM — установка напрямую из GitHub
Anchor Version Manager (AVM) позволяет устанавливать и управлять разными версиями Anchor на вашей системе, а также легко обновлять версии Anchor в будущем. Чтобы установить Anchor с помощью AVM, выполните следующие шаги:
- Установите AVM с помощью следующей команды:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Убедитесь, что AVM установлен успешно:
$avm --version
- Установите Anchor CLI с помощью AVM:
Чтобы установить последнюю версию:
$avm install latest$avm use latest
Чтобы установить определённую версию, укажите номер версии:
$avm install 0.30.1$avm use 0.30.1
При установке Anchor CLI на Linux или WSL вы можете столкнуться с такой ошибкой:
error: could not exec the linker cc = note: Permission denied (os error 13)
Если вы видите это сообщение об ошибке, выполните следующие действия:
- Установите зависимости, перечисленные в разделе Linux в начале этой страницы.
- Повторите попытку установки Anchor CLI.
- Убедитесь, что установка прошла успешно, проверив версию Anchor CLI:
$anchor --version
Вы увидите вывод, похожий на следующий:
anchor-cli 0.31.1
Не забудьте выполнить команду avm use, чтобы указать версию Anchor CLI,
которая будет использоваться в вашей системе.
- Если вы установили версию
latest, выполнитеavm use latest. - Если вы установили версию
0.30.1, выполнитеavm use 0.30.1.
Установите Surfpool CLI
Surfpool — это инструмент для локальной разработки и
улучшенная замена solana-test-validator. Подробнее о возможностях Surfpool
читайте в документации Surfpool.
- Установите Surfpool с помощью следующей команды:
$curl -sL https://run.surfpool.run/ | bash
- Убедитесь, что установка прошла успешно, проверив версию Surfpool CLI:
$surfpool --version
Вы увидите вывод, похожий на следующий:
surfpool 0.12.0
Настройте AI-инструменты для разработки на Solana
В этом разделе описана необязательная настройка AI-инструментов, которые помогут ускорить разработку на Solana.
| Инструмент | Описание | Ссылка |
|---|---|---|
| MCP | MCP-сервер, к которому можно подключиться через cursor для улучшения AI-разработки Solana. | https://mcp.solana.com/ |
| LLMs.txt | Оптимизированная для LLM документация, которую можно использовать для обучения LLM на Solana docs. | https://solana.com/llms.txt |
Is this page helpful?