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