github.com/NodePassProject/nodepass
v1.17.0
NodePassProject/nodepass
What this package is like to depend on
Last release 1 months ago
12 Jul 2026
Ships fairly regularly
a new release about every 3 months
Some releases are documented
notes for 2 of 4 stable releases
Nothing withdrawn
no release was ever pulled
7 months old
4 releases · first in 2026
4 releases in the last 12 months
see the full history below
Release timeline
4 releases · Jan 2026 to Jul 2026Releases
latest 4-
v1.17.012 Jul 2026Release notes
Open source →Changelog
- 1143450 chore: Update Go version to 1.26.5
- 4cdc2fc Update README
- b6e4fee feat: Implement transport layer components including buffer management, connection statistics, rate limiting, and UDP frame handling
- 0e83d0e feat(master): Implement state persistence and system information collection
- 64dd3f4 feat: Implement server-side tunnel handshake and connection pool management
- 8a19fbb feat: Implement client-side tunnel management with connection pooling and handshake
- 97f8771 feat: Implement protocol helpers and lifecycle management for tunnel connections
- 206a874 feat: implement CLI for NodePass tunnel with command parsing and TLS configuration
- a5bc37e chore: add .DS_Store to .gitignore
- 4e96e4a chore: update Go version to 1.26.4 and dependencies to latest stable releases
- f109974 docs: update README and add MCP reference documentation
-
v1.16.009 Mar 2026Release notes
Open source →Changelog
- 8c4c4ea chore: update contributing guidelines and enhance README with quick start examples
- 303e761 chore: update Docker and release workflows with latest action versions and permissions
- 2b827d8 chore: update Go version and dependencies to latest stable releases
- 80b6431 refactor: implement UDP frame read/write functions for improved data handling
- a87717f docs: add comprehensive CLI reference documentation with syntax and examples
- 15eb7b0 refactor: enhance command line parsing and error handling in core functionality
- 23f4d02 refactor: simplify main function by removing error handling and using run()
- 9a8921a Merge pull request #89 from NodePassProject/main
- a73fe7b refactor: remove unsupported architectures from build configuration
- 4bf4671 refactor: simplify TLS configuration by removing unnecessary parameters and ensuring proper usage throughout the codebase
- e8e9b71 fix: update release.yml
- f220add chore: update README.md
- 977e1b2 Merge pull request #88 from NodePassProject/main
- 9d1f60a chore: update repository references and copyright information to NodePassProject
- 7d9cf53 Merge pull request #87 from NodePassProject/main
- db108b0 chore: add reference to DeepWiki for AI-powered documentation in README files
- 5852516 chore: update dependencies for quic-go, crypto, net, sys, and text packages
- 49e104a fix: replace logger with fmt.Printf for API Key operations to enhance console output
- fb4db58 docs: update load balancing strategies to include optimal-latency option in API and configuration documentation
- 3939dd6 feat: implement best target probing based on latency for improved load balancing
- a931460 docs: expand load balancing strategies to include primary-backup option in API and configuration documentation
- 7f073e1 feat: add fallback mechanism to dialWithRotation function for improved fault tolerance
- d9868c2 docs: add load balancing strategy support in API and configuration documentation
- ed5fd0b feat: add load balancing strategy parameter to generateConfigURL function for clients and servers
- 0f6b868 feat: include load balancing strategy in client and server logging
- 49a89f7 feat: add load balancing strategy to Common struct and implement strategy selection in dialWithRotation
- 8b79809 Merge pull request #86 from NodePassProject/main
- c607cb7 feat: enhance TLS configuration by regenerating RAM cert with TLS 1.3 in tunnel handshake for improved security control
- 13ba323 chore: clarify licensing terms and usage restrictions in README files
- 6f50813 refactor: initialize verifyChan in Client and Server structs for TLS verification
- 269ca7a refactor: simplify TLS code checks and enhance TLS-1 certificate verification
- 0c932f8 Merge pull request #85 from NodePassProject/main
- 5271539 chore: update README files
- ec92179 refactor: rename certificate verification channel to improve clarity
- 7a44206 fix: add drain for write channel and log TLS certificate verification status
- 434e260 feat: implement write channel for asynchronous signal handling in Common struct with server and client initialization
- 72ab98d docs: update signaling protocol to use JSON format for improved clarity and structure
- e2e94d6 refactor: change signal channel type from string to Signal for better structure
- 899b68d feat: add certificate verification channel for TLS configurations in client and server
- 36307cb chore: update npws and quic-go dependencies to latest versions
- 1945500 Merge pull request #84 from NodePassProject/main
- e09b2bc refactor: return detected protocol and wrap net.Conn to preserve peeked data during protocol blocking
- 9a9a97d fix: improve block protocol detection logic in common package
- fc36a33 docs: add protocol blocking feature with detailed configuration options and examples
- 98272a7 feat: add block protocol parameter to client and server configuration URLs
- 2a7af5a feat: add block protocol logging to client and server run methods
- c73ac28 feat: add block protocol support and detection in common package
- ab94b97 docs: add Server Name Indication (SNI) support to configuration and API documentation
- afb1729 feat: add server name support in client configuration and logging
- de2ebf8 chore: update nph2 dependency to v1.0.4 in go.mod and go.sum
- 2c259db chore: update README to include HTTP/2 as a supported pooling transport method
- 5985295 docs: add HTTP/2 connection pool support and update related documentation
- dc3b66f feat: add support for HTTP/2 pool type in tunnel initialization and update related pool management
- 951c79b docs: add optional alias field to instance creation request in API documentation
- 64aa990 feat: add alias field to instance creation request and update OpenAPI spec
- e37c1a7 chore: update quic dependency to v1.0.14 and bump indirect dependencies
- fd68090 docs: restore NP_HANDSHAKE_TIMEOUT environment variable for extended handshake timeout
- 052e2c4 refactor: simplify Client and Server struct definitions and improve tunnel handshake logging
- 42d68a3 feat: refine TLS handling and enhance common struct with server details
- c89e968 chore: update npws dependency to v1.0.5
- 0dfe3cc feat: add HMAC-based authentication token generation and verification
- eecaf91 refactor: enhance tunnel handshake and connection pool initialization in client and server
- 1bc9b68 chore: update npws and quic dependencies to v1.0.4 and v1.0.13 respectively
- 5750a8f docs: remove NP_HANDSHAKE_TIMEOUT environment variable from configuration documentation
- e70f1df docs: update WebSocket pool documentation to emphasize TLS requirements and restrictions
- c78021b chore: update dependency versions for npws, pool, and quic in go.mod and go.sum
- aa0e126 refactor: update TLS logging for QUIC/WSS pool types in getTLSProtocol function
- ac3117f docs: update configuration documentation to reflect changes in connection pool type parameter
- 15b4c0c docs: refactor connection pool documentation and parameters
- f45adce chore: update README to reflect support for TCP, QUIC, and WebSocket in connection pooling
- f71d613 refactor: update server query parameters to use 'type' instead of 'quic' in generateConfigURL
- 2d36529 feat: replace quicMode with poolType and implement websocket pool related functions for client and server
- 472c180 refactor: rename quicMode to poolType and update related functions
- 8e298a1 refactor: update getTLSProtocol to use 'type' query parameter for QUIC pool handling
- 11101ee chore: add npws and websocket dependencies to go.mod and go.sum
- a09f137 Merge branch 'yosebyte:main' into main
- f2ac0a5 chore: update readme files
- 38ab3c8 chore: update quic-go dependency from v0.57.0 to v0.57.1
- 29ad1e6 refactor: standardize connection handling in tunnelHandshake for client and server
- c212de3 feat: add control connection upgrade mechanism for improved connection handling
- e765ef2 Merge pull request #82 from NodePassProject/main
- 1952a1f docs: remove redundant Smart DNS Resolution section from documentation
- 1cc5ee6 fix: append newline to client IP in tunnelHandshake for correct HTTP response formatting
- c8771e9 refactor: improve tunnelHandshake for concurrent connection handling and error management
- c9e4a69 docs: refactor DNS configuration and caching documentation
- cfbf2cc fix: update DNS parameter handling in generateConfigURL for client and server instances
- 0fb5ecc refactor: enhance Client and Server initialization with parsedURL for improved configuration
- 8023825 feat: implement DNS caching mechanism in Common struct for improved address resolution
- 4219a2f chore: remove unused dependency on github.com/NodePassProject/name
- 5f937db fix: change logging level from debug to info for data exchange in tcp related methods
- ebf73b8 fix: improve tunnel address retrieval in commonStart and tunnelHandshake methods
- 7ac82eb feat: enhance Common struct for tunnel and target address management
- 9377879 chore: update dependencies for NodePassProject/name, quic, and quic-go
- b67659e Merge pull request #81 from NodePassProject/main
- 400ec86 fix: ensure Go version is set correctly in release workflow
- 232ce90 chore: update GitHub Actions dependencies for Docker and release workflows
- 173b6bf docs: update project documentation for clarity and detail improvements
- 331fc53 fix: update golang.org/x/crypto dependency to v0.45.0
- 7a27c29 Merge pull request #80 from NodePassProject/main
- 63c36b8 docs: Enhance DNS configuration and support in NodePass
- dad313c feat: update default DNS settings and improve logging for client and server
- d6aa0ca feat: add DNS parameter handling in generateConfigURL for client and server instances
- c79c558 feat: include DNS information in client and server log messages for improved diagnostics
- 4dbb46f feat: add DNS resolver and caching support to enhance address resolution
- c12928c chore: add dependency for NodePassProject/name v1.0.0
- afe2e4d fix: update instance action conditions to improve instance control logic
- 3117748 chore: update readme.md
- a4ffb85 feat: add disable options for TCP and UDP loops in common loop and single control
- f2fd370 feat: enhance tunnel port conflict check to consider loopback and unspecified IPs
- 89e0dfe feat: add conflict check for tunnel port in target addresses to prevent potential infinite loops
- b60aa24 docs: add source IP control for outbound connections and update documentation
- 88a3c6f feat: add dialer IP configuration and fallback mechanism for client and server
- d5b587e chore: update readme.md
- 1165516 chore: update quic dependency to version 1.0.6 in go.mod and go.sum
- 3271d3e chore: correct phrasing for transport options in English and Chinese README files
- 3a8517a docs: update default UDP buffer size in configuration to improve performance
- f68627c fix: increase default UDP buffer size and ensure proper buffer release in commonUDPLoop
- 4c9aaa5 docs: update QUIC protocol support description to specify server-only applicability
- e93f635 chore: update quic dependency to version 1.0.5 in go.mod and go.sum
- a080187 chore: update quic dependency to version 1.0.4 in go.mod and go.sum
- f47152c docs: update documentation to reflect automatic QUIC configuration delivery to clients during handshake
- 72bee5e feat: update tunnel handshake to support QUIC mode and validate username in tunnel URL
- 7b7062f feat: enhance TLS handling with support for QUIC mode and streamlined log messages
- 0e3d20f chore: update quic dependency to version 1.0.3 in go.mod and go.sum
- 206937f chore: remove redundant connection pool description from README files
- 9d89e5f docs: add QUIC support documentation and troubleshooting guidelines
- 59f15a7 feat: add QUIC parameter to config URL generation for client and server instances
- eefb48a feat: implement QUIC mode support in client and server lifecycle management
- 6ea5e9c feat: add QUIC mode support and refactor transport pool interface
- fb42985 refactor: improve error messages in core functions
- 1dc865f chore: update dependencies for quic and related packages
- 673fb6a Merge pull request #77 from NodePassProject/main
- 0fadf91 refactor: simplify error handling in exit function
- bfee0b3 feat: add coreType field and update tunnel listener initialization logic
- 5139e3c Merge pull request #75 from NodePassProject/main
- 494b60b feat: implement TLS verification for incoming and outgoing pool connections on both sides
- 24588b4 refactor: improve instance shutdown process for graceful termination
- 9133f20 feat: add TLS certificate verification and fingerprint formatting in server and common modules
- 5c00aab feat: add a query parameter to control whether TCP functionality is disabled and update docs
- 1d718c9 refactor: remove the deprecated connection pool periodic cleanup function to ensure high availability
- f900d43 chore: update pool dependency to v1.0.49 in go.mod and go.sum
- 1263661 Merge pull request #73 from NodePassProject/main
- fb27430 docs: update documentation to remove pool connection reuse with enhanced udp protocol control
- 4e66cee feat: add a query parameter to control whether UDP functionality is disabled
- e7e9665 chore: update pool dependency to v1.0.48 in go.mod and go.sum
- 62be9c1 fix: reset instance status details when error happens
- 47aa615 chore: update pool dependency to v1.0.47 in go.mod and go.sum
- 5ecff85 chore: update pool dependency to v1.0.46 in go.mod and go.sum
- 80f51ac chore: update pool dependency to v1.0.45 in go.mod and go.sum
- 41fa727 chore: update pool dependency to v1.0.44 in go.mod and go.sum
- a059a34 chore: update pool dependency to v1.0.43 in go.mod and go.sum
- 7274289 chore: update pool dependency to v1.0.42 in go.mod and go.sum
- dd2b0b8 refactor: remove pool connection reuse logic from connection cleanup
- 6bb2d84 refactor: update connection retrieval methods in common TCP and common UDP
- 59f77d2 chore: update pool dependency to v1.0.41 in go.mod and go.sum
- 1fc4077 Merge pull request #72 from NodePassProject/main
- c90f983 refactor: remove hybridStart and improve error handling in start method
- 7fbe355 docs: add example for resource-constrained configuration with small connection pool
- 7bfd0dd Revert "docs: enhance documentation for STUN NAT traversal features and examples across all relevant markdown files"
- 785303e refactor: optimize context error handling in client and server run methods
- a80c1aa refactor: streamline context error handling in common control and loop functions
- 9be2928 refactor: replace time.After with time.Ticker for periodic tasks in healthCheck and startPeriodicTasks
- c307a2f feat: implement NAT mapping keep-alive mechanism in hybridStart function
- ad555c9 fix: refine error handling in UDP functions to ignore io.EOF errors
- 2107ccb fix: reset instance status to 'stopped' for non-API Key instances during state load
- 06beeba docs: enhance documentation for STUN NAT traversal features and examples across all relevant markdown files
- da92584 fix: update client start logic to handle hybrid mode with single control and improve tunnel listener initialization
- 15619b9 feat(exp): add NAT traversal mode to client for STUN discovery and connection forwarding
- 2823361 fix: update periodic cleanup and restart intervals to use ReloadInterval for consistency
- fac0dad fix: reset instance metrics on stop to ensure accurate state management
- 205fa29 fix: refine CPU usage calculation in getLinuxSysInfo by removing unnecessary CPU count dependency
- d1d8290 Merge pull request #70 from NodePassProject/main
- 73e75cd fix: update error detection in InstanceLogWriter to handle server and client errors
- cbcb8d9 feat: enhance Meta structure in handlePatchInstance to include Peer and Tags validation
- 1d41d2d chore: update README and README_zh
- e533ff1 feat: remove checkpoint event logging in common and add automatic recovery for instances in error state
- 7d8e250 docs: add comprehensive instructions for NodePass AI Coding Agent, covering project overview, architecture, configuration, and development workflow
- 7033e54 fix: initialize Meta field with tags mapping in Run method for api key instance
- f2ab83b fix: initialize tags mapping for instances without tags
- ea5c397 docs: update peer metadata structure for consistency in API documentation
- c7fd650 refactor: reorder Peer struct fields and update validation in handlePatchInstance
- bda2beb docs: enhance peer metadata structure with service type and UUID format for service ID
- 8163358 feat: add service type to Peer struct and update validation in handlePatchInstance
- 01345d2 docs: enhance instance metadata management with peer information and tagging support
- 9fd025e feat: update Instance struct to include metadata and enhance tag handling
- d9be26d feat: add Master ID handling and update API Key instance management
- bcc56db feat: add alias handling for API Key instances and persist changes
- e34865a feat: add reset offsets for traffic statistics in Instance struct and update stat calculation logics
- ea7eada fix: add delay after auto-starting instance to prevent race conditions
- 0c0dc86 refactor: update logging to use getTargetAddrsString for improved clarity
- 2d65c89 refactor: update target address handling for improved load balancing and fault tolerance
- 97b3aee docs: reduce handshake and dialing timeout values for improved responsiveness
- bfbc8e8 fix: reduce timeout values for handshake and dialing to improve responsiveness
- 3090349 docs: add support for target address group to enable load balancing and high availability
- 5260464 feat: implement dialWithRotation for TCP and UDP connections to enhance fault tolerance and load balancing
- 98a5274 feat: support multiple target addresses for TCP and UDP connections with round-robin selection
- 9ae97e2 Merge pull request #69 from NodePassProject/main
- 13b319f refactor: optimize TCP slot management and connection cleanup in commonTCP functions
- e6bd888 fix: streamline UDP session cleanup and slot management in commonUDPLoop and commonUDPOnce
- 0d44f66 docs: add NP_UDP_READ_TIMEOUT configuration for UDP read operations
- f3eeab1 feat: add UDP read timeout configuration and update related handling in UDP loops and once
- 1d9a4ed Merge pull request #68 from NodePassProject/main
- 7427d6b docs: enhance data read timeout configuration to include connection reuse behavior
- d68c421 fix: ensure pool reuse is enabled when reading timeout is set from url cmd
- 6c02a6c chore: update conn dependency version to v1.0.16 in go.mod and go.sum
- 63c2f0a feat: add pool reuse flag and update read timeout handling in common loop and once
- 473e092 refactor: remove unused cancellation handling and close signal logic in common tcp udp loop and once
- 762fedf fix: set read deadline for remote connections in commonTCPLoop and commonTCPOnce
- f4049fa fix: update close signal handling in commonOnce
- 118a230 refactor: enhance cancellation handling in commonTCPLoop and commonTCPOnce using context
Note truncated.
-
v1.15.018 Jan 2026Nothing published for this version
-
v1.14.315 Jan 2026Nothing published for this version