新增：

• 新增 noudp 参数，用于禁用 UDP 功能。

优化：

• 连接池改为并发创建，提升连接池化速度。
• 弃用池连接复用功能，简化连接管理逻辑。
• 实现 read 超时控制与池连接复用解耦。

修复：

• 实例在错误状态下未重置运行指标的问题。

兼容：

• 涉及到连接池重构，双端版本需同步更新。

文档：

• 更新仓库内置文档，增加对新变动的说明。

优化：

• 上下文取消逻辑统一处理，核心循环退出更稳定
• 隧道资源初始化更严谨，错误反馈更及时
• UDP 错误日志过滤 EOF 正常关闭情况，减少噪声
• 主控定时任务合并，逻辑更清晰，调度更可靠
• 实例停止时运行指标完整重置，状态展示更准确

修复：

• 主控指标中多核心 CPU 占用统计与实际占用不符的问题
• 主控启动时部分未及时变更状态的实例没有自启动的问题
• 主控定时任务过短导致异常实例重复重启的问题

新增：

• 新增 NodePass 基础高可用功能，通过轮询方式将负载均衡与故障转移相结合。新增目标地址组概念，将原单一目标地址进行扩展，命令格式方面，目标地址以 , 相分隔，核心将自动开启高可用，同时生效于单端或双端模式的出口位置。
• 新增 meta 字段，包含 peer 和 tags 以扩展实例的元数据信息，有助于解决双端模式下，分布式部署的实例割裂问题。
• 新增主控 ID 的生成和持久化逻辑，以备前端应用取用。

优化：

• 实例级别的内部错误（例如端口冲突等）可顺利传递至主控，用以标记实例状态，加强外部感知。
• 缩短 tcp 和 udp 以及实例握手的超时时间，进一步提升故障转移的相应速度。

修复：

• 修复主控从持久化文件拉取实例时，高负载状态下的竞态问题，避免实例拉取失败。
• 修复实例流量信息重置后继续陡增的重置不完整问题。

文档：

• 以上新增内容均已在内置文档 /docs 中有所体现，请更新前阅读。

新增：

• 环境变量 NP_UDP_READ_TIMEOUT 控制 UDP 读取超时，默认值 30s 兼顾绝大部分 UDP 场景。

修复：

• 修复了 UDP 双端模式下入口 udps 指标只增不减的问题。
• 修复了 UDP 双端模式下出口 udps 指标增长过快的问题。

重构：

• 重构三处 TCP 连接数管理逻辑，保证提前返回并降低潜在的资源占用。

文档：

• 新增环境变量在文档中的配置部分有所体现，可根据使用场景微调。

新增：

• 新增池连接复用开关，通过 read 参数配置。read=0 时默认无超时、不回收连接，设置正值可启用连接超时及池连接复用。

优化：

• 连接池及连接管理库底层逻辑重构，显著提升稳定性，解决边缘场景下的断流问题。

重构：

• 更新池连接创建逻辑及连接 ID 传递规则，实现两端行为一致性，提升兼容性。

修复：

• 修复部分连接池管理中的异常断流和资源回收不及时问题。

兼容：

• 池连接逻辑更新后，需确保两端主控版本保持一致，避免因规则变更导致兼容性问题。

文档：

• 移除标签管理相关说明，相关逻辑将整合至后续版本中。
• 补充 read 参数行为及管理说明，明确其在连接池中的作用。
• 更新相关环境变量默认值说明，保持与实际推荐配置一致。

新增：

• API 新增标签设置可选项，有助于前端更好的进行跨平台信息主控持久化。
• 新增 TCP 缓冲区池，贯穿单端、双端底层链路，极大降低了内存占用。

优化：

• 信号通道全面升级，新增 base64 加解密，完全消除了隧道 URL 解析错误问题。

重构：

• 精简部分重用代码，继续精简主函数，增强错误处理显示。
• 底层 pool 和 conn 库的少量重构，增强内存管理，降低占用。

修复：

• 修复一些 UDP 缓冲区池和 pool 库中缓冲区池失效问题。

兼容：

• 鉴于信号通道的升级，双端模式将不再向下兼容，建议尽快升级两侧主控。

文档：

• 对 API 新增标签功能，和配置字段加入文档，更新系统信息指标变更说明。

优化：

• 调整 slot 默认值至 65536 ，默认不再限制 TCP 和 UDP 连接数。

重构：

• 精简部分代码，重构错误处理信息，支持更清晰的错误追溯。

修复：

• 修复 UDP 流量统计功能失效问题，单双端全面支持流量统计和限速。

文档：

• 添加了 slot 参数具体用法和示例。

新增：

• 新增运行模式控制功能（mode 参数），支持服务端、客户端内置模式的精确控制。
• 新增数据读取超时控制（read 参数），提供更精细的连接超时管理策略。
• 新增带宽速率限制功能（rate 参数），支持流量控制和带宽管理，防止网络拥塞。
• 新增最大连接限制功能（slot 参数），防止资源过载，提升系统稳定性。
• 新增 PROXY 协议支持（proxy 参数），增强与负载均衡器的兼容性。
• 新增主控基础探针功能、更多监控字段、连接状态主动探测功能，提升系统可观测性。

