Commit as 0.9.9

CHANGELOG

@@ -1,28 +1,18 @@
-3proxy-0.9.8 Released August, 7 2026
+3proxy-0.9.9 Released August, 20 2026
 
-!! Fix: use-after-free on the ftp:// request path in HTTP proxy, a request buffer reallocation left a stale pointer; heap corruption, requires authenticated access
+! Fix: DNS replies are validated now: a reply from an address other than the nameserver the query was sent to, and a reply with a question section not matching the query, are dropped; both were accepted before
-!! Fix: buffer overflow in radsend() with an oversized request hostname; RADIUS is experimental, log radius or auth radius with fakeresolve is required to reach it
+! Fix: socket leak with SOCKSv5 UDP ASSOCIATE through a parent proxy, sockets were accumulated in CLOSE_WAIT state until descriptors ran out
-!! Fix: buffer overflow in smtpp when relaying AUTH LOGIN credentials to a server which offers AUTH PLAIN only; requires authorised access to smtpp
+! Fix: file descriptor leak in HTTP proxy on the ftp:// request path
-!! Fix: out-of-bounds read in tlspr on a malformed TLS ClientHello
+! Fix: crash with illegal instruction on some platforms (e.g. some musl based Linux builds), caused by a memcpy on overlapping buffers
-!! Fix: LDAP injection and unsafe counter file names in LdapPlugin; the plugin is unsupported and is not built with 3proxy
+! Fix: extip and ha (HAProxy PROXY protocol) parents are applied to SOCKSv5 UDP ASSOCIATE now
-!! Fix: password and hash comparison in strong authentication is constant-time now
+! Fix: only socks5 and socks5+ parents are tried for UDP ASSOCIATE, other parent types can not be used for UDP
-!! Fix: bounds validation and match/depth limits in pcre filters
+! Fix: udppm through a SOCKSv5 parent did not work
-+ imapp: IMAPv4 proxy added, supports LOGIN command, AUTH PLAIN and AUTH LOGIN
+! Fix: -Ne and -Ni options were never applied, the option letter was not parsed; -Ne is not applied to the UDP ASSOCIATE reply anymore, -Ni is applied to it
-+ STARTTLS support for smtpp, pop3p, imapp and tlspr, on both client and server side; -x option to disable
+! Fix: -4 / -6 handling for UDP in socks; a single UDP association can use both IPv4 and IPv6 destinations now
-+ wolfSSL is supported as an alternative TLS backend, WOLFSSL_CHECK=true selects it (wolfSSL must be built with --enable-opensslextra)
+! Fix: a datagram with a null destination address is dropped now
-+ Chunked Transfer-Encoding from client is supported by HTTP proxy
+! Fix: DNS over TCP: a reply which did not fit a single read was never processed
-+ dnspr: -F option added, fake resolve to redirect traffic
+! Documentation: "How to apply ACLs to UDP traffic" added to HOWTO; authentication cache, ACL and UDP notes added to "Optimizing 3proxy for High Load" and to security recommendations
-+ ucrt64 build support; static libraries support in Makefile.win
++ SOCKSv5 UDP: the destination of every datagram is authorized, so ACLs limiting the destination address, host name or port apply to UDP traffic now; the parent proxy and the external address are selected for the destination of the datagram and not for the UDP ASSOCIATE request
-+ minimal and busybox Docker images switched to musl + wolfSSL
++ socks: -U option to control what happens when the destination changes within an UDP association: log it, authorize it, both (default) or neither
-- splice() support is not built by default anymore, it is slower than the read/write path for most traffic; add -DWITHSPLICE to build it
++ -C option (for TCP services) to terminate the session as soon as any of the sides closes the connection; by default the session is kept until both sides close it (TCP half-close)
-! Fix: hashtable item was added with wrong index on table grow; with large username/password tables it could cause a single record to be missing
++ timeouts: LINGER value added (11th, default 5), used to deliver buffered data after one of the sides has closed its sending side and as SO_LINGER value on outgoing connections
-! Fix: race conditions; stack overflow on FreeBSD
-! Fix: generated certificates are X.509 v3 with basicConstraints CA:FALSE and extendedKeyUsage serverAuth, required by Apple TLS stack and by Chrome on macOS/iOS
-! Fix: dnspr was broken since udppm rewrite
-! Fix: short cleartext passwords failed authentication
-! Fix: parent negotiation after sending PROXY protocol header
-! Fix: maxchild dropped to 100 on config reload if not set explicitly
-! Fix: getrandom() is not used with glibc below 2.25
-! Fix: IPV6_BOUND_IF definition for legacy MacOS
-! Fix: cmake build, arm64 Docker build, Makefile.win with UCRT
-! Multiple minor bugfixes and code cleanup

