Files
buryan-infra/ops/media/METADATA-PROXY.md
T
buryan-agent 3ea974ce95 Метаданные через VPS + граф контента: франшизы, экранизации, серии
Главное: медиатека не могла пополняться. Radarr ходит за метаданными на
api.radarr.video, а с домашнего IP этот адрес отдаёт 403 Cloudflare; с VPS —
200. На VPS уже был tinyproxy, разрешающий Tailscale-сеть. Поднят проброс
socat на узле (192.168.1.10:8888 → 100.64.0.2:8888), Radarr и Sonarr
переключены на него. После этого добавлены 5 фильмов с коллекциями.

Второе: граф контента. content_graph.py строит карточки и связи: фильм →
коллекция, книга → автор, книга → серия, книга ↔ фильм (экранизация),
коллекция ↔ книжная серия (общая вселенная). На реальных данных: 21
карточка, 19 связей, включая Matrix-трилогию, Dune-дилогию, экранизацию
Dune и связь коллекции Dune с книжной серией.

Добавлен GET /links в ядро (сводка по типам и список), блок «Связи
контента» в Медиа Хабе, расписание 04:45.

Ловушки: PUT /api/v3/config/host требует allowedHosts (и не принимает «*»);
прокси на Tailscale-адрес из контейнера не работает — нужен проброс; успех
сохранения отдаёт 202.
2026-10-20 10:12:54 +03:00

56 lines
2.4 KiB
Markdown
Raw 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.
# Почему не добавлялся контент: метаданные через VPS
## Симптом
Radarr отвечал `500: Site responded with browser content instead of api data`
на любую попытку добавить фильм. Библиотеки были пусты, добавлять было
нечего.
## Диагноз
* `api.themoviedb.org` с узла отвечает **401 «Invalid API key»** — сеть есть,
это нормальный ответ без ключа.
* Radarr использует не TMDB напрямую, а **SkyHook**: `api.radarr.video`.
* С домашнего IP `api.radarr.video` отдаёт **403** со страницей Cloudflare
(«Performance & security by Cloudflare»).
* **С VPS тот же запрос отдаёт 200.**
То есть блокировка по IP: домашний адрес в чёрном списке Cloudflare,
адрес VPS — нет.
## Решение
На VPS уже работал `tinyproxy` (порт 8888), но он разрешал только
`100.64.0.0/10` и `172.16.0.0/12` — то есть Tailscale-сеть.
1. Проверка: `curl -x http://100.64.0.2:8888 https://api.radarr.video/...`
→ **200**.
2. Контейнеры Radarr/Sonarr не видят Tailscale-адрес, поэтому на узле
поднят проброс: `socat TCP-LISTEN:8888,fork TCP:100.64.0.2:8888`
(служба `tmdb-proxy`).
3. В Radarr и Sonarr включён прокси `192.168.1.10:8888` с обходом
`localhost,127.0.0.1` — чтобы локальные вызовы шли напрямую.
## Результат
```
curl -x http://192.168.1.10:8888 https://api.radarr.video/... → 200
radarr: прокси=True 192.168.1.10:8888
sonarr: прокси=True 192.168.1.10:8888
✅ The Matrix
✅ The Matrix Reloaded
✅ The Matrix Revolutions
✅ Dune
✅ Dune: Part Two
```
## Ловушки
* `PUT /api/v3/config/host` требует `allowedHosts` — без него 400
«Allowed Hosts is required when Authentication Required is not Enabled»,
а значение `*` не принимается: нужен список хостов через запятую.
* Прокси на Tailscale-адрес из контейнера не работает — нужен проброс
через IP узла.
* Успешное сохранение возвращает **202**, а не 200 — это нормально.