nodepass-pro

README

NodePass-Pro v5

NodePass-Pro v5 是一个企业级多协议转发与隧道管理平台。在 NodePass 核心基础上，v5 版本实现了控制平面、执行平面与转发平面的深度增强，支持复杂的跨地域、多跳网络拓扑及带宽聚合场景。

🚀 v5 核心增强特性

• 🌐 多协议适配器 (ProtocolAdapter)

  • 原生支持 TCP, UDP, WebSocket, TLS, QUIC 五大核心协议。
  • 插件化架构，支持协议间无缝转换与透明握手。

• 🔗 可视化多跳转发 (HopChain)

  • 支持 N 跳动态路由编排（Entry -> Relay1 -> ... -> RelayN -> Exit）。
  • 可视化编辑器，支持拖拽节点构建复杂转发链路。

• ⚡️ 带宽聚合 (Bandwidth Aggregator)

  • 类 MPTCP 逻辑，支持多物理路径并行传输。
  • 内置 Hybrid 调度算法 (RTT x Bps 综合评分)，动态优选最优路径。
  • 基于最小堆的 PacketReorder 乱序重排缓冲区，确保数据流有序交付。

• 🛡️ 生产级业务系统 (Management Hub)

  • RBAC 鉴权: 基于 JWT-RS256 的多级角色权限控制。
  • 实时结算: 多级流量倍率引擎（节点倍率 x VIP 倍率），支持原子级配额扣减。
  • 可视化看板: 实时展示 24h 流量趋势图、节点负载及审计日志。
  • Telegram 集成: 支持 Widget 登录、Bot 指令绑定及实时异常通知。

🛠 快速开始

方式一：Docker Compose (推荐)

项目已预配置一键启动脚本，包含 Hub (控制器) 与基础 Agent：

git clone https://github.com/nodeox/nodepass-pro.git
cd nodepass-pro
docker-compose up -d

访问 http://localhost:8080 进入管理后台。

• 默认账号: admin
• 默认密码: 请在启动前设置环境变量 NPA_ADMIN_PASSWORD

方式二：手动编译

后端:

go mod tidy
go build -o npc ./cmd/controller
./npc

前端:

cd web
npm install
npm run build

🏗 项目架构

├── cmd/
│   ├── agent/          # v5 增强版 Agent 执行程序
│   └── controller/     # 业务管理中心 (Hub)
├── internal/
│   ├── tunnel/         # 核心转发引擎 (Relay, Aggregator, Reorder)
│   ├── store/          # 存储层 (SQLite + BoltDB)
│   ├── sse/            # SSE 实时推送流
│   └── auth/           # JWT & RBAC 逻辑
├── proto/              # gRPC 协议定义
└── web/                # React + AntD 管理后台

📜 开源协议

本项目基于 BSD 3-Clause License 协议。