The proxy read only the first request per client connection and then tunneled all subsequent bytes to that first request's upstream. Browsers reuse HTTP/1.1 connections to the proxy across hosts, so any later request was forwarded raw to the first upstream server, which answered with its default vhost — pages showed wrong content (e.g. a Caddy listing from another host under http://192.168.0.1/) until refresh. Plain HTTP now runs a keep-alive loop with a routing decision, fresh upstream connection and correct response framing (Content-Length, chunked, 1xx, HEAD, 204/304, EOF) per request. CONNECT is unchanged.
PAC Router
Локальный маршрутизатор для браузеров и обычных программ. Он отдает PAC-файл и одновременно работает как HTTP-прокси. Не заменяет Amnezia/3proxy: выбранные домены отправляются на уже работающий HTTP-прокси 3proxy, остальные идут напрямую.
Быстрый старт (Windows PowerShell)
-
Установите uv и Python 3.11+.
-
В каталоге проекта выполните:
uv sync uv run start -
Откройте http://127.0.0.1:25666/
-
Укажите адрес и порт HTTP-прокси 3proxy, например
127.0.0.1:3128. -
Добавьте
example.comи*.example.comкак два отдельных правила, если нужны корневой домен и все поддомены. -
Firefox → Настройки → Основные → Настройки сети → Настроить → URL автоматической настройки прокси:
http://127.0.0.1:25666/proxy.pac. -
Для Chromium-браузеров можно использовать
--proxy-pac-url=http://127.0.0.1:25666/proxy.pacв отдельном ярлыке, либо системную PAC-настройку Windows (если браузер её использует).
Использование в программах без PAC
Укажите в программе HTTP-прокси 127.0.0.1:25667 для протоколов HTTP и HTTPS. HTTPS поддерживается стандартным методом CONNECT; трафик не расшифровывается. Например:
curl.exe -x http://127.0.0.1:25667 https://api.ipify.org
$env:HTTP_PROXY = "http://127.0.0.1:25667"
$env:HTTPS_PROXY = "http://127.0.0.1:25667"
Программа должна поддерживать HTTP-прокси. Это не SOCKS-прокси и не прозрачный перехват всего системного трафика. Адреса панели и прокси задаются в config.toml в секциях [server] и [proxy_server].
В консоли для каждого нового соединения выводятся домен, маршрут и совпавшее правило:
INFO: Routing CONNECT api.example.com:443 -> DIRECT (default)
INFO: Routing CONNECT sub.example.org:443 -> PROXY 127.0.0.1:3128 (rule *.example.org)
Если нужный домен прошёл как DIRECT (default), скопируйте его в список правил с маршрутом PROXY. Учтите, что программа может обращаться сразу к нескольким API/CDN-доменам.
Проверка
curl.exe -x http://127.0.0.1:3128 https://api.ipify.org
curl.exe --noproxy "*" https://api.ipify.org
Сравните IP-адреса: они должны различаться, если ваш туннель настроен как задумано. Затем проверьте http://127.0.0.1:25666/proxy.pac и тестировщик доменов в UI. curl не применяет PAC автоматически, поэтому для него используйте локальный маршрутизирующий прокси на порту 25667.
Тесты: uv sync --group dev и uv run pytest -q.
Docker Compose
Соберите и запустите сервис:
docker compose up -d --build
docker compose logs -f pac-router
Панель будет доступна на http://127.0.0.1:25666, а маршрутизирующий прокси — на 127.0.0.1:25667. Локальный файл ./router.db подключается в контейнер как /data/router.db, поэтому контейнер и локальный запуск используют одни настройки.
Контейнер подключён к сети с именем pac-router-network. Измените networks.proxy-network.name в compose.yaml, если upstream-прокси уже находится в другой сети, и подключите оба контейнера к одной сети. После этого укажите DNS-имя upstream-контейнера и его внутренний порт в панели. Для прокси, запущенного непосредственно на хосте, в Compose задан host.docker.internal:25345.
Порты публикуются только на loopback хоста. Переменная PAC_ALLOW_NON_LOOPBACK=1 разрешает контейнеру слушать интерфейс Docker; не публикуйте панель или прокси на общедоступном интерфейсе без дополнительной защиты.
Безопасность и ограничения
- Приложение слушает только loopback. Не публикуйте порт UI в сеть: в панели нет авторизации.
- Маршрутизирующий прокси также слушает только loopback и не требует авторизации.
- Не включайте HTTP-сервер панели в Docker-порт с
0.0.0.0и не открывайте его через публичный reverse proxy. - PAC не расшифровывает HTTPS и не перехватывает содержимое страниц.
- Правило
PROXYвозвращает толькоPROXY host:port, без резервногоDIRECT. При недоступности 3proxy такие запросы должны завершиться ошибкой, а не переключаться на прямое соединение. *.example.comсоответствует поддоменам, но неexample.com.- Браузеры кэшируют PAC; при изменении правил может понадобиться перезагрузка PAC/браузера.
- PAC применяется к приложениям, которые его поддерживают; не обеспечивает системную защиту от обхода прокси.
- HTTP/3, QUIC, DNS-over-HTTPS, WebRTC, расширения браузера и отдельные сетевые стеки могут иметь особенности маршрутизации. Проверяйте реальные соединения в логах 3proxy и браузера.
- Браузер может использовать PAC для HTTPS-сайтов через HTTP CONNECT на 3proxy. Это не HTTPS-соединение до прокси: для loopback это обычно приемлемо.
- Настройки хранятся в
router.dbрядом с проектом. Экспорт/импорт JSON доступен из UI. - IDN-домены вводите в ASCII/Punycode. URL, пути, regex и CIDR в правилах не поддерживаются.
- Встроенный тест проверяет совпадение правил, а не реальный сетевой маршрут.
- При конфликте правил точный домен приоритетнее маски, более длинная маска приоритетнее короткой.
- Никаких секретов/паролей прокси проект не хранит; предполагается уже работающий локальный 3proxy.
Адрес и порт панели
Редактируйте config.toml ([server] host и port), затем перезапустите uv run start. Не открывайте UI в сеть: аутентификации нет. Адрес и порт 3proxy задаются отдельно в UI и хранятся в SQLite.