Season1.1 本地 Solana 开发环境配置
此帖还在更新,别急,
本地节点搭建
我的环境清单:
OS: WSL2(Ubuntu 22.04 LTS)
- Shell: Bash(Default)
- IDE: Antigravity
1. 安装依赖:build-essential、 pkg-config、 libudev-dev、 llvm、 libclang-dev、 protobuf-compiler、 libssl-dev
apt-get update
apt-get install -y build-essential pkg-config libudev-dev llvm libclang-dev protobuf-compiler libssl-dev
| 依赖包名称 | 核心作用 (Role) | 缺失时的典型报错 (Panic) |
|---|---|---|
| libclang-dev | 前端解析:解析 C 头文件 AST,供 bindgen 生成 Rust 绑定 | Unable to find libclang |
| llvm | 后端基座:提供底层编译基础设施,libclang 的运行底座 | LLVM_CONFIG_PATH not found 或链接错误 |
| protobuf-compiler | 序列化:编译 .proto 文件,生成 gRPC/RPC 通信代码 | protoc not found / failed to run custom build command for prost-build |
| build-essential | 编译套件:提供 GCC/G++/Make/Linker | linker 'cc' not found |
| pkg-config | 路径导航:告诉编译器去哪找 .so 和 .h 文件 | Could not find library 'xxx' |
| libudev-dev | 硬件交互:Linux 内核设备管理,用于支持 USB 硬件钱包 | failed to build hidapi |
| libssl-dev | 加密算法:OpenSSL 开发库,区块链签名的基础 | openssl-sys 编译失败 |
2. 安装 Rust 语言环境
# 安装 Rust 语言环境
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
# 重新加载环境变量
. "$HOME/.cargo/env"
# 验证安装
rustc --version
cargo --version
3. 安装 Solana CLI(命令行工具)
# 下载并安装 Solana 工具套件
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
# 配置环境变量
SOLANA_BIN="$HOME/.local/share/solana/install/active_release/bin"
export PATH="$SOLANA_BIN:$PATH"
# 持久化配置
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
# 验证安装
solana --version
4. 安装 Anchor CLI(开发框架)
使用 nvm 安装 Node.js 搭建基础运行环境,然后利用其内置的 npm 安装更高性能的包管理器 Yarn。
# 用 nvm 安装 node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
nvm install node
# 安装 yarn
npm install --global yarn
# 安装 v0.30.1 版本的 Anchor CLI
cargo install --git https://github.com/solana-foundation/anchor --tag v0.30.1 anchor-cli
# 验证安装
anchor --version
5. 安装 Surfpool (本地节点)
# 安装 Surfpool
curl -sL https://run.surfpool.run/ | bash
# 验证安装
surfpool --version