CHANGELOG.rus

@@ -1,28 +1,18 @@
-3proxy-0.9.8 Вышел 7 Августа 2026
+3proxy-0.9.9 Вышел 20 Августа 2026
 
-!! Исправление: use-after-free на пути обработки запроса ftp:// в HTTP-прокси, перевыделение буфера запроса оставляло устаревший указатель; повреждение кучи, требуется аутентифицированный доступ
+! Исправление: ответы DNS теперь проверяются: ответ с адреса, отличного от адреса сервера имён, которому был отправлен запрос, а также ответ с секцией вопроса, не совпадающей с запросом, отбрасываются; ранее оба принимались
-!! Исправление: переполнение буфера в radsend() при слишком длинном имени хоста в запросе; RADIUS является экспериментальным, для достижения кода необходимы log radius или auth radius в сочетании с fakeresolve
+! Исправление: утечка сокетов при SOCKSv5 UDP ASSOCIATE через вышестоящий прокси, сокеты накапливались в состоянии CLOSE_WAIT до исчерпания дескрипторов
-!! Исправление: переполнение буфера в smtpp при передаче учётных данных AUTH LOGIN серверу, поддерживающему только AUTH PLAIN; требуется авторизованный доступ к smtpp
+! Исправление: утечка файловых дескрипторов в HTTP-прокси на пути обработки запроса ftp://
-!! Исправление: чтение за границами буфера в tlspr при некорректном TLS ClientHello
+! Исправление: аварийное завершение с недопустимой инструкцией на некоторых платформах (например, в некоторых сборках Linux на основе musl) из-за memcpy на перекрывающихся буферах
-!! Исправление: LDAP-инъекция и небезопасные имена файлов счётчиков в LdapPlugin; плагин не поддерживается и не собирается вместе с 3proxy
+! Исправление: родители типа extip и ha (HAProxy PROXY protocol) теперь применяются к SOCKSv5 UDP ASSOCIATE
-!! Исправление: сравнение паролей и хешей в strong-аутентификации теперь выполняется за постоянное время
+! Исправление: для UDP ASSOCIATE используются только родители socks5 и socks5+, остальные типы для UDP неприменимы
-!! Исправление: проверка границ и ограничения match/depth в pcre-фильтрах
+! Исправление: udppm через вышестоящий прокси SOCKSv5 не работал
-+ imapp: добавлен IMAPv4-прокси, поддерживаются команда LOGIN, AUTH PLAIN и AUTH LOGIN
+! Исправление: опции -Ne и -Ni никогда не применялись, буква опции не разбиралась; -Ne больше не применяется к ответу на UDP ASSOCIATE, -Ni применяется к нему
-+ Поддержка STARTTLS для smtpp, pop3p, imapp и tlspr, как со стороны клиента, так и со стороны сервера; опция -x для отключения
+! Исправление: обработка -4 / -6 для UDP в socks; одна UDP-ассоциация теперь может использовать адреса назначения и IPv4, и IPv6
-+ wolfSSL поддерживается как альтернативный TLS-бэкенд, выбирается через WOLFSSL_CHECK=true (wolfSSL должен быть собран с --enable-opensslextra)
+! Исправление: датаграмма с нулевым адресом назначения теперь отбрасывается
-+ HTTP-прокси поддерживает Transfer-Encoding: chunked от клиента
+! Исправление: DNS поверх TCP: ответ, не помещавшийся в одно чтение, никогда не обрабатывался
-+ dnspr: добавлена опция -F, фиктивное разрешение имён для перенаправления трафика
+! Документация: в HOWTO добавлен раздел "Как применять ACL к UDP-трафику"; в "Optimizing 3proxy for High Load" и в рекомендации по безопасности добавлены заметки о кэше аутентификации, ACL и UDP
-+ Поддержка сборки ucrt64; поддержка статических библиотек в Makefile.win
++ SOCKSv5 UDP: адрес назначения каждой датаграммы авторизуется, поэтому ACL, ограничивающие адрес назначения, имя хоста или порт, теперь применяются к UDP-трафику; вышестоящий прокси и внешний адрес выбираются для адреса назначения датаграммы, а не для запроса UDP ASSOCIATE
-+ Docker-образы minimal и busybox переведены на musl + wolfSSL
++ socks: опция -U для управления тем, что происходит при смене адреса назначения в рамках UDP-ассоциации: журналировать, авторизовать, и то и другое (по умолчанию) или ничего
-- Поддержка splice() больше не собирается по умолчанию, она медленнее пути read/write для большинства видов трафика; для сборки добавьте -DWITHSPLICE
++ Опция -C (для TCP-сервисов) завершает сессию, как только любая из сторон закрывает соединение; по умолчанию сессия сохраняется, пока соединение не закроют обе стороны (полузакрытие TCP)
-! Исправление: элемент хеш-таблицы добавлялся с неверным индексом при росте таблицы; на больших таблицах пользователей/паролей это могло приводить к отсутствию одной записи
++ timeouts: добавлено значение LINGER (11-е, по умолчанию 5), используется для доставки буферизованных данных после того, как одна из сторон закрыла свою передающую сторону, а также как значение SO_LINGER для исходящих соединений
-! Исправление: состояния гонки; переполнение стека во FreeBSD
-! Исправление: генерируемые сертификаты имеют формат X.509 v3 с basicConstraints CA:FALSE и extendedKeyUsage serverAuth, что требуется TLS-стеком Apple и Chrome в macOS/iOS
-! Исправление: dnspr был сломан со времён переписывания udppm
-! Исправление: короткие пароли в открытом виде не проходили аутентификацию
-! Исправление: согласование с родителем после отправки заголовка PROXY protocol
-! Исправление: maxchild сбрасывался в 100 при перезагрузке конфигурации, если не задан явно
-! Исправление: getrandom() не используется с glibc ниже 2.25
-! Исправление: определение IPV6_BOUND_IF для устаревших версий MacOS
-! Исправление: сборка cmake, сборка Docker для arm64, Makefile.win с UCRT
-! Множество мелких исправлений и очистка кода

