NetSeed Docs

快速上手

连接两台设备：A 发邀请，B 输入邀请码，双方确认。不用登录，不用先 up。

先在两台设备上下载并安装 NS 命令行。下面以 macOS / Linux 为例；Windows 用管理员终端，去掉 sudo。账号模式正在连接时，先断开。

示例中的邀请码和节点 ID 请替换为终端实际显示的内容。其他问题见排错指南。

01 / 邀请方

A 发出邀请

整行输入后回车。把窗口里的 join 命令发给 B，保留窗口。确认时通过可信聊天、通话或当面对照节点 ID。

邀请码最长 15 分钟有效，一次邀请连接一台设备。

设备 A · 发出邀请交互示例
macOS / Linux · 输入后回车
sudo ns quick invite
邀请已生成，请保持此终端打开。

邀请码： KT58307264
本机节点 ID： <A的20字符节点ID>
将下面命令发给对方：
  ns quick join KT58307264
Windows 请使用管理员终端；macOS/Linux 如提示权限不足，请加 sudo。Ctrl-C 取消本次邀请。

02 / 接收方

B 加入并确认

邀请码跟在命令后，同一行输入。将“对方节点 ID”与 A 窗口里的“本机节点 ID”核对，一致才输入 y 并回车。

同时让 A 核对 B 的节点 ID。核对完整的 20 字符，不只看开头几位。

设备 B · 输入邀请码交互示例
macOS / Linux · 输入后回车
sudo ns quick join KT58307264
申请已发送，请双方确认对方节点。
本机节点 ID： <B的20字符节点ID>
对方节点 ID： <A的20字符节点ID>
请核对对方终端的完整节点 ID。允许连接这个节点？[y/N] y
不想让邀请码留在命令历史中？

先执行 sudo ns quick join，回车后输入邀请码，再回车。输入不回显，不是键盘失灵。

设备 B · 私密输入交互示例
终端 · 输入后回车
sudo ns quick join
请输入邀请码：

03 / 双方确认

A 确认 B

回到 A 原来的窗口，核对 B 的节点 ID，输入 y 并回车。

双方都确认后才会连接。节点 ID 不一致，不要确认。 配对成功后可设置本机备注；直接回车跳过，稍后也能改。

设备 A · 原邀请窗口交互示例
对方节点 ID： <B的20字符节点ID>
请核对对方终端的完整节点 ID。允许连接这个节点？[y/N] y
已确认，正在等待对方完成连接。
配对成功。ns quick peers 查看节点，ns quick status 查看实时连接。
本机备注名（英文字母、数字或连字符；回车跳过）：office-laptop
已保存本机备注 <B的20字符节点ID>: office-laptop

04 / 查看结果

查看对方

双方各自新开一个终端执行。四列是 ID、备注、IPv6、配对日期（UTC）。未设置备注时显示 —；窄终端自动分行。

有配对不等于业务可达；复制对方 IPv6 测试实际访问。

任一设备 · 已配对列表交互示例
终端 · 输入后回车
ns quick peers
ID                    NICKNAME       IPv6          PAIRED (UTC)
<20字符节点ID>        office-laptop  <对方IPv6>    2026-09-24
以上为已保存节点；实时连接请用 ns quick status 查看。
验证互通：ping / 应用访问

macOS：ping6 -c 4 <对方IPv6>；Linux：ping -6 -c 4 <对方IPv6>；Windows：ping -6 -n 4 <对方IPv6>。两边分别测试，再测试实际应用端口。超时也可能是防火墙限制，见排错指南。

05 / 暂停使用

停止连接

身份和配对保留。下次用 sudo ns quick up 恢复，不用重新邀请。

更多状态与管理命令。

本机 · 停止连接交互示例
终端 · 输入后回车
ns quick down
Quick 已停止，身份和已配对节点已保留。
取消邀请 / 输入错误 / 换行说明

配对未完成时，在邀请或加入窗口按 Ctrl-C。已有配对保留，再试时重新生成邀请。断网时远端可能无法立即清理，到期清理兜底。

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

输入与换行怎么读

每条命令整行输入、末尾回车；长命令自动折行，不用手动换行。不要把整段终端记录复制执行，“复制命令”只复制命令。<…> 要换成真实值。确认时输入 y 再回车，只按回车默认不确认。

默认邀请码是两位字母加八位数字，请完整复制；指定中继时使用 8 位 PIN，并带上 --relay。最简单的方式是复制邀请窗口生成的完整加入命令。