v0.69.1

nats-io/nats-serverv0.69.1Jun 1, 2026by fatedier

AI Summary

Updates wire protocol handling for UDP-based proxy payloads to ensure consistency across v1 and v2 deployments.

Key Highlights

`transport.wireProtocol = "v2"` now applies to UDP-based proxy payloads
Improved SUDP compatibility during mixed protocol deployments
XTCP work connection NatHoleSid messages follow selected protocol

Breaking Changes

When enabling `transport.wireProtocol = "v2"` for SUDP, both proxy and visitor frpc instances must be upgraded

New Features

Consistent payload framing for UDP and SUDP based on selected wire protocol
Bridge payloads between v1/default and v2 SUDP clients

Full Release Notes

## Features

* `transport.wireProtocol = "v2"` now also applies to UDP-based proxy payloads, including ordinary UDP and SUDP, so their payload framing is consistent with the selected wire protocol.
* Improved SUDP compatibility during mixed `transport.wireProtocol` deployments, allowing frps to bridge payloads between v1/default and v2 SUDP clients.
* XTCP work connection `NatHoleSid` messages now follow the selected `transport.wireProtocol`.

## Compatibility Notes

* When enabling `transport.wireProtocol = "v2"` for SUDP, upgrade both the proxy and visitor frpc instances first, or keep them on `v1` until both sides are upgraded.