# imgbot-daemon

Контейнер для фонового демона проекта **imgbot** — headless-поиска и скачивания
картинок. Проект принадлежит агенту, живёт в `/home/tgclaude/imgbot` и правится
им же; здесь только среда запуска и присмотр.

## Зачем

До этого демон работал как голый процесс на хосте: запущен руками из
SSH-сессии, `PPID=1`, без юнита и restart-политики, `Linger=no` у пользователя.
Держался только потому, что в Ubuntu `KillUserProcesses=no` — **после
перезагрузки не поднялся бы**, и сигнала об этом не было бы. Плюс его 15%
ядра не были ничем ограничены и не были видны мониторингу.

Контейнер даёт: автозапуск и `restart: unless-stopped`, потолки CPU/памяти,
видимость в cAdvisor (а значит и в Grafana), и снимает костыль с руками
распакованными библиотеками chromium.

## Что тут НЕ запускается и почему

Два других процесса проекта — `imgbot-mcp-http` (порт 8765) и
`imgbot-file-server` (8766) — оставлены вне контейнеров сознательно:

- оба **жёстко забиндены в коде на `172.22.0.1`** — адрес шлюза docker-сети
  `openclaw_default`. В контейнере такой адрес не поднять, а сама привязка
  ломается при пересоздании сети;
- до них всё равно никто не дотягивается: единственный живой потребитель —
  агент в контейнере `claude-channels` — находится в другой docker-сети и
  ходит через SSH, а не по HTTP (проверено: `curl` из контейнера даёт `000`);
- `imgbot-mcp-http` вообще без авторизации, в отличие от file-server с его
  Bearer-токеном.

Их имеет смысл контейнеризовать только вместе с правкой бинда на `0.0.0.0`
(две строки: `HOST` в `file_server.py`, `host=` в `mcp_server.py`) и уже в
общей docker-сети с `claude-channels` — тогда агент получит MCP по токену
вместо SSH. Это решение владельца кода, не инфраструктуры.

## Запуск

Собрать и поднять (на сервере каталог стека — `~/imgbot-daemon/`, чтобы не путался с самим проектом в `~tgclaude/imgbot`):

    docker compose build
    # погасить запущенный руками демон, иначе будет два и двойной analyze:
    pkill -u tgclaude -f imgbot-daemon
    docker compose up -d
    docker logs -f imgbot-daemon

Проверка, что расписание пошло: в `~tgclaude/imgbot-data/daemon.log` должны
появляться строки `_job_analyze ... executed successfully` каждые 5 минут и
`_job_refresh` каждые 30.

## Откат

    docker compose down
    # и вернуть как было, из-под tgclaude:
    cd ~/imgbot && .venv/bin/imgbot-daemon >> ~/imgbot-data/daemon.log 2>&1 &

## Важно для владельца кода

Перезапуск демона теперь `docker restart imgbot-daemon`, а не `pkill` плюс
ручной старт. Если запустить процесс руками при живом контейнере — получатся
два демона, которые будут конкурировать за одни и те же строки SQLite
(в проекте это уже случалось с cron без `flock` и выглядело как зависание).

Правки кода пересборки не требуют: исходники монтируются read-only, достаточно
`docker restart imgbot-daemon`. Пересобирать нужно только при изменении
зависимостей в `pyproject.toml` — и тогда версию playwright в `Dockerfile`
надо держать совпадающей с `uv.lock`, иначе разойдётся ревизия браузера.