Tài liệu SolanaBắt đầu

Cài đặt

Phần này hướng dẫn các bước thiết lập môi trường cục bộ để phát triển trên Solana.

Cài đặt nhanh

Trên Mac và Linux, chạy lệnh sau để cài đặt tất cả các phụ thuộc.

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

Người dùng Windows: bạn phải cài đặt WSL trước (xem Cài đặt các phụ thuộc). Sau đó chạy lệnh trên trong terminal Ubuntu (Linux).

Sau khi cài đặt, bạn sẽ thấy kết quả như sau:

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

Nếu lệnh cài đặt nhanh không hoạt động, vui lòng tham khảo phần Cài đặt các phụ thuộc bên dưới để được hướng dẫn cài đặt từng phụ thuộc riêng lẻ.

Nếu lệnh cài đặt nhanh chạy thành công, hãy chuyển đến phần Cơ bản về Solana CLICơ bản về Anchor CLI bên dưới.

Cài đặt các phụ thuộc

Hướng dẫn dưới đây sẽ giúp bạn cài đặt từng phụ thuộc riêng lẻ.

  • Người dùng Windows phải cài đặt WSL (Windows subsystem for Linux) trước, sau đó cài đặt các phụ thuộc được chỉ định trong phần Linux bên dưới.
  • Người dùng Linux nên bắt đầu với việc cài đặt các phụ thuộc được chỉ định trong phần Linux bên dưới.
  • Người dùng Mac nên bắt đầu với hướng dẫn cài đặt Rust bên dưới.

Cài đặt Rust

Các nhà phát triển xây dựng chương trình Solana bằng ngôn ngữ lập trình Rust.

Cài đặt Rust với rustup.

Chạy lệnh sau để cài đặt Rust:

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

Bạn sẽ thấy thông báo sau khi hoàn tất cài đặt:

Chạy lệnh sau để tải lại biến môi trường PATH của bạn để bao gồm thư mục bin của Cargo:

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

Để xác minh việc cài đặt đã thành công, hãy kiểm tra phiên bản Rust:

Terminal
$
rustc --version

Bạn sẽ thấy kết quả như sau:

rustc 1.86.0 (05f9846f8 2025-03-31)

Cài đặt Solana CLI

Solana CLI cung cấp tất cả các công cụ cần thiết để xây dựng và triển khai các chương trình Solana.

Cài đặt bộ công cụ Solana CLI bằng lệnh cài đặt chính thức:

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

Bạn có thể thay thế stable bằng thẻ phát hành tương ứng với phiên bản phần mềm mà bạn muốn (ví dụ: v2.0.3), hoặc sử dụng một trong ba tên kênh biểu tượng: stable, beta, hoặc edge.

Đối với lần đầu cài đặt Solana CLI, bạn có thể thấy thông báo sau đây nhắc bạn thêm biến môi trường 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"

Nếu bạn đang sử dụng Linux hoặc WSL, bạn cần thêm binary Solana CLI vào PATH để lệnh có sẵn trong terminal của bạn.

Đầu tiên, chạy lệnh sau để kiểm tra shell nào bạn đang sử dụng:

Terminal
$
echo $SHELL
  • Nếu kết quả chứa /bash, hãy sử dụng .bashrc.
  • Nếu kết quả chứa /zsh, hãy sử dụng .zshrc.

Tùy thuộc vào shell của bạn, hãy chạy lệnh thích hợp.

Đối với Bash (bashrc):

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

Đối với Zsh (zshrc):

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

Sau đó chạy lệnh sau để làm mới phiên terminal hoặc khởi động lại terminal của bạn.

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

Để xác minh rằng quá trình cài đặt đã thành công, hãy kiểm tra phiên bản Solana CLI:

Terminal
$
solana --version

Bạn sẽ thấy kết quả như sau:

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

Bạn có thể xem tất cả các phiên bản có sẵn trên Agave Github repo.

Agave là validator client từ Anza, trước đây được biết đến như là Solana Labs validator client.

Để cập nhật Solana CLI lên phiên bản mới nhất sau này, bạn có thể sử dụng lệnh sau:

Terminal
$
agave-install update

Cài đặt Anchor CLI

Anchor là một framework để phát triển các chương trình Solana. Framework Anchor sử dụng các macro Rust để đơn giản hóa quá trình viết các chương trình Solana.

Bạn có thể cài đặt Anchor CLI và các công cụ theo hai cách:

  1. Anchor Version Manager (AVM) - Phương pháp cài đặt được khuyến nghị
  2. Không dùng AVM - Cài đặt trực tiếp từ GitHub

Anchor version manager (AVM) cho phép bạn cài đặt và quản lý các phiên bản Anchor khác nhau trên hệ thống của mình và dễ dàng cập nhật phiên bản Anchor trong tương lai.

Cài đặt AVM với lệnh sau:

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

Xác nhận rằng AVM đã được cài đặt thành công:

Terminal
$
avm --version

Cài đặt phiên bản mới nhất của Anchor CLI sử dụng AVM:

Terminal
$
avm install latest
$
avm use latest

Bạn có thể cài đặt một phiên bản cụ thể của Anchor CLI bằng cách chỉ định số phiên bản:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

Đừng quên chạy lệnh avm use để khai báo phiên bản Anchor CLI sẽ chạy trên hệ thống của bạn.

  • Nếu bạn đã cài đặt phiên bản latest, hãy chạy avm use latest.
  • Nếu bạn đã cài đặt phiên bản 0.30.1, hãy chạy avm use 0.30.1.

