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 Page总体架构
Next PageNSN · 架构与功能设计

#NSN · 站点节点

NSN(Network Site Node) —— NSIO 生态在站点侧的运行时进程,担任"被访问端"。它把 NSD 下发的策略落地为本机 WireGuard 隧道、本地路由 / NAT、Proxy / ACL 与监控接口,把对端流量代理到本地或远程服务。

#1. 角色速读

  • 位置:站点侧(企业内网 / 数据中心 / 边缘节点),与用户侧的 NSC 对称。
  • 入站:控制面(SSE 默认,可切 Noise / QUIC)从一个或多个 NSD 拉取 wg / proxy / acl / gateway / routing / dns 配置;数据面以 WireGuard UDP 或 WSS 接收 NSGW 中继的流量。
  • 出站:解密包 → smoltcp / TUN → nat::ServiceRouter(端口→服务查表 + ACL)→ proxy 字节级中继 → 本地 (127.0.0.1:*) 或远端服务 (LAN / 域名)。
  • 观测:默认在 127.0.0.1:9090 暴露只读 JSON + Prometheus 文本端点。

#2. 文档结构

文档你想了解
architecture.md架构与功能设计(角色、模块划分、设计特点、边界)
roadmap.md设计差距、改造主题、阶段排期、生产化演进

#3. 一屏速览

维度现状目标形态
数据面TUN / 用户态 (gotatun + smoltcp) / 纯 WSS 中继 三种+ P2P 直连 / 多路径 / BBR / FEC
控制面传输SSE / Noise IK / QUIC,共享同一事件解析器+ 全部 HTTP API 收敛进 ControlTransport
ACL单一 ArcSwapOption<AclEngine> 共享给 router 与 connector,fail-closed 默认+ 版本号 / 一键回滚 / 出站维度
多 NSD 并行MultiControlPlane 按 resource_id 合并去重+ 空 ACL sentinel 区分 / 本地保底
ConntrackTTL + LRU + 后台 sweeper+ 跨进程持久化 / IPv6
可观测OTel + Prometheus pipeline 已启用,关键路径已埋 histogram+ per-service 直方图 / 跨节点 trace 串联 / 审计事件流
形态数据中心 NSN+ 边缘 NSN(无头 provisioning)/ 移动 NSN
IPv6全栈 v4-only单独 milestone(>= 15 人日)

#4. 推荐阅读顺序

  1. 第一次接触 NSN → architecture §1-3 角色与模块划分
  2. 要规划演进 → roadmap.md 设计差距 + 阶段排期