From 382e7915f0dddbc6a9862889b33c2859168652d1 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
<41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 26 Aug 2026 11:35:17 +0000
Subject: [PATCH] Update HTML documentation from man pages
(cherry picked from commit 9c74a9c2b387386fb8d97e003548b8ef0f303f78)
---
doc/html/man5/3proxy.cfg.5.html | 51 +++++++++++++++++++++++++++++++++
1 file changed, 51 insertions(+)
diff --git a/doc/html/man5/3proxy.cfg.5.html b/doc/html/man5/3proxy.cfg.5.html
index a716fae..f84c17f 100644
--- a/doc/html/man5/3proxy.cfg.5.html
+++ b/doc/html/man5/3proxy.cfg.5.html
@@ -1115,6 +1115,57 @@ users "test4:CR:$3$salt$G47yV9w...."
Note: double quotes are required because the password
contains a $ sign.
transparent
+[auto|netfilter|pf|socket]
+Take the destination of a connection, both address and port,
+from the packet filter that redirected it, instead of from
+the request. It applies to services declared after it, and
+notransparent turns it off again for the services
+after that. Built into the binary since 1.0.1, and
+previously the separate TransparentPlugin.
+On Linux the kernel is asked, so iptables or
+nftables redirection is enough. On the BSDs pf is
+asked through /dev/pf, which 3proxy must be able to
+read, so rdr rules work; a redirection that leaves
+the destination on the socket is used where there is one, as
+divert-to on OpenBSD and ipfw fwd on FreeBSD
+do. macOS ships no header for pf and has neither of those,
+so the commands exist in a macOS build but cannot be used.
+
+The mechanism is chosen automatically. The optional argument
+pins it for an installation that has more than one:
+auto is the default, netfilter asks the Linux
+kernel, pf looks the connection up in the packet
+filter, and socket reads the address off the socket.
+A mode the build has no code for is refused rather than
+ignored.
+A connection that reaches a socket mode service
+without having been redirected is refused: its destination
+is the address the service listens on, and using that would
+send the service to itself.
+A redirected connection carries no destination of its own,
+so without this the service uses whatever it would use
+otherwise: the Host header for an HTTP request, or
+the address a port mapper was configured with. tlspr
+receives nothing at all unless traffic is redirected to it
+or the clients resolve names to it, and with a redirection
+it has the address as well as the name from the handshake,
+which is what allows access rules to be written with host
+names. With it, every service reaches the address the client
+was trying to reach, and access rules, parents, limits and
+logging apply to it as usual.
+The redirection rules must not match the connections the
+proxy itself makes to those destinations, or the traffic
+returns to the proxy and loops. Give the service an outgoing
+address with -e and exclude that address in the
+rules, or run 3proxy as its own user and exclude that user.
+See the TRANSPARENT PROXYING section of the
+documentation for rules per platform.
+notransparent
+Stop taking the destination from the packet filter for the
+services declared after it.
flush
empty the active access list. The access list must be