NSIO Docs
NSIO Docs
首页
总体架构

NSN · 站点节点

NSN · 站点节点
NSN · 架构与功能设计
NSN · 演进路线与开发计划

NSC · 用户客户端

NSC · 用户客户端
NSC · 架构与功能设计
NSC · 演进路线与开发计划

NSD · 控制中心

NSD · 控制中心
NSD · 架构与功能设计
NSD · 演进路线与开发计划

NSGW · 数据网关

NSGW · 数据网关
NSGW · 架构与功能设计
NSGW · WireGuard Peer Relay 协议层
NSGW · 演进路线与开发计划

Last Updated: 2026/5/8 08:44:39

Previous PageNSN · 演进路线与开发计划
Next PageNSC · 架构与功能设计

#NSC · 用户客户端

NSC(Network Site Client) —— NSIO 生态在用户侧的运行时二进制,担任"访问端"。它把远端 NSN 站点上的服务"拉到本地",让用户在本机看到一组环回虚拟 IP 与一串 *.n.ns 域名,可用任意标准 TCP 工具(SSH / curl / psql / 浏览器)访问远端服务。

#1. 角色速读

  • 位置:用户终端(开发者笔记本 / CI runner / 企业办公机 / 移动 App 宿主),与站点侧的 NSN 对称。
  • 入站:控制面(SSE 默认)从 NSD 拉取 routing_config / gateway_config / dns_config 三类事件 —— 其余 4 类(wg / proxy / acl / token_refresh)目前显式丢弃。
  • 出站:127.127.x.x:port 上的 TCP 监听 → 路由解析 → 打开 WSS 流到主 NSGW → NSGW 中转到远端 NSN → 对端本地服务。可选 HTTP / CONNECT 代理入口。
  • 身份:基于机器密钥(Ed25519 + X25519),按 realm 分文件保存登记信息。

#2. 文档结构

文档你想了解
architecture.md架构与功能设计(角色定位、模块划分、设计特点、与 NSN 对照、边界)
roadmap.md设计差距、改造主题、阶段排期、企业级演进

#3. 一屏速览

维度现状目标
数据面模式userspace(默认 127.127/16)、wss(等价 userspace)、tun(仅换前缀)userspace + 真 TUN + WSS 严格模式 + P2P 直连
VIP 分配内存 HashMap,无持久化,/16 顺序分配,site 名幂等+ 持久化缓存 + 稳定 VIP ↔ site 映射
本地 DNS127.53.53.53:53 默认监听,命中 *.n.ns / dns_config,未命中硬编码 1.1.1.1(顶替系统原 DNS,破坏性集成)+ 接管前快照系统 DNS 作默认上游(读在写前)+ 网络切换刷新 + split DNS / + AAAA 支持
双栈域名(公网+隧道)dns_config 已可遮蔽 git.company.com 类公网域名到 VIP;隧道故障无 fallback、对 DoH 无对策+ 隧道健康降级回退公网 A / + 客户端 posture 上报 DoH 状态 / + 配置 SOP
条件转发 / 隧道内上游 DNS上游硬编码 1.1.1.1,不能"*.corp.company.com 走企业 AD"这类按域分流+ 按后缀最长匹配的转发表;内网 DNS 注册为普通 service 自动得 VIP,转发表上游直接指 dns.<site>.n.ns:53/tcp —— DNS 模块零隧道感知
SSE 消费仅 3 路:routing / gateway / dns;其余 4 路显式丢弃全部 8 路消费,出站 ACL,token 轮转
出站 ACL无,完全依赖 NSN / NSGW 兜底双层:客户端预检 + 服务端权威
HTTP 代理--http-proxy 127.0.0.1:8080 可选+ SOCKS5 / + PAC 自动配置 / + 企业域规则
认证--auth-key 多 realm;--device-flow baildevice-flow 复用 device_flow crate;token 加密落盘
状态 CLInsc status 只 println! 占位UNIX socket / HTTP 暴露 sites / vips / dns / tunnel 状态
可观测无 /metrics;无 OTel pipeline127.0.0.1:9091/metrics 暴露 dns / vip / nsgw_rtt / ws_reconnects
IPv6不支持 AAAA 命中与 NSN IPv6 同步

#4. 推荐阅读顺序

  1. 第一次接触 NSC → architecture §1-2
  2. 要规划演进 → roadmap.md 设计差距 + 阶段排期