RELEASE

@@ -1 +1 @@
-0.9.8
+0.9.9

debian/changelog

@@ -1,3 +1,9 @@
+3proxy (0.9.9-1) buster; urgency=medium
+
+  *3proxy 0.9.9 initial build
+
+ -- z3APA3A <3apa3a@3proxy.org>  Thu, 20 Aug 2026 18:29:37 +0300
+
 3proxy (0.9.8-1) buster; urgency=medium
 
   *3proxy 0.9.8 initial build

doc/changelog/0/9/9

@@ -0,0 +1,16 @@
+! Fix: DNS replies are validated now: a reply from an address other than the nameserver the query was sent to, and a reply with a question section not matching the query, are dropped; both were accepted before
+! Fix: socket leak with SOCKSv5 UDP ASSOCIATE through a parent proxy, sockets were accumulated in CLOSE_WAIT state until descriptors ran out
+! Fix: file descriptor leak in HTTP proxy on the ftp:// request path
+! Fix: crash with illegal instruction on some platforms (e.g. some musl based Linux builds), caused by a memcpy on overlapping buffers
+! Fix: extip and ha (HAProxy PROXY protocol) parents are applied to SOCKSv5 UDP ASSOCIATE now
+! Fix: only socks5 and socks5+ parents are tried for UDP ASSOCIATE, other parent types can not be used for UDP
+! Fix: udppm through a SOCKSv5 parent did not work
+! Fix: -Ne and -Ni options were never applied, the option letter was not parsed; -Ne is not applied to the UDP ASSOCIATE reply anymore, -Ni is applied to it
+! Fix: -4 / -6 handling for UDP in socks; a single UDP association can use both IPv4 and IPv6 destinations now
+! Fix: a datagram with a null destination address is dropped now
+! Fix: DNS over TCP: a reply which did not fit a single read was never processed
+! Documentation: "How to apply ACLs to UDP traffic" added to HOWTO; authentication cache, ACL and UDP notes added to "Optimizing 3proxy for High Load" and to security recommendations
++ SOCKSv5 UDP: the destination of every datagram is authorized, so ACLs limiting the destination address, host name or port apply to UDP traffic now; the parent proxy and the external address are selected for the destination of the datagram and not for the UDP ASSOCIATE request
++ socks: -U option to control what happens when the destination changes within an UDP association: log it, authorize it, both (default) or neither
++ -C option (for TCP services) to terminate the session as soon as any of the sides closes the connection; by default the session is kept until both sides close it (TCP half-close)
++ timeouts: LINGER value added (11th, default 5), used to deliver buffered data after one of the sides has closed its sending side and as SO_LINGER value on outgoing connections

doc/html/man5/3proxy.cfg.5.html

