NEAR 工具 — NEAR CLI 安装与配置

对 Agent 至关重要：在调用任何 near 命令前，你 必须 找到 near 二进制文件的绝对路径（例如使用 which near 或 whereis near），并在所有命令中显式使用该绝对路径。此举可确保在不同 shell 环境下行为一致。

本指南提供在任意平台上安装与配置 NEAR Protocol CLI（near-cli-rs）的完整说明。

安装方式

请选择最适合您系统的安装方式：

选项 1：Shell 脚本安装（Linux、macOS、WSL）

适用场景：大多数 Linux 和 macOS 用户

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.sh | sh

若未自动将 near 加入 PATH： 使用 whereis near 查找 near 二进制文件位置

手动添加至 PATH：

# 临时生效（仅当前会话）
export PATH="$HOME/.cargo/bin:$PATH"

# 永久生效（写入 shell 配置文件）
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc  # 适用于 bash
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc   # 适用于 zsh

重新加载 shell 配置，或执行：

source ~/.bashrc   # 或 ~/.zshrc

选项 2：npm / npx（任一支持 Node.js 的平台）

适用场景：JavaScript / TypeScript 开发者、Windows 用户

无需安装，直接运行：

npx near-cli-rs

全局安装：

npm install -g near-cli-rs

或添加为项目开发依赖：

npm install --save-dev near-cli-rs

随后使用：

npx near-cli-rs

选项 3：Windows 安装程序（MSI）

适用场景：未安装 Node.js 或 Cargo 的 Windows 用户

1. 访问：https://github.com/near/near-cli-rs/releases/latest
2. 下载 Windows MSI 安装包（例如：near-cli-rs-installer-x64.msi）
3. 双击安装包并按向导提示完成安装
4. 安装程序将自动将 NEAR CLI 添加至系统 PATH

选项 4：Cargo（Rust）

适用场景：Rust 开发者、需定制构建的用户

前置条件：请先从 https://rustup.rs/ 安装 Rust

安装命令：

cargo install near-cli-rs

或从 Git 主干安装最新版本：

cargo install --git https://github.com/near/near-cli-rs

Linux 用户可能还需安装依赖：

# Debian / Ubuntu
sudo apt install libudev-dev

# Fedora / Red Hat
sudo dnf install libudev-devel

验证安装

安装完成后，请验证是否正常工作：

near --version

预期输出示例：

near-cli-rs 0.23.6  # 或更新的版本号

若提示 “command not found”：

1. 确认安装目录已加入 PATH：

   echo $PATH | grep cargo  # 检查 PATH 中是否包含 cargo/bin
   

2. 如未找到，手动添加：

   export PATH="$HOME/.cargo/bin:$PATH"
   

3. 再次测试：

   near --version
   

配置

查看配置文件位置

near --help
# 输出中将显示配置存储路径，通常为：
# "near CLI configuration is stored in ~/.config/near-cli/config.toml"

查看可用命令列表

near --help

主要命令分组如下：

• account — 管理账户（查看、创建、导入、导出）
• tokens — 管理通证资产（NEAR、FT、NFT）
• staking — 管理质押（查看、增加、提取）
• contract — 管理智能合约（部署、调用函数）
• transaction — 操作交易
• config — 管理 config.toml 中的网络连接配置

入门操作

查看账户摘要信息

若您已拥有 NEAR 账户：

near account view-account-summary  network-config mainnet now

示例：

near account view-account-summary near network-config mainnet now

导入已有账户

若您持有助记词（seed phrase）或私钥：

near account import-account

根据交互式提示完成登录。

创建新账户

若您尚无 NEAR 账户：

near account create-account

按提示创建新账户（需由已有账户为其充值）。

故障排查

“near: command not found”

原因：NEAR CLI 未加入 PATH 环境变量

解决方案：

# Shell 脚本安装方式
export PATH="$HOME/.cargo/bin:$PATH"

# npm 全局安装方式
export PATH="$(npm config get prefix)/bin:$PATH"

# 将上述任一命令追加至 ~/.bashrc 或 ~/.zshrc 实现永久生效

运行安装脚本时提示 “Permission denied”

原因：脚本缺少执行权限

解决方案：

chmod +x near-cli-rs-installer.sh
./near-cli-rs-installer.sh

“near-cli-rs-installer.sh: No such file”

原因：下载失败，或 GitHub 发布页中脚本文件名已变更

解决方案：

# 手动检查最新发布页中的 installer.sh 下载链接
curl -s https://api.github.com/repos/near/near-cli-rs/releases/latest | grep "browser_download_url" | grep "installer.sh"

安装过程卡住或速度极慢

原因：网络连接异常或带宽受限

解决方案：

# 使用 curl 设置更长超时时间
curl --proto '=https' --tlsv1.2 -LsSf --connect-timeout 30 --max-time 300 https://github.com/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.sh | sh

版本信息

• 最新稳定版：0.23.6（以本文档撰写日期为准）
• 检查更新：访问 https://github.com/near/near-cli-rs/releases
• 升级 CLI：重新运行对应安装命令（可指定版本号）

附加资源

• 官方 GitHub 仓库： https://github.com/near/near-cli-rs
• NEAR Protocol 官方文档： https://docs.near.org/
• NEAR Stack Overflow 标签页： https://stackoverflow.com/questions/tagged/nearprotocol
• NEAR Discord 社区： https://discord.gg/near

速查表

# 安装（Shell 脚本方式）
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.sh | sh

# 安装（npx 方式）
npx near-cli-rs

# 验证安装
near --version

# 查看账户摘要
near account view-account-summary  network-config mainnet now

# 导入账户
near account import-account

# 获取帮助
near --help
near account --help
near tokens --help