#把主机作为节点接入

统一 ns 既是客户端也是 Node 程序。服务器不再安装另一套旧二进制：安装 ns、浏览器登记 Device、选择 Space 并后台运行即可成为当前 Network 的 Node。

#安装与登记

先从官网下载页选择「命令行」并安装，再执行：

ns --version
sudo ns up --server https://nsd.haiyand.com --hostname app-01 --detach --wait-ready
ns status --dns

Windows 使用管理员 PowerShell，省略 sudo。--hostname 请求当前 Network 的 Node DNS 标签；服务端可能因冲突或规则拒绝。

#运行模型

一次安装产生 Organization 范围 Device；在 Network 内激活后形成 Node。Node 接收当前 Space 的地址、路由和授权，同时可通过默认 /etc/nsio/services.toml 发布本机服务。文件不存在表示暂不发布服务；格式错误会阻止安全启动或上报，不能自动忽略错误配置。

#后台运行

--detach --wait-ready 在守护进程应用首个配置后返回。生产环境应使用平台服务管理器确保开机启动、日志轮换和最小权限，并避免与桌面 App 同时持有 Core。

#切换 Network

sudo ns down
ns space list
ns space switch <NETWORK_ID>
sudo ns up --detach --wait-ready

切换成功后保持未连接，重启前核对 ns info。服务定义会在目标 Network 重新发布；不要假设两个 Network 的授权、IP 或 DNS 相同。

#维护

使用 ns update --check 检查版本，ns doctor 做只读诊断，ns report 生成反馈入口。退役前先删除/转移 Service，撤销授权，ns down，最后由管理员在 NSD 清理 Node/Device 记录。