NetSeed Docs

设备与配对

节点 ID 稳定识别设备，备注帮助记忆，IP 用于访问。每一对设备单独授权。

首次配对见两台设备互通。下文用于已经启动且属于当前用户的实例，普通终端即可。右侧为交互示例；<…> 换成实际值。少量可选字段省略。

查看详情

默认用 IPv6 访问对方。两种 IPv4 入口都是本机地址映射，括号说明要访问的服务类型，不是备注名。未分配的可选地址不显示，active 也不代表在线。规则见地址与 DNS。

<节点ID> 支持完整 20 字符 ID、至少 8 字符的唯一前缀，或本机备注名；匹配多个节点会报错，需使用更完整的 ID。配对确认不能只核对短前缀。

查看详情交互示例
终端 · 输入后回车
ns quick peer show <节点ID>
节点 ID: <20字符节点ID>
本机备注名: office-laptop
IPv6: <对方IPv6>
IPv6 入口（访问 IPv4 服务）: <IPv6地址>
IPv4 入口（访问 IPv6 服务）: <本机IPv4入口> [active]
IPv4 入口（访问 IPv4 服务）: <本机IPv4入口> [active]
IPv4 入口只在本机有效；active 表示映射已启用，不代表对方在线。
完整公钥: <64字符公钥>
配对日期（UTC）: 2026-09-24

设置容易识别的名称

备注只在本机生效，不改变对方身份。配对完成时可输入，回车跳过；以后随时用此命令修改。备注还用于本机 DNS：使用英文字母、数字或连字符，大小写统一为小写，空格和下划线转为连字符，最长 63 字符。

设置容易识别的名称交互示例
终端 · 输入后回车
ns quick peer name <节点ID> office-laptop
保存这个本机备注名？[y/N] y
已保存本机备注 <20字符节点ID>: office-laptop

移除设备

表示本机已移除该对端并记录持久阻止，不只是隐藏列表。其他设备对它的授权不会被一起撤销。如果只想暂停所有连接，用 ns quick down，不用移除设备。

移除设备交互示例
终端 · 输入后回车
ns quick peer remove <节点ID>
移除此节点的访问权限？已有连接可能中断。[y/N] y
已移除节点 <20字符节点ID>

允许已移除设备重新配对

只是清除阻止记录，不会自动重建旧配对。下一步重新执行 invite / join。

查看准入记录，结果为身份和状态两列：

没有记录时显示“没有访问授权记录。”。高级管理也可用 allow remove 撤销准入，与移除设备一样需要确认：

允许已移除设备重新配对交互示例
终端 · 输入后回车
ns quick allow restore <节点ID>
解除对此节点的阻止？仍须重新配对才能访问。[y/N] y
已解除节点阻止 <20字符节点ID>. 需重新配对才能访问。
允许已移除设备重新配对交互示例
终端 · 输入后回车
ns quick allow list
NODE ID               STATE
<20字符节点ID>        <准入状态>
允许已移除设备重新配对交互示例
终端 · 输入后回车
ns quick allow remove <节点ID>
移除此节点的访问权限？已有连接可能中断。[y/N] y
已移除节点 <20字符节点ID>

取消未完成的短码配对

邀请或加入窗口中按 Ctrl-C：

^C
已取消临时邀请，已有连接不受影响。

重新尝试时生成新邀请；关闭窗口不代表配对成功。已有配对保留，临时邀请会在取消或到期后清理；网络中断时可能需要等到有效期结束。

如果 A 看到的申请不是目标设备，在节点 ID 确认处输入 n：

请核对对方终端的完整节点 ID。允许连接这个节点？[y/N] n
已拒绝该申请，继续等待目标设备。

A 的邀请窗口继续等待，完全取消仍用 Ctrl-C。

高级：准入策略与待审批管理（非配对必做步骤）

高级：准入策略与待审批记录

这些是持久准入管理命令，不是新短码配对的额外必做步骤，也不能替代双方身份确认。普通用户保持默认设置即可。

调整底层准入策略为人工审批：

--join 还支持 auto 和 recipient-only。auto 会让有效持有者凭据跳过底层本地审批，不建议为了省一步而开启。

查看底层待审批申请：

有申请时输出三列：REQUEST ID、NODE ID、STATE。必须核对完整节点 ID；批准和拒绝二选一，不要连续执行：

“已批准”不保证对端已经连接。短码窗口关闭或过期后，请重新发邀请，不用在这里寻找旧短码以恢复会话。

高级：准入策略与待审批记录交互示例
终端 · 输入后回车
ns quick policy set --join confirm
更改配对审批策略？[y/N] y
配对策略: confirm
高级：准入策略与待审批记录交互示例
终端 · 输入后回车
ns quick pending list
没有待确认的配对申请。
高级：准入策略与待审批记录交互示例
终端 · 输入后回车
ns quick pending approve <申请ID>
批准此配对申请？[y/N] y
已批准节点 <20字符节点ID> (<申请ID>)
高级：准入策略与待审批记录交互示例
终端 · 输入后回车
ns quick pending deny <申请ID>
拒绝此配对申请？[y/N] y
已拒绝申请 <申请ID>

增加第三台设备

A 与 B、A 与 C 分别配对，不意味着 B 与 C 自动互通。B 也要访问 C 时，两者再单独完成一次邀请和加入。不需要创建网络或指派“网络管理员”；系统管理员权限只是用于配置本机接口。