Cài đặt
Phần này trình bày các bước để thiết lập môi trường cục bộ cho việc phát triển trên Solana.
Cài đặt nhanh
Trên Mac và Linux, chạy lệnh đơn này để 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 bỏ qua đến các 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
:
Đóng và mở lại terminal của bạn để áp dụng các thay đổi PATH hoặc chạy lệnh sau trong shell hiện tại của bạn:
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 của 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
, sử dụng.bashrc
. - Nếu kết quả chứa
/zsh
, sử dụng.zshrc
.
Tùy thuộc vào shell của bạn, chạy lệnh thích hợp.
Cho Bash (bashrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Cho 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 việc cài đặt đã thành công, 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 kho Github Agave.
Agave là validator client từ Anza, trước đây được biết đến 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 bạn 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 bằ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, hãy 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
Tệp kiểm thử mặc định của dự án Anchor (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 bạn chưa cài đặt Node.js hoặc Yarn:
Permission denied (os error 13)
No such file or directory (os error 2)
Thiết lập công cụ AI cho phát triển Solana
Phần này mô tả chi tiết về việc thiết lập công cụ AI tùy chọn mà bạn có thể sử dụng để đẩy nhanh quá trình phát triển Solana của mình.
Công cụ | Mô tả | Liên kết |
---|---|---|
MCP | Máy chủ MCP mà bạn có thể kết nối với cursor để cải thiện phát triển Solana hỗ trợ bởi AI. | https://mcp.solana.com/ |
LLMs.txt | Tài liệu được tối ưu hóa cho LLM mà bạn có thể sử dụng để huấn luyện LLM trên tài liệu Solana. | https://solana.com/llms.txt |
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
RPC URL và Websocket URL 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 mặc định (keypair) được sử dụng bởi Solana
CLI để 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 sử dụng Solana CLI, bạn cần một ví Solana đã 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ó một ví hệ thống tệp được lưu tại vị trí mặc định, lệnh này sẽ
không ghi đè lên nó 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.
Đặt cluster của bạn thành devnet:
$solana config set -ud
Sau đó yêu cầu airdrop SOL devnet:
$solana airdrop 2
Airdrop 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 gặp 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 validator thử nghiệm cho phát triển cục bộ.
Trong một cửa sổ terminal riêng, 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
, 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.
Biên dịch 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 sẽ 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?