# Доменная маршрутизация OpenAI на сервере

Установлено 6 ноября 2026 после отдельного разрешения владельца на системные
DNS/сетевые дополнения. Существующие Xray/Codex, их credentials и proxy
environment сохранены. Это отдельная серверная служба, а не функция KILN API.

## Область действия

Только `chatgpt.com`, `openai.com` и их поддомены направляются через уже
работающий HTTP proxy `127.0.0.1:1081`. `api.openai.com` подходит;
`notopenai.com`, `openai.com.example.org` — нет. Браузерный TLS остаётся
сквозным, сертификаты не подменяются, ключи/токены не переносятся в новый config.

Используется sing-box **1.14.4**, официальный release SagerNet. Архив сверён
с SHA-256 из GitHub release asset metadata. Бинарный файл и публичные сведения
о версии/checksum: `/opt/openai-domain-router/releases/1.14.4/`.
`current` указывает на эту версию; автоматического обновления не добавлено.

Схема:

1. Запросы DNS к прежнему resolver `192.168.35.1:53` перенаправляются в
   отдельную службу, включая запросы действующих Docker bridge-сетей.
   `/etc/resolv.conf`, dnsmasq, настройки Docker и приложений не меняются.
2. Для разрешённых имён A/AAAA возвращаются адреса из выделенных диапазонов
   `198.19.0.0/16` и `fd74:6f70:656e::/48`, TTL 60 секунд.
   HTTPS/SVCB IP hints для этих имён подавляются, чтобы не обойти маршрутизацию.
3. TCP только к этим диапазонам попадает в отдельные transparent listeners,
   восстанавливается имя из FakeIP mapping и выполняется CONNECT через
   существующий proxy. По реальным общим IP Cloudflare правила не создаются.
4. Прочие DNS-запросы идут прежнему resolver напрямую; новый DNS-кэш отключён.
   TCP/UDP прочих ресурсов не перенаправляется этой службой. Имеющиеся
   proxy-настройки отдельных приложений продолжают работать как раньше.
5. Mapping FakeIP хранится в `/var/lib/openai-domain-router/fakeip.db` и
   сохраняется при перезапуске. Это технический кэш, не БД сайта или бота.

