의존성 설치하기
로컬 Solana 개발 환경 설정 가이드입니다. Windows(WSL), Linux 및 Mac에서 Rust, Solana CLI 및 Anchor 프레임워크를 설치하는 방법을 알아보세요. 각 의존성을 개별적으로 설치하려는 경우나 빠른 설치가 어떤 이유로든 실패한 경우 이 가이드를 사용하세요.
사전 요구사항
Rust 설치하기
개발자들은 Rust 프로그래밍 언어를 사용하여 Solana 프로그램을 구축합니다.
- 터미널에 다음 명령어를 입력하여 rustup을 사용해 Rust를 설치하세요:
Terminal
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
설치가 성공적으로 완료되면 다음과 같은 메시지가 표시됩니다:
- Cargo의 bin 디렉토리를 포함하도록 PATH 환경 변수를 다시 로드하세요:
Terminal
$. "$HOME/.cargo/env"
- 설치가 성공적으로 완료되었는지 확인하세요.
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.
- PATH 환경 변수 추가하기
Solana CLI를 처음 설치하면 PATH 환경 변수를 추가하라는 메시지가 표시될 수
있습니다. 이를 위해 터미널을 닫고 다시 열거나 쉘에서 다음 명령어를 실행하세요:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- PATH 환경 변수 업데이트하기
Linux 또는 WSL을 사용하는 경우, 터미널에서 명령어를 사용할 수 있도록 Solana CLI 바이너리를 PATH에 추가해야 합니다. 이를 위해 아래 단계를 따르세요:
a. 현재 사용 중인 쉘 확인하기:
Terminal
$echo $SHELL
- 출력에
/bash가 포함되어 있으면,.bashrc를 사용하세요. - 출력에
/zsh가 포함되어 있으면,.zshrc를 사용하세요.
b. 사용 중인 셸에 맞는 명령어를 실행하세요.
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)
Agave Github 저장소에서 사용 가능한 모든 버전을 확인할 수 있습니다. Agave는 이전에 Solana Labs validator 클라이언트로 알려졌던 Anza의 validator 클라이언트입니다.
- 필요에 따라 Solana CLI를 최신 버전으로 업데이트하세요 (선택 사항)
Terminal
$agave-install update
Anchor CLI 설치하기
Anchor는 Solana 프로그램을 개발하기 위한 프레임워크입니다. Anchor 프레임워크는 Rust 매크로를 활용하여 Solana 프로그램 작성 과정을 단순화합니다.
사전 요구사항
anchor init 명령으로 생성된 기본 Anchor 프로젝트 테스트
파일(TypeScript)은 Node.js와 Yarn이 필요합니다. (Rust 테스트 템플릿은
anchor init --test-template rust 를 사용하여 이용 가능합니다)
설치
Anchor CLI와 도구를 설치하는 두 가지 방법이 있습니다:
- Anchor 버전 관리자(AVM) — 권장 설치 방법
- AVM 없이 — GitHub에서 직접 설치
Anchor 버전 관리자(AVM)를 사용하면 시스템에 다양한 Anchor 버전을 설치하고 관리할 수 있으며, 향후 Anchor 버전을 쉽게 업데이트할 수 있습니다. AVM을 사용하여 Anchor를 설치하려면 아래 단계를 따르세요:
- 다음 명령어로 AVM을 설치하세요:
Terminal
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- AVM이 성공적으로 설치되었는지 확인하세요:
Terminal
$avm --version
- AVM을 사용하여 Anchor CLI를 설치하세요:
최신 버전을 설치하려면:
Terminal
$avm install latest$avm use latest
특정 버전을 설치하려면 버전 번호를 지정하세요:
Terminal
$avm install 0.30.1$avm use 0.30.1
Linux나 WSL에서 Anchor CLI를 설치할 때 다음과 같은 오류가 발생할 수 있습니다:
error: could not exec the linker cc = note: Permission denied (os error 13)
이 오류 메시지가 표시되면 다음 단계를 따르세요:
- 이 페이지 상단의 Linux 섹션에 나열된 종속성을 설치하세요.
- Anchor CLI 설치를 다시 시도하세요.
- 다음과 같이 Anchor CLI 버전을 확인하여 설치가 성공했는지 확인하세요:
Terminal
$anchor --version
다음과 같은 출력이 표시됩니다:
anchor-cli 0.31.1
시스템에서 실행할 Anchor CLI 버전을 선언하기 위해 avm use 명령어를
실행하는 것을 잊지 마세요.
latest버전을 설치했다면, *shellavm use latest*를 실행하세요.0.30.1버전을 설치했다면, *shellavm use 0.30.1*를 실행하세요.
Solana 개발을 위한 AI 도구 설정하기
이 섹션에서는 Solana 개발을 가속화하는 데 사용할 수 있는 선택적 AI 도구 설정에 대해 설명합니다.
| 도구 | 설명 | 링크 |
|---|---|---|
| MCP | Solana AI 지원 개발을 향상시키기 위해 커서로 연결할 수 있는 MCP 서버입니다. | https://mcp.solana.com/ |
| LLMs.txt | Solana 문서에서 LLM을 훈련시키는 데 사용할 수 있는 LLM에 최적화된 문서입니다. | https://solana.com/llms.txt |
Is this page helpful?