nodepass - A secure, efficient TCP/UDP tunneling solution tha

项目说明

<di="center">
<img src=" width="300">

![Mentioned in Awesome Go]()
![GitHub release]()
![License]()
![Go Reference]()
![Ask DeepWiki]()

<a href=" src=" width="120"></a>
</div>

NodePass is an open-source, lightweight, enterprise-grade TCP/UDP network tunneling solution featuring an all-in-one architecture with separation of control and data channels, along with flexible and high-performance instance control. It supports zero-configuration deployment, intelligent connection pooling, tiered TLS encryption, and seamless protocol con. Designed for DevOps professionals and system administrators to effortlessly handle complex network scenarios.

Key Features

Uni Functionality

- Basic TCP/UDP tunneling and protocol con across diverse networks.
- Compatible with port mapping, NAT tra, and traffic relay.
- Cross-platform, multi-architecture, single binary or container.

Connection Pool

- Supports TCP, QUIC, WebSocket, HTTP/2 pooling transport methods.
- Eliminates handshake delays, boosts performance with 0-RTT support.
- Auto-scaling with real-time capacity adjustment.

Inno Architecture

- Integrated S/C/M architecture, flexible mode switching.
- Full decoupling of control/data channels.
- API-instance management, multi-instance collaboration.

Multi-le

- Three TLS modes: plaintext, self-signed, strict .
- Covers de to enterprise security needs.
- Hot-reload certificates with zero downtime.

Minimal Configuration

- No config files required, ready to use via CLI.
- Optimized for CI/CD and containers.
- Ad parameters like timeouts and rate limits.

Performance

- Intelligent scheduling, auto-tuning, ultra-low resource usage.
- Stable under high concurrency and heavy load.
- Load balancing, health checks, self-healing and more.

- Rich cross-platform frontends.
- One-click deployment scripts, easy management.
- Real-time monitoring, API-instance management, traffic stats.

Quick Start

Start a server with TCP connection pooling:

Start a client for minimal 0-RTT tunneling:

Enable TLS security with self-signed certificate:

Launch a master for multi-instance management:

Documentation

Explore the complete documentation to learn more about NodePass:

Installation Guide

Usage Instructions

Configuration Options

CLI Reference

API Reference

MCP Reference

Examples

How It Works

Troubleshooting

See also DeepWiki for AI-powered documentation.

Ecosystem

The NodePassProject organization de frontend applications and auxiliary tools to enhance the NodePass experience:

NodePassDash: A modern NodePass management interface that provides master management, instance management, traffic statistics, history records, and more.

NodePass-ApplePlatforms: A ser iOS/macOS application that offers a nati for Apple users.

NodePanel: A lightweight frontend panel that provides tunnel management, deployable on or Cloudflare Pages.

npsh: A collection of one-click scripts that provide simple deployment for API or Dashboard with flexible configuration and management.

Donation

EVM: 0x2ea4Ea9425BEe897ED74fC5512bd13ABC7100000

TRX: TCqbhDHoBFKR

SOL: BwZuZwMFfdSwfawTiMv7Bw

Sponsorship

<p align="center">
<a href="
<img
src="
alt="GatewaySentry"
width="720"
>
</a>
</p>

<p align="center">
<em>
A DDoS mitigation solution that works and doesn't o capabilities,
since the product speaks for itself.
</em>
</p>

<p align="center">
_{Visit <a href=" to learn more.}
</p>

License

Project NodePass is licensed under the BSD 3-Clause License, which applies to the source code only.

The NodePass name, logo, and official project identity are not covered by the code license and may not be used without explicit authorization.

Disclaimer

This project is provided "as is" without any warranties. Users assume all risks and must comply with local laws for legal use only. De are not liable for any direct, indirect, incidental, or consequential damages. Secondary de requires commitment to legal use and self-responsibility for legal compliance. De reserve the right to modify software features and this disclaimer at any time. Final interpretation rights belong to de.

---

© 2026 NodePassProject. All rights reserved.

项目信息

开发语言：Go

Star 数：285

技术要点

该项目属于红蓝攻防方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕A secure, efficient TCP/UDP tunneling solution that delivers fast, reliable access across network restrictions using pre-established TCP/QUIC/WebSocket or HTTP/2 connections.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。