@@ -221,7 +221,30 @@ built by default and is disabled even when built, because
 current Linux does not implement SPLICE_F_MOVE, so no real
 zero-copy takes place and the read/write path is faster for
 most traffic. Rebuild with -DWITHSPLICE to make -s
-available, -s0 disables it explicitly. <br>
+available, -s0 disables it explicitly. <b><br>
+-C</b> <br>
+(for TCP services) a connection closed by any of the sides
+terminates the session, buffered data is delivered before
+the sockets are closed. By default the session is kept until
+both sides close the connection (TCP half-close). Half-close
+is required for the protocols where one of the sides closes
+its sending side and expects the answer, but it keeps the
+socket of the side which has already closed the connection
+in CLOSE_WAIT state. Use -C to close both sockets as soon as
+any of the sides closes the connection, -C1 to request the
+default behaviour explicitly. <b><br>
+-U</b><i>[MODE]</i> <br>
+(for socks) what to do when the destination changes within
+an UDP association: <b>1</b> - log it, <b>2</b> - authorize
+it, <b>3</b> - both, the default, <b>0</b> (same as bare
+<b>-U</b>) - neither. The destination of the first datagram
+is always authorized and logged. With <b>-U0</b> and
+<b>-U1</b> the destination is not authorized again, so ACLs
+limiting the destination only apply to the first destination
+of the association, and the parent proxy and the external
+address selected for it are kept for the whole association.
+Use <b>-U2</b> to keep the authorization and to drop the
+per-destination log records only. <br>
 (for dnspr) simple, do not use resolver and 3proxy cache,
 always use external DNS server. <br>
 (for udppm) singlepacket, expect only one packet from both
@@ -400,9 +423,9 @@ and %F as filename.</p>
 <i>&lt;BYTE_SHORT&gt; &lt;BYTE_LONG&gt; &lt;STRING_SHORT&gt;
 &lt;STRING_LONG&gt; &lt;CONNECTION_SHORT&gt;
 &lt;CONNECTION_LONG&gt; &lt;DNS&gt; &lt;CHAIN&gt;
-&lt;CONNECT&gt; &lt;CONNECTBACK&gt;</i> <br>
+&lt;CONNECT&gt; &lt;CONNECTBACK&gt; &lt;LINGER&gt;</i> <br>
 Sets timeout values, defaults 1, 5, 30, 60, 180, 1800, 15,
-60, 15, 5. <b><br>
+60, 15, 5, 5. <b><br>
 BYTE_SHORT</b> short timeout for single byte, is usually
 used for receiving single byte from stream. <b><br>
 BYTE_LONG</b> long timeout for single byte, is usually used
@@ -419,8 +442,13 @@ CONNECTION_LONG</b> inactivity timeout for long connection
 DNS</b> timeout for DNS request before requesting next
 server <b><br>
 CHAIN</b> timeout for reading data from chained connection
-<br>
+<b><br>
-default timeouts 1 5 30 60 180 1800 15 60 15 5</p>
+LINGER</b> timeout to deliver buffered data after one of the
+sides has closed its sending side, also used as SO_LINGER
+value on outgoing connections. Too small value may cause the
+tail of the data to be lost on slow connections, too large
+one delays release of the sockets. <br>
+default timeouts 1 5 30 60 180 1800 15 60 15 5 5</p>
 
 <p style="margin-left:6%; margin-top: 1em"><b>maxseg</b>
 <i>&lt;value&gt;</i> <br>
@@ -584,7 +612,15 @@ but the ACL authorization result is also cached and not
 re-evaluated on each request. Faster than <b>cache</b>, but
 ACL changes do not take effect for cached users until the
 cache entry expires. Use <b>cache</b> if ACLs may change
-during the cache lifetime. <b><br>
+during the cache lifetime. Because the ACL is not walked on
+a cache hit, no redirection is applied to a request served
+from the cache: it is sent directly instead of through the
+<b>parent</b> proxy of the matching ACL entry, with no error
+reported. Do not use <b>cacheacl</b> together with parent
+proxies, use <b>cache</b> instead. The only redirection type
+which survives is <b>extip</b>, and only if <b>ext</b> is a
+part of the <b>authcache</b> key, because the external
+address is then restored from the cache entry. <b><br>
 radius</b> - authentication with RADIUS. <br>
 Plugins may add additional authentication types.</p>
 
@@ -631,6 +667,19 @@ srvaddr</b> - cache by service (listener) address <b><br>
 srvport</b> - cache by service (listener) port <br>
 Multiple types can be combined (e.g.
 <b>ip,user,dstaddr,dstport</b>). <br>
