Bug: SOCKS5 UDP association packet queue overflows under BitTorrent load (hardcoded buffer=2)

[blixten85]

Is this urgent?

No

Description

After the UDP SOCKS5 support was added in #3353, the logs are flooded with:

WARN [socks5] failed routing UDP packet: association packet queue full

This happens constantly when using Gluetun's SOCKS5 proxy with qBittorrent under normal load (hundreds of active torrents doing periodic UDP tracker announces).

Root cause

In internal/socks5/udp_router.go, the per-association channel buffer is hardcoded to 2:

const udpPacketChannelBuffer = 2
association := udpAssociation{
    ...
    packetCh: make(chan *bytes.Buffer, udpPacketChannelBuffer),
}

When the UDP router receives packets faster than forwardClientPackets can drain the channel, packets are dropped with "association packet queue full". With many active torrents each sending periodic UDP tracker announces, this overflows constantly.

Expected behavior

UDP packets should not be silently dropped under normal BitTorrent load. The buffer size should be larger, or backpressure/congestion handling should be implemented.

Suggested fix

Increase udpPacketChannelBuffer to a more appropriate value (e.g. 64 or 256), or make it configurable via the existing SOCKS5 settings.

Environment

• Gluetun image: qmcgaw/gluetun:latest (built after feat(socks5): UDP proxying #3353 merge, 2026-06-11)
• VPN provider: ProtonVPN WireGuard
• Client: qBittorrent (LSIO) with ~477 active torrents
• Network mode: Gluetun on Docker bridge, qBittorrent on host network connecting via localhost:1080

Logs

WARN [socks5] failed routing UDP packet: association packet queue full
WARN [socks5] failed routing UDP packet: association packet queue full
WARN [socks5] failed routing UDP packet: association packet queue full

(repeated dozens of times per minute)

[github-actions]

@qdm12 is more or less the only maintainer of this project and works on it in his free time.
Please:

• do not ask for updates, be patient
• 👍 the issue to show your support instead of commenting
  @qdm12 usually checks issues at least once a week, if this is a new urgent bug,
  revert to an older tagged container image

[github-actions]

Closed issues are NOT monitored, so commenting here will likely NOT be seen.
If you think this is still unresolved and have more information to bring, please either
re-open this issue or create another issue.

❤️😠 temporarily help the Gluetun community and fight the AI slop scam website gluetun[dot]com by setting BORINGPOLL_GLUETUNCOM=on on the latest image.
See the option in the wiki for more information

This is an automated comment setup because @qdm12 is the sole maintainer of this project
which became too popular to monitor closed issues.