90 lines
8.0 KiB
Markdown
90 lines
8.0 KiB
Markdown
# 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.
|