# PAC Router Локальный маршрутизатор для браузеров и обычных программ. Он отдает PAC-файл и одновременно работает как HTTP-прокси. **Не заменяет Amnezia/3proxy**: выбранные домены отправляются на уже работающий HTTP-прокси 3proxy, остальные идут напрямую. ## Быстрый старт (Windows PowerShell) 1. Установите [uv](https://docs.astral.sh/uv/getting-started/installation/) и Python 3.11+. 2. В каталоге проекта выполните: ```powershell 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; трафик не расшифровывается. Например: ```powershell 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]`. В консоли для каждого нового соединения выводятся домен, маршрут и совпавшее правило: ```text 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-доменам. ## Проверка ```powershell 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 Соберите и запустите сервис: ```powershell 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.