NetSeed Docs

连接与中继

默认不填中继。需要指定时，直接使用邀请窗口生成的接收方命令。

请使用邀请窗口生成的真实邀请码。短码配对需要客户端和所用中继同时支持；提示不支持时，按排错指南检查。

内置中继目录与证书说明

未指定中继时使用以下默认列表。已有中继设置会保留；要恢复此列表，使用下方的“恢复默认”。连接状态可用 ns quick status 查看。

前缀中继
KThkg-a1.43.159.53.106.sslip.io:51822
KMhkg-a2.124.156.159.181.sslip.io:51822
SGsin-a1.43.133.56.69.sslip.io:51822

未知前缀会尝试更新受信目录，仍无法识别则报错，不盲扫。自定义地址应由可信渠道提供；私有证书需本机预先配置受信 CA，邀请不会导入信任根。

默认中继与短码

不填中继即可开始。KT 指向目录中的中继，后八位定位临时邀请，不用逐台查询。

数据优先直连，必要时走共同中继；不代表中继间自动互转。

默认中继与短码交互示例
终端 · 输入后回车
sudo ns quick invite
…（省略其他提示）
邀请码： KT58307264
将下面命令发给对方：
  ns quick join KT58307264

指定 quick.haiyand.com

A 用 --relay 指定一个中继；B 复制生成的完整 join 命令，命令中已带上相同中继。暂不支持手动指定多个中继。

--relay 只填一个地址，不要用逗号拼接或重复填写。裸域名默认端口为 51822。

双方核对完整的 20 字符节点 ID，各确认一次。长命令自动折行，仍是一次回车。

指定中继时使用 8 位数字 PIN。中继地址和 PIN 可以前后调换；只填 PIN、不指定中继会提示补充地址，不会逐台查找。

设备 A · 指定中继邀请交互示例
终端 · 输入后回车
sudo ns quick invite --relay quick.haiyand.com
邀请已生成，请保持此终端打开。

邀请码： 58307264
本机节点 ID： <A的20字符节点ID>
将下面命令发给对方：
  ns quick join 58307264 --relay quick.haiyand.com
Windows 请使用管理员终端；macOS/Linux 如提示权限不足，请加 sudo。Ctrl-C 取消本次邀请。
设备 B · 复制命令加入交互示例
终端 · 输入后回车
sudo ns quick join 58307264 --relay quick.haiyand.com
申请已发送，请双方确认对方节点。
本机节点 ID： <B的20字符节点ID>
对方节点 ID： <A的20字符节点ID>
请核对对方终端的完整节点 ID。允许连接这个节点？[y/N] y
双方已确认，正在建立连接。

也可以先按回车，再私密输入 PIN。输入不回显，输完按回车继续。

设备 B · 回车后输入 PIN交互示例
终端 · 输入后回车
sudo ns quick join --relay quick.haiyand.com
请输入邀请码：

切换前会询问，不会暗中断开

输入 n 保留连接；y 才重启切换。之后用 status 核对，新配对要重新发邀请。

相同列表不重启；切换失败会报告恢复结果，不保证无条件回滚。

切换前会询问，不会暗中断开交互示例
终端 · 输入后回车
sudo ns quick up --relay quick.haiyand.com
当前中继： <当前中继列表>
目标中继： <目标中继列表>
切换中继会重启 Keynet 并中断当前连接。现在重启？[y/N] n
已取消中继切换；原运行时保持不变。

恢复内置中继

恢复并记住内置列表，不删身份和配对。需要重启时仍会询问；不能保证修复网络故障。

恢复内置中继交互示例
终端 · 输入后回车
sudo ns quick up --reset-relays
…（如果与当前列表不同，先询问是否重启）
Quick: 运行中
节点 ID: <本机20字符节点ID>
已配置中继 (builtins): hkg-a1.43.159.53.106.sslip.io:51822, hkg-a2.124.156.159.181.sslip.io:51822, sin-a1.43.133.56.69.sslip.io:51822
查看实时连接：ns quick status

可选配置文件

没有 keynet.toml 也能使用。启动时优先级：

启动方式从高到低
不带 --config本次中继选项 → 保存的偏好 → 默认位置配置文件 → 内置列表
指定 --config FILE本次中继选项 → 指定文件 → 内置列表；保存偏好不覆盖指定文件

运行中的实例不会因为编辑文件而暗中重启。查询、停止要使用启动时的用户和配置。显式选择保存到私有偏好，不修改用户 TOML。

配置文件中的自定义中继也只保留一个；内置列表不受此限制。

无人值守切换需要明确允许重启：

--switch-relay 只批准中继切换，不替代配对身份确认。安全证书、参数和自动化规则见常用命令。

可选配置文件交互示例
终端 · 输入后回车
sudo ns quick up --relay quick.haiyand.com --switch-relay
…（成功输出摘录，不再询问切换确认）
Quick: 运行中
节点 ID: <本机20字符节点ID>
已配置中继 (<实际配置来源>): quick.haiyand.com:51822
查看实时连接：ns quick status