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.
$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.1Node.js: v23.11.0Yarn: 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 CLI và Cơ 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:
$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:
$. "$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:
$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:
$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:
$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
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Đối với Zsh (zshrc
):
$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.
$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:
$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:
$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:
- Anchor Version Manager (AVM) - Phương pháp cài đặt được khuyến nghị
- 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:
$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:
$avm --version
Cài đặt phiên bản mới nhất của Anchor CLI sử dụng AVM:
$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:
$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ạyavm use latest
. - Nếu bạn đã cài đặt phiên bản
0.30.1
, hãy chạyavm 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:
$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:
- Cài đặt các phụ thuộc được liệt kê trong phần Linux ở đầu trang này.
- 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:
$solana config get
Bạn sẽ thấy kết quả như sau:
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
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:
$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:
$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:
$solana-keygen new
Bạn sẽ thấy kết quả như sau:
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===========================================================================
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:
$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:
$solana config set -ud
Sau đó yêu cầu airdrop SOL trên devnet:
$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:
$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ộ:
$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:
$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:
$anchor init <project-name>
Ví dụ, để tạo một dự án có tên my-project
, hãy chạy:
$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:
$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:
$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:
$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:
$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?