https://github.com/yosebyte/nodepass
NodePass is a secure, efficient TCP/UDP tunneling solution that delivers fast, reliable access across network restrictions using pre-established TLS/TCP connections.
https://github.com/yosebyte/nodepass
golang networking pooling server-client tcp tunneling udp
Last synced: 7 months ago
JSON representation
NodePass is a secure, efficient TCP/UDP tunneling solution that delivers fast, reliable access across network restrictions using pre-established TLS/TCP connections.
- Host: GitHub
- URL: https://github.com/yosebyte/nodepass
- Owner: yosebyte
- License: mit
- Created: 2024-12-19T08:26:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-13T15:33:52.000Z (about 1 year ago)
- Last Synced: 2025-04-13T15:36:39.964Z (about 1 year ago)
- Topics: golang, networking, pooling, server-client, tcp, tunneling, udp
- Language: Go
- Homepage: https://www.nodeseek.com/post-295115-1
- Size: 317 KB
- Stars: 369
- Watchers: 2
- Forks: 22
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - nodepass - A secure, efficient TCP/UDP tunneling solution that delivers fast, reliable access across network restrictions using pre-established TLS/TCP connections. (Networking / Transliteration)
- my-awesome - yosebyte/nodepass - rest,connection-pooling,cybersecurity,devops,golang,http2,nat-traversal,networking,openapi,penetration-testing,port-forwarding,quic,red-team,sse,tcp,tls,tunneling,udp,websocket,zero-config pushed_at:2026-01 star:2.0k fork:0.2k 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. (Go)
- StarryDivineSky - yosebyte/nodepass
- awesome-go-with-stars - nodepass - established TLS/TCP connections. | 2026-01-18 | (Networking / Transliteration)
- awesome - yosebyte/nodepass - 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. (Go)
- fucking-awesome-go - nodepass - A secure, efficient TCP/UDP tunneling solution that delivers fast, reliable access across network restrictions using pre-established TLS/TCP connections. (Networking / Transliteration)
- awesome-go - yosebyte/nodepass - established TLS/TCP connections ☆`1,548` (Networking / Transliteration)
- awesome-go-cn - nodepass - established TLS/TCP connections. [![godoc][D]](https://godoc.org/github.com/yosebyte/nodepass) [![包含中文文档][CN]](https://github.com/yosebyte/nodepass) (网络 / 音译)
- awesome-go - nodepass - A secure, efficient TCP/UDP tunneling solution that delivers fast, reliable access across network restrictions using pre-established TLS/TCP connections. Stars:`1.3K`. (Networking / Transliteration)
README
[](https://github.com/avelino/awesome-go#networking)
[](https://github.com/yosebyte/nodepass/releases)
[](https://github.com/yosebyte/nodepass/releases)
[](https://goreportcard.com/report/github.com/yosebyte/nodepass)
[](https://opensource.org/licenses/BSD-3-Clause)
[](https://pkg.go.dev/github.com/yosebyte/nodepass)
[](https://deepwiki.com/yosebyte/nodepass)
English | [简体中文](README_zh.md)
**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 conversion. Designed for DevOps professionals and system administrators to effortlessly handle complex network scenarios.
## 💎 Key Features
- **🌐 Universal Functionality**
- Basic TCP/UDP tunneling and protocol conversion across diverse networks.
- Compatible with port mapping, NAT traversal, and traffic relay.
- Cross-platform, multi-architecture, single binary or container.
- **🚀 Connection Pool**
- Pre-established connections for zero-latency switching and forwarding.
- Eliminates handshake delays, boosts performance.
- Auto-scaling with real-time capacity adjustment.
- **🧬 Innovative Architecture**
- Integrated S/C/M architecture, flexible mode switching.
- Full decoupling of control/data channels.
- API-instance management, multi-instance collaboration.
- **🔐 Multi-level Security**
- Three TLS modes: plaintext, self-signed, strict validation.
- Covers development 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.
- Advanced parameters like timeouts and rate limits.
- **📈 Performance**
- Intelligent scheduling, auto-tuning, ultra-low resource usage.
- Stable under high concurrency and heavy load.
- Health checks, auto-reconnect, self-healing.
- **💡 Visualization**
- Rich cross-platform visual frontends.
- One-click deployment scripts, easy management.
- Real-time monitoring, API-instance management, traffic stats.
## 📋 Quick Start
### 📥 Installation
- **Pre-built Binaries**: Download from [releases page](https://github.com/yosebyte/nodepass/releases).
- **Container Image**: `docker pull ghcr.io/yosebyte/nodepass:latest`
### 🚀 Basic Usage
**Server Mode**
```bash
nodepass "server://:10101/127.0.0.1:8080?log=debug&tls=1"
```
**Client Mode**
```bash
nodepass "client://server:10101/127.0.0.1:8080?min=128"
```
**Master Mode (API)**
```bash
nodepass "master://:10101/api?log=debug&tls=1"
```
## 📚 Documentation
Explore the complete documentation to learn more about NodePass:
- [Installation Guide](/docs/en/installation.md)
- [Usage Instructions](/docs/en/usage.md)
- [Configuration Options](/docs/en/configuration.md)
- [API Reference](/docs/en/api.md)
- [Examples](/docs/en/examples.md)
- [How It Works](/docs/en/how-it-works.md)
- [Troubleshooting](/docs/en/troubleshooting.md)
## 🌱 Ecosystem
The [NodePassProject](https://github.com/NodePassProject) organization develops various frontend applications and auxiliary tools to enhance the NodePass experience:
- **[NodePassDash](https://github.com/NodePassProject/NodePassDash)**: A modern NodePass management interface that provides master management, instance management, traffic statistics, history records, and more.
- **[NodePanel](https://github.com/NodePassProject/NodePanel)**: A lightweight frontend panel that provides visual tunnel management, deployable on Vercel or Cloudflare Pages.
- **[npsh](https://github.com/NodePassProject/npsh)**: A collection of one-click scripts that provide simple deployment for API or Dashboard with flexible configuration and management.
- **[NodePass-ApplePlatforms](https://github.com/NodePassProject/NodePass-ApplePlatforms)**: An iOS/macOS application that offers a native experience for Apple users.
- **[nodepass-core](https://github.com/NodePassProject/nodepass-core)**: Development branch, featuring previews of new functionalities and performance optimizations, suitable for advanced users and developers.
## 💬 Discussion
- Follow our [Telegram Channel](https://t.me/NodePassChannel) for updates and community support.
- Join our [Discord](https://discord.gg/2cnXcnDMGc) and [Telegram Group](https://t.me/NodePassGroup) to share experiences and ideas.
## 📄 License
Project `NodePass` is licensed under the [BSD 3-Clause License](LICENSE).
## ⚖️ Disclaimer
This project is provided "as is" without any warranties. Users assume all risks and must comply with local laws for legal use only. Developers are not liable for any direct, indirect, incidental, or consequential damages. Secondary development requires commitment to legal use and self-responsibility for legal compliance. Developers reserve the right to modify software features and this disclaimer at any time. Final interpretation rights belong to developers.
## 🤝 Sponsors
## ⭐ Stargazers
[](https://starchart.cc/yosebyte/nodepass)