2026-11-16 10:53:17 +03:00
1
2026-11-16 10:53:17 +03:00
1
2026-10-30 23:37:28 +03:00
1
2026-10-30 23:37:28 +03:00
1
2026-10-30 23:37:28 +03:00
1
2026-10-30 23:37:28 +03:00
1
2026-10-30 23:37:28 +03:00
1
2026-10-30 23:37:28 +03:00
1
2026-11-16 10:53:17 +03:00
1
2026-10-30 23:37:28 +03:00

PAC Router

Локальный маршрутизатор для браузеров и обычных программ. Он отдает PAC-файл и одновременно работает как HTTP-прокси. Не заменяет Amnezia/3proxy: выбранные домены отправляются на уже работающий HTTP-прокси 3proxy, остальные идут напрямую.

Быстрый старт (Windows PowerShell)

  1. Установите uv и Python 3.11+.

  2. В каталоге проекта выполните:

    uv sync
    uv run start
    
  3. Откройте http://127.0.0.1:25666/

  4. Укажите адрес и порт HTTP-прокси 3proxy, например 127.0.0.1:3128.

  5. Добавьте example.com и *.example.com как два отдельных правила, если нужны корневой домен и все поддомены.

  6. Firefox → Настройки → Основные → Настройки сети → Настроить → URL автоматической настройки прокси: http://127.0.0.1:25666/proxy.pac.

  7. Для 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.

Description
No description provided
Readme 114 KiB
Languages
Python 82.5%
HTML 16.6%
Dockerfile 0.9%