mirror of
https://github.com/3proxy/3proxy.git
synced 2026-11-22 23:59:41 +08:00
Transparent moved to main code (TransparentPlugin removed), BSD pf support added
(cherry picked from commit 88b3225bdf)
This commit is contained in:
1 parent
69c6ddc8c4
commit
da66016c7f
19 files changed
+972
-191
No files matched your search
@@ -37,6 +37,7 @@
|
||||
<li><a href="#SSLPLUGIN">Как настроить TLS/SSL (https прокси, mTLS)</a></li>
|
||||
<li><a href="#CERTIFICATES">Как создать CA и сертификаты для SSL</a></li>
|
||||
<li><a href="#PCRE">Как использовать PCRE-фильтрацию (регулярные выражения)</a></li>
|
||||
<li><a href="#TRANSPARENT">Как сделать транспарентный прокси</a></li>
|
||||
<li><a href="#AUTH">Как ограничить доступ к службе</a>
|
||||
<li><a href="#USERS">Как создать список пользователей</a>
|
||||
<li><a href="#ACL">Как ограничить доступ пользователей к ресурсам</a>
|
||||
@@ -992,6 +993,176 @@ openssl verify -x509_strict -CAfile ca.crt server.crt
|
||||
openssl verify -x509_strict -CAfile ca.crt client.crt
|
||||
</pre>
|
||||
|
||||
|
||||
<li><a name="TRANSPARENT"><i>Как сделать транспарентный прокси</i></a>
|
||||
<p>
|
||||
Транспарентный прокси обслуживает клиентов, которые не настроены на работу
|
||||
через прокси. Пакетный фильтр перенаправляет их соединения на 3proxy, а команда
|
||||
<b>transparent</b> указывает сервису брать адрес назначения у фильтра, а не из
|
||||
запроса. Всё остальное работает как обычно: правила доступа, родительские
|
||||
прокси, ограничения и логирование видят настоящий адрес назначения. Работает в
|
||||
Linux и BSD. С версии 1.0.1 встроено в бинарник, раньше это был отдельный
|
||||
TransparentPlugin, и строка <b>plugin</b> больше не нужна.
|
||||
</p>
|
||||
<p>
|
||||
Команда даёт и адрес, и порт назначения, поэтому сервис обслуживает всё, что
|
||||
на него перенаправлено, а не один порт с одним адресом назначения.
|
||||
</p>
|
||||
<p>
|
||||
Без неё сервис берёт адрес откуда-то ещё: HTTP-прокси - из заголовка
|
||||
<b>Host</b>, порт-маппер - из своей конфигурации. Именно получение адреса от
|
||||
фильтра позволяет работать с остальными протоколами и делает адрес
|
||||
достоверным, а не заявленным клиентом.
|
||||
</p>
|
||||
<p>
|
||||
Нагляднее всего это с <b>tlspr</b>. Без перенаправления трафика (или без
|
||||
резолва имён на него через DNS) на него вообще ничего не попадёт. С
|
||||
перенаправлением он получает и имя из TLS handshake, и адрес назначения -
|
||||
именно это позволяет писать правила доступа по именам хостов: имя из handshake
|
||||
проверяется в ACL, а соединение идёт на тот адрес, куда шёл клиент. Без адреса
|
||||
пришлось бы резолвить имя самостоятельно, то есть делать ещё один запрос и
|
||||
получать ещё один ответ.
|
||||
</p>
|
||||
<p>
|
||||
Конфигурация для веб- и TLS-трафика:
|
||||
</p><pre>
|
||||
log /var/log/3proxy.log D
|
||||
auth iponly
|
||||
allow *
|
||||
|
||||
# для сервисов ниже адрес назначения берётся из перенаправления
|
||||
transparent
|
||||
|
||||
# обычный веб-трафик, перенаправленный сюда с порта 80
|
||||
proxy -p3129 -e192.0.2.10
|
||||
|
||||
# TLS, перенаправленный сюда с порта 443: без этого у tlspr было бы только
|
||||
# имя из handshake, а так есть и адрес
|
||||
tlspr -p3143 -e192.0.2.10
|
||||
|
||||
notransparent
|
||||
</pre>
|
||||
<p>
|
||||
<b>-e</b> задаёт сервисам собственный адрес для исходящих соединений. Именно
|
||||
этот адрес исключается в правилах перенаправления, и это исключение не даёт
|
||||
соединениям самого прокси попасть обратно в него. Без исключения соединение,
|
||||
которое 3proxy устанавливает к серверу назначения, попадает под то же правило,
|
||||
возвращается в 3proxy, и трафик зацикливается. Можно вместо этого запускать
|
||||
3proxy под отдельной учётной записью и исключать её - так лучше, если у машины
|
||||
один адрес.
|
||||
</p>
|
||||
|
||||
<p><b>Linux, iptables</b>. Для транзитного трафика:
|
||||
</p><pre>
|
||||
iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 80 -j REDIRECT --to-ports 3129
|
||||
iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 443 -j REDIRECT --to-ports 3143
|
||||
</pre>
|
||||
<p>
|
||||
Трафик самой машины проходит через цепочку OUTPUT, где соединения прокси нужно
|
||||
исключить:
|
||||
</p><pre>
|
||||
# по адресу, с которого сервисы устанавливают соединения
|
||||
iptables -t nat -A OUTPUT -p tcp --dport 80 ! -s 192.0.2.10 -j REDIRECT --to-ports 3129
|
||||
|
||||
# либо по учётной записи, под которой работает 3proxy
|
||||
iptables -t nat -A OUTPUT -p tcp --dport 80 -m owner ! --uid-owner proxy3 \
|
||||
-j REDIRECT --to-ports 3129
|
||||
</pre>
|
||||
|
||||
<p><b>Linux, nftables</b> (Debian 11+, Ubuntu 22.04+, RHEL 8+, Fedora, Arch):
|
||||
</p><pre>
|
||||
table ip proxy3 {
|
||||
chain prerouting {
|
||||
type nat hook prerouting priority dstnat; policy accept;
|
||||
iif "eth0" tcp dport 80 redirect to :3129
|
||||
iif "eth0" tcp dport 443 redirect to :3143
|
||||
}
|
||||
|
||||
chain output {
|
||||
type nat hook output priority dstnat; policy accept;
|
||||
meta skuid != "proxy3" tcp dport 80 redirect to :3129
|
||||
meta skuid != "proxy3" tcp dport 443 redirect to :3143
|
||||
}
|
||||
}
|
||||
</pre>
|
||||
<p>
|
||||
Загружается через <b>nft -f</b>, сохраняется в <b>/etc/nftables.conf</b>
|
||||
(Debian, Ubuntu) или <b>/etc/sysconfig/nftables.conf</b> (RHEL, Fedora). Имя
|
||||
таблицы не может начинаться с цифры, поэтому таблица называется не 3proxy.
|
||||
</p>
|
||||
|
||||
<p><b>Linux, firewalld</b> (RHEL, CentOS Stream, Fedora, openSUSE):
|
||||
</p><pre>
|
||||
firewall-cmd --permanent --zone=internal --add-forward-port=port=80:proto=tcp:toport=3129
|
||||
firewall-cmd --permanent --zone=internal --add-forward-port=port=443:proto=tcp:toport=3143
|
||||
firewall-cmd --reload
|
||||
</pre>
|
||||
<p>
|
||||
Исключение для трафика самого прокси в таком виде не задаётся, для него нужно
|
||||
прямое правило:
|
||||
</p><pre>
|
||||
firewall-cmd --permanent --direct --add-rule ipv4 nat OUTPUT 0 \
|
||||
-p tcp --dport 80 -m owner ! --uid-owner proxy3 -j REDIRECT --to-ports 3129
|
||||
firewall-cmd --reload
|
||||
</pre>
|
||||
|
||||
<p><b>Linux, ufw</b> (Ubuntu, Debian). В ufw нет команды для перенаправления,
|
||||
правила добавляются в <b>/etc/ufw/before.rules</b> перед блоком <b>*filter</b>:
|
||||
</p><pre>
|
||||
*nat
|
||||
:PREROUTING ACCEPT [0:0]
|
||||
-A PREROUTING -i eth0 -p tcp --dport 80 -j REDIRECT --to-ports 3129
|
||||
-A PREROUTING -i eth0 -p tcp --dport 443 -j REDIRECT --to-ports 3143
|
||||
COMMIT
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
В Linux 3proxy спрашивает у ядра, куда шло соединение. В BSD он спрашивает у pf,
|
||||
который хранит исходный адрес назначения в таблице состояний, через
|
||||
<b>/dev/pf</b> - поэтому работают правила <b>rdr</b>, и 3proxy должен иметь
|
||||
доступ к этому устройству. Если перенаправление оставляет адрес на самом сокете,
|
||||
используется он: так делают OpenBSD <b>divert-to</b> и FreeBSD <b>ipfw fwd</b>.
|
||||
</p>
|
||||
<p>
|
||||
Механизм выбирается автоматически, а команда <b>transparent</b> принимает
|
||||
аргумент для случаев, когда его надо зафиксировать: <b>auto</b> (по умолчанию),
|
||||
<b>netfilter</b>, <b>pf</b> или <b>socket</b> для чтения адреса с сокета. Режим,
|
||||
которого нет в сборке, отвергается, поэтому конфигурация, написанная для другой
|
||||
платформы, не запустится вместо того, чтобы молча делать что-то другое.
|
||||
</p>
|
||||
|
||||
<p><b>FreeBSD, NetBSD, OpenBSD, pf</b>. Перенаправление в <b>/etc/pf.conf</b> с
|
||||
исключением адреса, с которого соединяется прокси:
|
||||
</p><pre>
|
||||
rdr pass on em0 inet proto tcp from ! 192.0.2.10 to any port 80 -> 127.0.0.1 port 3129
|
||||
rdr pass on em0 inet proto tcp from ! 192.0.2.10 to any port 443 -> 127.0.0.1 port 3143
|
||||
</pre>
|
||||
<p>
|
||||
Загружается через <b>pfctl -f /etc/pf.conf</b>. 3proxy ищет адрес назначения в
|
||||
таблице состояний pf, поэтому ему нужен доступ на чтение к <b>/dev/pf</b>: либо
|
||||
запуск от root, либо права на устройство для его учётной записи.
|
||||
</p>
|
||||
|
||||
<p><b>OpenBSD, divert-to</b> - альтернатива, оставляющая адрес на сокете, доступ
|
||||
к <b>/dev/pf</b> при этом не нужен:
|
||||
</p><pre>
|
||||
pass in on em0 inet proto tcp to any port 80 divert-to 127.0.0.1 port 3129
|
||||
pass in on em0 inet proto tcp to any port 443 divert-to 127.0.0.1 port 3143
|
||||
</pre>
|
||||
|
||||
<p><b>FreeBSD, ipfw</b>. <b>fwd</b> доставляет соединение локально, не переписывая
|
||||
его, и адрес тоже остаётся на сокете:
|
||||
</p><pre>
|
||||
ipfw add fwd 127.0.0.1,3129 tcp from any to any 80 in recv em0
|
||||
ipfw add fwd 127.0.0.1,3143 tcp from any to any 443 in recv em0
|
||||
</pre>
|
||||
|
||||
<p><b>macOS</b>: <b>/dev/pf</b> есть, но заголовочных файлов для него нет,
|
||||
поэтому в сборке под macOS нет обращения к pf, а ни <b>divert-to</b>, ни ipfw в
|
||||
macOS нет. Транспарентное проксирование там неприменимо, хотя команды в сборке
|
||||
присутствуют.
|
||||
</p>
|
||||
|
||||
<li><a name="PCRE"><i>Как использовать PCRE-фильтрацию (регулярные выражения)</i></a>
|
||||
<p>
|
||||
Начиная с версии 0.9.7 фильтрация PCRE встроена в 3proxy при компиляции с поддержкой
|
||||
|
||||
Reference in new issue
Block a user