Nexus Network CLI 使用教程
1. 项目介绍
Nexus Network CLI 是一个高性能的命令行界面,用于向 Nexus 网络贡献证明。Nexus 网络是一个全球分布式证明网络,它联合世界各地的计算机,推动构建一个新的、更好的互联网——可验证互联网。通过连接到测试网并尝试使用,您可以参与到这个网络中来。
2. 项目快速启动
单用户安装
最简单的单命令安装方式(特别适用于本地测试或个人使用),大多数用户会选择这样做:
curl https://cli.nexus.xyz/ | sh
注意:这个脚本会自动安装 Rust(如果您还没有安装的话),并在交互式壳中提示您接受使用条款。
如果您已经下载了 install.sh
脚本:
./install.sh
持续集成 (CI)
install.sh
脚本设计用来做以下几件事情:
- 安装 Rust(如果尚未安装),尽可能非交互式安装,以免打扰用户。
- 通过 bash 提示用户接受使用条款,并通过 Rust 程序输入节点 ID。
在 CI 环境中,以下部分可能会有问题:
(
cd "$REPO_PATH/clients/cli"
|| exit
cargo run --release -- --start --beta
) < /dev/tty
这个 bash 和 Rust 的组合在 CI 环境中有点脆弱。可以考虑以下替代方法:
-
从源代码构建:
git clone https://github.com/nexus-xyz/network-api cd network-api/clients/cli cargo build --release ./target/release/nexus-network --start --beta
-
本地下载脚本(可选设置
NONINTERACTIVE=1
以无提示运行):curl -sSf https://cli.nexus.xyz/ -o install.sh chmod +x install.sh NONINTERACTIVE=1 ./install.sh
从源代码构建或运行下载的脚本可以让您更好地控制依赖关系和版本,并避免在自动化运行期间出现任何意外的提示。
本地测试与 HTTP 服务器
如果您想在本地模拟 curl https://cli.nexus.xyz/ | sh
:
-
在项目根目录,启动本地服务器:
python3 -m http.server 8080
-
在另一个终端,运行:
curl -sSf http://localhost:8080/public/install.sh | sh -x
观察脚本输出并验证安装逻辑。如果没有安装 Rust,系统将提示您安装(除非设置了 NONINTERACTIVE=1
)。
系统要求
-
Linux:
sudo apt update && sudo apt upgrade sudo apt install build-essential pkg-config libssl-dev git-all protobuf-compiler
-
macOS:
brew install git
-
Windows:
安装 WSL。在 WSL 中按照 Linux 指导操作。
使用条款
CLI 的使用受使用条款约束。首次运行的交互式用户将被提示接受这些条款。对于非交互式接受(例如在 CI 中),运行:
NONINTERACTIVE=1 sh install.sh
或者在调用脚本之前设置 NONINTERACTIVE=1
。
节点 ID
在 CLI 启动期间,系统将询问您的节点 ID(用于测试网或开发网)。
在非交互式环境(NONINTERACTIVE=1
)中跳过提示时,将您的节点 ID 手动放入 ~/.nexus/node-id
。
3. 应用案例和最佳实践
(在此部分,您可以添加关于如何在实际应用中使用 Nexus Network CLI 的例子,包括但不限于配置、操作步骤、常见问题解决方案等。)
4. 典型生态项目
(在此部分,您可以介绍一些与 Nexus Network CLI 相关的典型生态项目,这些项目可能包括其他开源项目、社区贡献的插件或工具等。)