Files
obsidian-vault/family/how-to/lampac-torrents.md
T

153 lines
7.0 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.
# Torrents в Lampa — как оно работает и как чинить
**Обновлено:** 2026-09-22
**Связано:** [[personal/tech/lampac-torrserver]], [[personal/tech/lampac-deployment]], [[family/how-to/tv-lampac-plugin]]
**Статус:** ✅ работает. Приёмка Alex: «Во! теперь появились торренты. запустил F1..»
---
## TL;DR
```
Пункт «Торренты» пуст / 500 / 503
→ проверь PidTor.redapi = http://jac.red (НЕ локальный!)
→ очисти cache/fdb/
→ docker restart lampac
```
**Одна причина большинства поломок:** `redapi` указывает на локальный JacRed, который отдаёт формат **без поля `info`** → PidTor падает → 500/503.
---
## Архитектура
```
Lampa (ТВ) → «Торренты» → PidTor (модуль lampac)
↓ redapi
jac.red (ВНЕШНИЙ, 144.31.3.10)
↓ MagnetUri + info{}
TorrServer (встроен в lampac, порт 9085 внутр.)
↓
качает на HDD Кра́кена
```
🔴 **Поиск раздач идёт на ВНЕШНИЙ `jac.red`.** TorrServer только качает. Локальный JacRed есть, но **несовместим по формату**.
### Что нужно в `config-module/init.conf`
```json
"PidTor": {
"enable": true,
"redapi": "http://jac.red",
"min_sid": 15
}
```
⚠️ Файл именно `config-module/init.conf`. Правки в `config/init.conf` **не применяются и не дают ошибки** — просто ничего не меняется.
---
## Диагностика по коду ответа
| Код | Время | Значение | Что делать |
|---|---|---|---|
| **503** | 0.001–0.002s + `X-Invoke-Cache: HIT` | Ответ **из кэша**. Реальная причина скрыта | Очистить `cache/fdb/` |
| **500** | 0.1–1s | Честная ошибка. Обычно NPE на `info` | Смотреть `redapi` |
| **200** | — | Работает | — |
🔴 **503 = кэш, 500 = реальная ошибка.** Кэш `extend: 2700` = 45 минут, переживает `docker restart` (лежит на диске в `cache/fdb/`). Заголовок `X-Invoke-Cache: HIT` + время ~0.0015s — верный признак.
---
## 🔴 Главная ловушка: два разных JacRed
```
ВНЕШНИЙ jac.red — поля ответа:
[..., 'ffprobe', 'info', 'languages'] ← info ЕСТЬ
info = {"quality":480, "voices":["Дубляж"],
"sizeName":"2.02 GB", "relasted":2025}
ЛОКАЛЬНЫЙ JacRed (127.0.0.1:9118) — поля ответа:
['Category','Details','MagnetUri','Peers','PublishDate',
'Seeders','Size','Title','Tracker']
↑ info НЕТ → NPE
```
**PidTor падает здесь** (`PidTor/Controller.cs:97`):
```csharp
string mediainfo = torrent.info.sizeName ?? string.Empty;
// ^^^^^^^^^^^^^^ info == null → NullReferenceException → HTTP 500
```
Локальный JacRed **быстрее** (0.12s против 0.35s), поэтому соблазн переключить есть. **Не переключать.** Скорость не стоит поломки.
---
## Проверка работоспособности
### 1. PidTor по фильму (то, чем ходит клиент)
```
эндпоинт: http://192.168.1.14:9118/lite/pidtor?title=<Название>&year=<Год>
ожидаем: HTTP 200, непустой ответ
```
Проверять **тем же набором параметров**, что посылает клиент — ключ кэша включает `title:original_title:year:language:serial`. `F1` без года → 200, с годом → другой ключ.
### 2. Прямой источник (JacRed)
```
{PidTor.redapi}/api/v2.0/indexers/all/results?title=<Название>&year=<Год>
```
⚠️ Именно маршрут `/api/v2.0/indexers/all/results` — **тот, которым ходит PidTor**. `/api/v1.0/torrents` тоже работает, но это другой эндпоинт; проверка через него ничего не доказывает.
### 3. Список раздач TorrServer
```bash
curl -s -X POST http://127.0.0.1:9118/ts/torrents \
-H 'Content-Type: application/json' -d '{"action":"list"}'
```
🔴 **Только такой вызов.** `-d '[]'`, `-d '{}'`, без тела → **400**. `GET /ts/torrents` → **404**. Порт 9085 снаружи недоступен, только `/ts/` через 9118.
### 4. Приёмка
**Запустить фильм в плеере.** «API отвечает 200» ≠ «работает». Приёмка только в UI.
---
## Питфоллы
1. 🔴 **503 — это кэш, а не ошибка.** Сначала очистить `cache/fdb/`, потом делать выводы. Иначе час diagnostic по закэшированному отказу.
2. 🔴 **`enabled: false` у всех 86 модулей — это НОРМА.** Служебное поле (расписание). Смотреть только `enable`.
3. 🔴 **Лог lampac не показывает исключения** PidTor — `docker logs` пуст. Читать исходник (`Controller.cs`, `Model.cs`).
4. 🔴 **`docker exec lampac python3` не работает** — python3 нет в образе. Парсить конфиги скриптом снаружи через `docker cp`.
5. 🔴 **Конфиг — в `config-module/init.conf`**, не в `config/init.conf`.
6. 🔴 **Кириллица в inline-ssh командах → BLOCKED** (tirith `confusable_text`). Только скриптом-файлом.
7. 🔴 **Порт 9085 наружу закрыт** — работать через `/ts/` на 9118.
---
## Урок
Единственная причина поломки — **поменял рабочий параметр по соображению «локальный быстрее», не проверив формат ответа**.
Правильный порядок при подозрении на внешнюю зависимость:
```
1. Сравнить ФОРМАТ ответа (набор полей JSON), не только код и время
2. Отсутствие поля = потенциальный NPE в потребителе
3. Только потом менять источник
```
Дешевле сравнить два JSON, чем ломать модуль и разбирать час.
---
## Связанные
- [[personal/tech/lampac-torrserver]] — детальная диагностика, маршруты `/ts/`
- [[personal/tech/lampac-deployment]] — деплой, плагин каталога