Để xác minh rằng việc cài đặt đã thành công, kiểm tra phiên bản Anchor CLI:

Terminal
$
anchor --version

Bạn sẽ thấy kết quả như sau:

anchor-cli 0.31.1

Khi cài đặt Anchor CLI trên Linux hoặc WSL, bạn có thể gặp lỗi này:

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

Nếu bạn thấy thông báo lỗi này:

  1. Cài đặt các phụ thuộc được liệt kê trong phần Linux ở đầu trang này.
  2. Thử cài đặt lại Anchor CLI.

Node.js và Yarn

File kiểm thử dự án Anchor mặc định (TypeScript) được tạo bằng lệnh anchor init yêu cầu Node.js và Yarn. (Mẫu kiểm thử Rust có sẵn bằng cách sử dụng anchor init --test-template rust)

Khi chạy anchor build, nếu bạn gặp các lỗi sau:

Sau khi áp dụng giải pháp trên, hãy thử chạy lại anchor build.

Khi chạy anchor test sau khi tạo một dự án Anchor mới trên Linux hoặc WSL, bạn có thể gặp các lỗi sau nếu chưa cài đặt Node.js hoặc Yarn:

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

Cơ bản về Solana CLI

Phần này hướng dẫn một số lệnh Solana CLI phổ biến để giúp bạn bắt đầu.

Cấu hình Solana

Để xem cấu hình hiện tại của bạn:

Terminal
$
solana config get

Bạn sẽ thấy kết quả như sau:

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

URL RPC và URL Websocket chỉ định cụm Solana mà CLI gửi yêu cầu đến.

Bạn có thể cập nhật cụm Solana CLI bằng các lệnh sau:

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

Bạn cũng có thể sử dụng các tùy chọn ngắn sau:

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

Đường dẫn Keypair trỏ đến ví Solana (keypair) mặc định được Solana CLI sử dụng để thanh toán phí giao dịch và triển khai chương trình. Theo mặc định, tệp này được lưu trữ tại ~/.config/solana/id.json.

Tạo ví

Để gửi giao dịch bằng Solana CLI, bạn cần một ví Solana được nạp SOL.

Để tạo một keypair tại Đường dẫn Keypair mặc định, chạy lệnh sau:

Terminal
$
solana-keygen new

Bạn sẽ thấy kết quả như sau:

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

Nếu bạn đã có ví hệ thống tệp được lưu ở vị trí mặc định, lệnh này sẽ không ghi đè trừ khi bạn buộc ghi đè bằng cách sử dụng cờ --force.

Để xem địa chỉ ví của bạn (khóa công khai), chạy:

Terminal
$
solana address

Airdrop SOL

Yêu cầu airdrop SOL vào ví của bạn để thanh toán cho các giao dịch và triển khai chương trình.

Thiết lập cluster của bạn sang devnet:

Terminal
$
solana config set -ud

Sau đó yêu cầu airdrop SOL trên devnet:

Terminal
$
solana airdrop 2

Airdrop trên devnet giới hạn yêu cầu ở mức 5 SOL mỗi lần. Nếu bạn gặp giới hạn tốc độ hoặc lỗi, hãy thử sử dụng Web Faucet thay thế.

Để kiểm tra số dư SOL trong ví của bạn, chạy lệnh sau:

Terminal
$
solana balance

Chạy validator cục bộ

Solana CLI bao gồm sẵn một test validator cho phát triển cục bộ.

Trong một terminal riêng biệt, chạy lệnh sau để khởi động validator cục bộ:

Terminal
$
solana-test-validator

Hãy nhớ cập nhật CLI của bạn để sử dụng localhost trước khi chạy các lệnh Solana CLI:

Terminal
$
solana config set -ul

Cơ bản về Anchor CLI

Phần này hướng dẫn một số lệnh Anchor CLI phổ biến để giúp bạn bắt đầu. Để biết thêm thông tin về Anchor CLI, xem Tài liệu Anchor.

Khởi tạo dự án

Để tạo một dự án Anchor mới, chạy lệnh sau:

Terminal
$
anchor init <project-name>

Ví dụ, để tạo một dự án có tên my-project, hãy chạy:

Terminal
$
anchor init my-project

Lệnh này tạo một thư mục mới với tên dự án và khởi tạo một dự án Anchor mới với một chương trình Rust cơ bản và mẫu kiểm thử TypeScript.

Di chuyển đến thư mục dự án:

Terminal
$
cd <project-name>

Xem cấu trúc tệp của dự án Anchor.

Xây dựng chương trình

Để xây dựng dự án của bạn, hãy chạy lệnh sau:

Terminal
$
anchor build

Bạn có thể tìm thấy chương trình đã biên dịch trong thư mục /target/deploy.

Triển khai chương trình

Để triển khai dự án của bạn, hãy chạy lệnh sau:

Terminal
$
anchor deploy

Lệnh này triển khai chương trình của bạn đến cluster được chỉ định trong tệp Anchor.toml.

Kiểm thử chương trình

Để kiểm thử dự án của bạn, hãy chạy lệnh sau:

Terminal
$
anchor test

Lệnh này xây dựng, triển khai và chạy các bài kiểm thử cho dự án của bạn.

Khi sử dụng localnet làm cluster trong Anchor.toml, Anchor tự động khởi động một validator cục bộ, triển khai chương trình của bạn, chạy các bài kiểm thử, và sau đó dừng validator.

Is this page helpful?