优化：

• 大幅度优化配置系统架构，引入高级参数控制，提升系统灵活性。
• 改进连接处理和资源管理机制，显著提升整体性能表现。
• 优化环境变量文档说明，明确连接池和并发调优的适用范围。
• 改进错误处理机制，增强系统可靠性和故障恢复能力。
• 优化日志记录和监控功能，提升运维效率。

重构：

• 核心代码架构全面重构，现代化代码结构，提升可维护性。
• 配置表和最佳实践文档重构，明确各参数在不同模式下的适用性。
• 系统监控和实例生命周期管理流程优化，提升运行稳定性。
• 重构连接池和并发处理逻辑，提升高并发场景下的性能表现。

修复：

• 修复配置参数默认值设置不当的问题，优化系统默认行为。
• 修复连接管理中的资源泄漏问题，增强内存使用效率。
• 修复文档中配置示例与实际参数不匹配的问题。
• 修复部分边缘情况下的连接异常问题，提升系统稳定性。

兼容：

• 双端握手机制升级，不支持旧版本混用，确保连接安全性。
• 更新 Go 版本和核心依赖至 1.25 版本，增强性能与兼容性。
• 所有新增参数均向下兼容，现有配置无需强制修改。
• 配置格式标准化，确保跨版本使用的一致性。

文档：

• 全面更新中英文档，详细说明新增功能特性。
• 新增高级参数配置说明，包含超时控制、速率限制等详细使用指南。
• 增强配置表格和最佳实践文档，提供更清晰的使用指导。
• 同步更新所有语言版本的文档，确保信息一致性和准确性。

修复：

• 紧急修复一处 v1.5.0 新增的潜在缺陷，避免 CPU 占用增长远超预期。

优化：

• 大幅压降 SSE 中 update 的推送频率，与健康检查结果合并推送。
• 为各循环位置增设、调整 50ms 短延迟以增强并发稳定性能。
• 在入口和出口处理 go 协程中增设主上下文检测，避免资源泄露。
• 优化了一些日志的显示，统一日志风格，降低代码复杂度。

新增：

• 重磅推出“池连接回收”功能，支持连接回收复用，提升池管理效率，大幅度提升双端模式性能。
• 新增双端模式下 UDP 会话管理，已完全支持各类 UDP 传输，包括不限于 QUIC over TCP/TLS。
• 新增日志等级 none 与 event，支持更灵活的日志输出策略，适配高并发与无日志场景。
• 新增“反触发”健康检查机制，带有端内延迟显示、池连接数显示等功能，与 API 同步推送。
• 服务端现在可以通过设置自己侧的 max 参数来对最大连接数进行限制，客户端设置保持不变。

优化：

• 大幅度压降 Event 日志数量，目前通过 API 方式广播至前端的此类日志已被过滤。
• TCP 单连接流程中资源释放逻辑优化，避免目标连接未关闭导致的资源泄漏。
• 优化连接池错误状态在健康检查中的重置逻辑，防止误报。
• TCP 与 UDP 数据传输日志输出增强，细化数据交换、连接关闭等阶段日志。
• 健康检查日志输出结构重构，加入连接池状态信息，便于定位问题。
• 日志等级初始化函数增强，支持更严谨的参数验证与默认值。
• 精简 client/server 启动流程代码，提升可读性与可维护性。
• 改进 UDP 会话关闭时的错误处理机制，降低极端场景下的崩溃风险。
• 增强目标连接失败后的处理策略，引入延迟避免过快重试。

重构：

• 调整错误通道初始化逻辑，提升调度流程一致性。
• 核心控制流与健康检查结构重构，引入互斥锁保护写操作，防止并发写入冲突。
• 实例的结构体增强，加入健康检查统计字段，并改进日志解析逻辑。
• UDP 会话管理流程优化，提升并发稳定性与错误可追踪性。

修复：

• 修复连接池容量默认值设置过高的问题，将默认最大容量为 1024，可按需调整。
• 修复持久化文件保存调用过程中阻塞主流程的问题，现已异步执行。
• 修复因连接池容量错误配置导致的资源泄漏与崩溃问题。
• 修复 TCP/UDP 通道读取超时控制未生效的问题。
• 增强读取失败时的错误日志输出，便于追踪。

兼容：

• 当前 v1.5.0 与 v1.4.4 及以下版本的服务端/客户端不相互兼容，两侧需同时更新。
• 同步更新 conn 和 pool 依赖版本至最新（如 v1.0.18、v1.0.3 等），增强性能与兼容性。
• 所有连接池行为调整均已同步更新至文档，确保使用者行为一致。

文档：

• 更新 README.md 与 README_zh.md 文件，提升配置项、使用说明与功能描述的准确性。
• 新增日志等级、连接池容量、URL 查询参数范围等说明文档，补充最佳实践内容。
• 调整 NodePass 项目 Logo 与文档结构，提升整体可读性与视觉一致性。