+With <b>cacheacl</b> the ACL result is not re-evaluated on a
+cache hit, so every field the ACL limits must be a part of
+the cache key, otherwise the result cached for one request
+is applied to a different one: <b>user</b>/<b>pass</b> for
+the userlist, <b>ip</b> for the sourcelist,
+<b>dstaddr</b>/<b>dsthost</b> for the targetlist,
+<b>dstport</b> for the targetportlist and <b>dstoper</b> for
+the operationlist. It is especially important for SOCKSv5
+UDP traffic, where the destination of every datagram is
+authorized: without <b>dstaddr</b> and <b>dstport</b> in the
+key the result cached for one destination is applied to any
+other destination and the destination is not checked at all,
+see <b>allow</b>. <br>
 Use auth type <b>cache</b> (or <b>cacheacl</b>) for cached
 authentication</p>
 
@@ -699,8 +748,45 @@ week day numbers or periods, 0 or 7 means Sunday, 1 is
 Monday, 1-5 means Monday through Friday. <br>
 Timeperiodlists is a list of time periods in
 HH:MM:SS-HH:MM:SS format. For example,
-00:00:00-08:00:00,17:00:00-24:00:00 lists non-working
+00:00:00-08:00:00,17:00:00-24:00:00 lists non-working hours.
-hours.</p>
+<br>
+A SOCKSv5 UDP ASSOCIATE request carries no destination, the
+destination of every datagram is taken from the datagram
+itself. 3proxy authorizes the destination of every datagram,
+so ACLs limiting the destination address, the destination
+host name or the destination port do apply to UDP traffic,
+unless the <b>-U</b> option of the <b>socks</b> service says
+otherwise. <br>
+ACLs are only checked for the datagrams sent by the client.
+A datagram received on the association is relayed to the
+client without an ACL check: with a parent proxy only the
+datagrams from the parent are accepted, an association
+without a parent accepts a datagram from any source. The
+source reported to the client is the actual source of the
+datagram. The address in the log record is the destination
+the client sent the datagrams to, the source of the
+datagrams received on the association is not logged. <br>
+A client may use a single association to reach many
+destinations. An ACL entry which limits the destination
+silently drops the datagrams to every other destination, so
+limiting the destination of UDP traffic can break such
+clients in a way which is hard to diagnose. Limit it only
+when it is really required. <br>
+Bandwidth limiters (<b>bandlimin</b>, <b>bandlimout</b>) and
+traffic counters (<b>countin</b>, <b>countout</b>) which
+limit the destination are selected when the destination is
+authorized, so within an UDP association they are selected
+for the destination of the first datagram and are not
+re-selected for every following destination. They can not be
+applied per destination to the incoming UDP traffic at all,
+because an incoming datagram is not matched against any
+destination. <br>
+Only <b>socks5</b> and <b>socks5+</b> parents can be used
+for UDP. Because every new destination is authorized, use
+<b>authcache</b>, especially with &acute;strong&acute;,
+RADIUS or plugin authentication: <b>cacheacl</b> with the
+destination in the cache key if no parent proxy is used,
+<b>cache</b> otherwise, see <b>cacheacl</b>.</p>
 
 <p style="margin-left:6%; margin-top: 1em"><b>parent</b>
 <i>&lt;weight&gt; &lt;type&gt; &lt;ip&gt; &lt;port&gt;

scripts/rh/3proxy.spec

@@ -1,5 +1,5 @@
 Name:           3proxy
-Version:        0.9.8
+Version:        0.9.9
 Release:        1%{?dist}
 Summary:        3proxy tiny proxy server
 License:        GPL/LGPL/Apache/BSD

src/version.h

@@ -1,14 +1,14 @@
 #ifndef VERSION
-#define VERSION "3proxy-0.9.8"
+#define VERSION "3proxy-0.9.9"
 #endif
 #ifndef BUILDDATE
 #define BUILDDATE ""
 #endif
 #define MAJOR3PROXY 0
 #define SUBMAJOR3PROXY 9
-#define MINOR3PROXY 8
+#define MINOR3PROXY 9
 #define SUBMINOR3PROXY 0
-#define RELEASE3PROXY "3proxy-0.9.8(" BUILDDATE ")\0"
+#define RELEASE3PROXY "3proxy-0.9.9(" BUILDDATE ")\0"
 #ifndef YEAR3PROXY
 #define YEAR3PROXY "2026"
 #endif