Документация используемых возможностей: [FakeIP](https://sing-box.sagernet.org/configuration/dns/server/fakeip/),
[persistent mapping](https://sing-box.sagernet.org/configuration/experimental/cache-file/),
[transparent redirect](https://sing-box.sagernet.org/configuration/inbound/redirect/).

## Установленные дополнения

| Путь | Назначение |
| --- | --- |
| `/etc/openai-domain-router/config.json` | Шаблон отдельной службы, без секретов |
| `/etc/systemd/system/openai-domain-router.service` | Автозапуск и cleanup |
| `/usr/local/libexec/openai-domain-router-build` | Сборка runtime config с адресами bridge-интерфейсов |
| `/usr/local/libexec/openai-domain-router-network` | Применение/удаление только собственных сетевых дополнений |
| `/run/openai-domain-router/` | Runtime config и список текущих bridge-интерфейсов; root-owned |
| `/var/lib/openai-domain-router/` | Persistent FakeIP mapping; доступ только сервисному пользователю |
| `/opt/openai-domain-router/current/sing-box` | Проверенный бинарный файл |

Добавлен отдельный системный пользователь `openai-router` (на этом сервере
UID 997), shell nologin. Сам proxy-процесс работает без root. Только сетевые
pre/post commands службы выполняются от root.

Сетевые дополнения — ровно две собственные nftables tables:
`inet openai_domain_dns` и `inet openai_domain_traffic`, плюс IPv6 route
`fd74:6f70:656e::/48 dev lo proto 186 metric 42760`. Default route и policy
rules не изменяются. Legacy iptables/ip6tables и Docker chains не меняются.
Новые порты 15353/18083/18084 закрыты guard-правилами от остальных интерфейсов.

DNS UDP listeners привязаны к loopback и отдельным адресам текущих Docker
bridges: wildcard UDP listener после NAT выбирал неправильный source для
ответа. Служебный UID исключён из DNS-перенаправления, чтобы не возникал цикл.
При появлении новой Docker bridge-сети перезапустить только эту службу, чтобы
добавить её адрес/listener; новые неизвестные bridge-сети автоматически не
захватываются DNS-правилами.

Перед первой установкой сохранены контрольные суммы прежних конфигураций,
firewall/routes/rules в закрытый каталог
`/var/backups/openai-domain-router/20261106-141214/`. Секретные значения не
выводились. Оригинальный Xray config не переписывался и Xray не перезапускался.
При переносе на другой сервер нельзя применять эти файлы вслепую: сверить
resolver, порты, отсутствие конфликтов диапазонов, версию и системные права.

## Проверки и результаты

```bash
python3 -m unittest discover -s deploy/openai-domain-router -p 'test_*.py' -v
/opt/openai-domain-router/current/sing-box check -c /run/openai-domain-router/config.json
python3 deploy/openai-domain-router/network.py render --uid 997 | nft --check -f -
systemd-analyze verify /etc/systemd/system/openai-domain-router.service
python3 deploy/openai-domain-router/smoke.py --http
```

Результат: 11 unit tests; конфигурация, nft syntax и systemd unit — passed.
DNS smoke: 20 положительных A/AAAA UDP/TCP проверок, 10 отрицательных
suffix-проверок и 10 проверок подавления IP hints — passed.

Публичные HTTPS GET без proxy environment, с `--noproxy '*'`:

- installer `chatgpt.com/codex/install.sh`, включая redirect: 200;
- `api.openai.com/v1/models`, без ключа: ожидаемый 401, также через IPv6;
- `openai.com/`: 403 от HTTP-сервера, TLS/маршрутизация исправны; антибот-защита
  сайта не обходится этой настройкой;
- контрольный `example.com/`: 200 по настоящему внешнему IP, без FakeIP;
- отдельный пользователь nobody, пустое environment: installer 200;
- Node в контейнере сайта: целевой DNS через FakeIP, контрольный DNS настоящий,
  GET installer получает штатный 302;
- Python в контейнере бота с пустым ProxyHandler: API получает ожидаемый 401.
  Python GET installer после redirect получил HTTP 403; это upstream ответ,
  не ошибка DNS/TLS/CONNECT. Curl к installer получил 200.

Проверены DNS-only rollback с продолжением запросов по ранее выданному FakeIP,
полная остановка/очистка собственных tables/route и повторный запуск с тем же
mapping. Во время первой пробы был кратковременный сбой DNS (~1 минуты);
откачен, причина bindings исправлена и покрыта regression test. Выявлена также
особенность nft 1.0.6: table comments отсутствуют в JSON; ownership теперь
проверяется в native output. Проверка numeric route protocol устранила
проблему распознавания собственного IPv6 route при cleanup.

Старые конфигурации совпадают по SHA-256; старые firewall/rules/default routes
сохранены. Новая служба active/enabled, NRestarts=0 после финального запуска;
потребление памяти на проверке около 11–15 MiB. Контейнеры сайта/бота и Xray
не перезапускались. `/health` бота и `/api/info` сайта возвращают 200.
Оплаты, заказы СБИС и задания курьера для этих проверок не создавались.

## Управление и откат

```bash
systemctl status openai-domain-router.service
systemctl restart openai-domain-router.service
nft list table inet openai_domain_dns
nft list table inet openai_domain_traffic
```

Перезапускается только новая служба. Сохранённый mapping не удалять:
программы могли закэшировать выданные адреса.

Мягкий откат:

```bash
/usr/local/libexec/openai-domain-router-network dns-off
systemd-run --unit=openai-domain-router-graceful-stop --on-active=70s \
  /bin/systemctl disable --now openai-domain-router.service
```

Сначала восстанавливается обычный DNS, ранее выданные адреса обслуживаются
ещё 70 секунд, затем собственные правила удаляются. Программы, игнорирующие
DNS TTL, могут потребовать сброса их собственного кэша/переподключения.

При аварии допустим немедленный `systemctl disable --now openai-domain-router.service`:
ExecStopPost удаляет только две отмеченные собственные таблицы и собственный
IPv6 route. При неизвестном ownership операция прекращается, чужие таблицы
не удаляются. Не использовать `nft flush ruleset` или восстановление всего
старого iptables snapshot поверх работающего Docker.

Повторное включение: `systemctl enable --now openai-domain-router.service`.
Шаблон/root файлы сохраняются при остановке; удаление user/files не требуется.

## Границы

- Работает для процессов хоста и проверенных контейнеров, использующих
  текущий системный DNS. Собственный DoH/DoT, другой DNS-server, закреплённый
  настоящий IP или старый DNS cache могут обойти механизм. Их настройки
  принудительно не менялись. Подменять общие CDN IP запрещено.
- Существующий HTTP proxy обслуживает TCP. UDP к FakeIP отклоняется, чтобы
  клиенты с QUIC/HTTP3 fallback переходили на HTTPS/TCP. UDP-only приложения
  через этот proxy не поддерживаются; прочий UDP не затронут.
- Если системный resolver изменится, согласованно обновить только новый
  DNS config и адрес перехвата в network.py, предварительно проверив diff.
- Это не исправление MCP codex_tui: для localhost у уже запущенного Codex
  daemon по-прежнему важны NO_PROXY/no_proxy. См. `docs/CODEX_OPERATIONS.md`.
- Реальная перезагрузка всего хоста не проводилась; unit проверен и включён
  в boot target. Restart/stop/start самой службы проверены фактически.

Ветки/SHA приложений остались прежними: сайт `feat/menu-postgres-yandex-feed`
@ `7ba9ea3cc368b6decd23b5095ece885c08bad696`, бот `main`
@ `2782fb037a143df72f24186185f0ce8ce97f3bf2`. Контракт/API, БД, migrations и
env приложений не менялись. Commit/push и deployment приложений не выполнялись.
