feat(proj): init

context/2026-09-13_05-01-34_docker-xray-proxy.md

@@ -0,0 +1,21 @@
+# 2026-09-13 — SOCKS5-прокси для бота в Docker
+
+## Запрос
+Xray на хосте (10808/10809) слушает 127.0.0.1; контейнер его не видит. Нужно открыть listen на 0.0.0.0 и настроить aiogram через SOCKS5.
+
+## Сделано в репозитории
+- `aiohttp-socks` в `requirements.txt`
+- `PROXY_URL` в `bot/config.py` (опционально)
+- `bot/main.py` — `AiohttpSession(proxy=...)` (официальный API aiogram 3, без `_connector_init`)
+- `scripts/open_xray_listen.sh` — правки Xray на Ubuntu-хосте + restart
+- `docker-compose.yml` — `PROXY_URL=socks5://172.17.0.1:10808` по умолчанию
+- README: секция прокси + firewall warning
+
+## На хосте (вручную)
+```bash
+./scripts/open_xray_listen.sh
+# в .env: PROXY_URL=socks5://172.17.0.1:10808
+docker compose up -d --build
+```
+
+Конфиг `/usr/local/etc/xray/config.json` с этой Windows-машины недоступен — правки только через скрипт на Ubuntu.