NetSeed Docs

    安装统一 NS

    当前只需一个 ns 二进制：它既能作为终端客户端连接，也能把服务器作为 Node 接入并发布服务。旧版拆分程序只用于历史迁移，不应出现在新安装步骤中。

    macOS 与 Linux

    curl -fsSL https://file.haiyand.com/files/ns.sh | sudo sh
ns --version

    Windows

    在管理员 PowerShell执行：

    [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
irm https://file.haiyand.com/files/ns.ps1 | iex
ns --version

    安装脚本从官方文件站获取对应架构、校验发布物并安装。网络受限环境应先由管理员审阅脚本和校验信息，不要从第三方镜像复制二进制。

    首次连接

    推荐从当前 NSD 快速开始复制完整命令。完整命令会同时携带 NSD URL、Noise 公钥、QUIC 证书指纹和响应 envelope signer pin，从而让 auto 模式可以安全选择全部已配置控制通道。三项含义见NS 命令参考。

    以下只含 --server 的写法是 HTTPS/SSE 最小连接方式，适合官方 authority 的初次浏览器登记；它不等价于已经启用 Noise/QUIC：

    macOS/Linux：

    sudo ns up --server https://nsd.haiyand.com

    Windows 管理员 PowerShell：

    ns up --server https://nsd.haiyand.com

    命令会打开浏览器。完成账号与 Device 授权后回到终端，选择可用 Space（如果有多个），并等待首个配置生效。服务器后台运行可使用 --detach --wait-ready。

    验证

    ns status --probe --dns
ns info

    status 查看当前运行与在线数据；info 可离线查看版本、状态目录、Device、NSD 注册与运行持有者。两者均支持稳定 JSON 输出，适合脚本采集。

    更新

    ns update --check
sudo ns update

    更新会校验新二进制并在新版本可运行前保留旧版本；Device 身份、Space Profiles、NSD 权威和配置不会被修改。它只更新 CLI，不更新 NetSeed App。

    下一步：阅读NS 命令参考，服务器发布服务则继续把主机作为节点接入。