if-proxy/README.md
boyko_vn 1f380e3d27 1
2026-10-30 23:37:28 +03:00

90 lines
8.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.