Files
Archive/nodepass/README_zh.md
2025-12-19 19:41:40 +01:00

7.3 KiB
Raw Blame History

nodepass

Mentioned in Awesome Go GitHub release GitHub downloads Go Report Card License Go Reference Ask DeepWiki GitHub last commit

English | 简体中文

NodePass 是一款开源、轻量的企业级 TCP/UDP 网络隧道解决方案,采用多合一架构设计,通过控制通道与数据通道分离,实现灵活、高性能的实例管控。支持零配置文件部署,内置智能连接池、分级 TLS 加密和无缝协议转换。专为 DevOps 工程师和系统管理员打造,助力轻松应对复杂网络场景。

💎 核心功能

  • 🌐 通用网络隧道

    • 基础 TCP/UDP 隧道,具备协议转换能力,适配多种网络结构。
    • 完整适配端口映射、内网穿透、流量中转等多场景应用需求。
    • 多平台、多架构支持,支持独立二进制文件、容器灵活部署。
  • 🚀 内置连接池

    • 提供 TCP、QUIC、WebSocket、HTTP/2 多种池化传输方式。
    • 消除连接的握手等待,通过 0-RTT 支持显著提升性能体验。
    • 支持实时容量自适应,动态调整连接池规模。
  • 🧬 创新架构设计

    • Server-Client-Master 多模式整合架构设计,灵活切换。
    • 将 S/C 控制通道与数据通道完全解耦,相互独立、各司其职。
    • 主控-实例的管理方式,支持动态扩容、多实例协作和集中控制。
  • 🔐 多级安全策略

    • 三种 TLS 模式:明文、自签名、严格验证,适配不同安全等级。
    • 满足从开发测试到企业级高安全部署的全场景需求。
    • 支持证书文件的热重载,免停运、无缝处理证书更新问题。
  • ⚙️ 极简配置方式

    • 无需配置文件,仅命令行参数即可运行,适合自动化和快速迭代。
    • 适配 CI/CD 流程与容器环境,极大提升部署和运维效率。
    • 支持超时、限速等高级参数调优,灵活适应不同运行环境。
  • 📈 高性能优化

    • 智能流量调度与自动连接调优,极低资源占用。
    • 高并发、高负载状态下卓越的系统稳定性能。
    • 负载均衡、健康检查、故障自愈,确保持续高可用。
  • 💡 可视化管理

    • 配套跨平台、多样化的管理前端应用,具备可视化配置能力。
    • 主流平台支持一键部署脚本,支撑灵活配置和辅助管理。
    • 具备实时隧道监控、实例管理、主控管理、流量统计等丰富功能。

📋 快速开始

📥 安装方法

  • 预编译二进制文件: 从发布页面下载。
  • 容器镜像: docker pull ghcr.io/yosebyte/nodepass:latest

🚀 基本用法

服务端模式

nodepass "server://:10101/127.0.0.1:8080?log=debug&tls=1"

客户端模式

nodepass "client://server:10101/127.0.0.1:8080?min=128"

主控模式 (API)

nodepass "master://:10101/api?log=debug&tls=1"

📚 文档

探索完整文档以了解更多关于NodePass的信息

🌱 生态系统

NodePassProject 组织开发了各种前端应用和辅助工具来增强 NodePass 体验:

  • NodePassDash: 现代化的 NodePass 管理界面,提供主控管理、实例管理、流量统计、历史记录等功能。

  • NodePanel: 轻量化的前端面板,提供可视化的隧道管理功能,在 Vercel 或 Cloudflare Pages 轻松部署。

  • npsh: 简单易用的 NodePass 一键脚本合集,包括 API 主控、Dash 面板的安装部署、灵活配置和辅助管理。

  • NodePass-ApplePlatforms: 面向服务的 iOS/macOS 应用,为 Apple 用户提供原生体验。

  • nodepass-core: 开发分支,包含新功能预览和性能优化测试,适合高级用户和开发者。

💬 讨论

📄 许可协议

NodePass 项目根据 BSD 3-Clause 许可证授权。

⚖️ 免责声明

本项目以"现状"提供,开发者不提供任何明示或暗示的保证。用户使用风险自担,需遵守当地法律法规,仅限合法用途。开发者对任何直接、间接、偶然或后果性损害概不负责。进行二次开发须承诺合法使用并自负法律责任。开发者保留随时修改软件功能及本声明的权利。最终解释权归开发者所有。

🔗 NFT 支持

以独特方式支持 NodePass,查看我们在 OpenSea 上的 NFT 收藏。

🤝 赞助商

Star趋势

Stargazers over time