Усунення несправностей

Файли, що лишилися після перерваного імпорту (.abmstage)

Імпорт спершу кладе кожен файл поруч із його остаточною назвою, а коли всі файли на місці, підміняє їх. Якщо щось не вдається, ABM повертає назад те, що переніс. Якщо якусь частину повернути не вдається, вона лишається в теці книжки як прихований файл із закінченням .abmstage. Це може бути єдина копія, тож ABM її зберігає, а помилка називає цей файл.

Поки в теці книжки є хоч один файл .abmstage, імпорт у цю теку зупиняється з повідомленням:

Files left by an interrupted import are in the way. Recover or remove them, then retry.

Щоб відновитися:

1. Знайди файл .abmstage, названий у помилці.
2. Перенеси його назад у завантаження або в теку книжки під справжньою назвою. Або видали, якщо він тобі не потрібен.
3. Повтори імпорт.

За зворотним проксі всіх просить увійти

Без TRUSTED_PROXIES запит із заголовками пересилання ніколи не вважається локальним, тож мусить проходити вхід. Так зроблено навмисно.

1. Задай TRUSTED_PROXIES як адресу свого проксі, наприклад 172.20.0.5. Проксі на тому самому хості потребує 127.0.0.1.
2. Налаштуй проксі, щоб він надсилав X-Forwarded-For або X-Real-IP. nginx proxy manager, Traefik і Caddy роблять це за замовчуванням.
3. Перезапусти ABM.

Журнал застосунку підкаже, що саме не так:

• “carries reverse-proxy headers, but … is not in TRUSTED_PROXIES”: додай проксі в TRUSTED_PROXIES.
• “… is in TRUSTED_PROXIES but didn’t name a client address”: налаштуй проксі, щоб він надсилав X-Forwarded-For або X-Real-IP.

Протилежний випадок: проксі, який не надсилає заголовків пересилання, виглядає як локальний клієнт, тож усе, що йде через нього, обходить вхід. Задай Authentication Required як Enabled.

Зміни з браузера відхиляються

Переконайся, що проксі передає оригінальний заголовок Host або надсилає X-Forwarded-Host. Дивись Конфігурація.

Зникають обкладинки або сторінка дивно поводиться за проксі

Заголовок Content-Security-Policy дозволяє лише обкладинки через HTTPS. Пошукай порушення в консолі браузера. Віддавай обкладинки через HTTPS або задай SECURITY_HEADERS_CSP_ENABLED=false.

Великий запит повертає 413

Збільш MAX_REQUEST_BODY_BYTES. Зворотний проксі теж може мати нижчий ліміт і сам відповідати 413.

Джерело метаданих недоступне

Додавання, пошук, оновлення та Discover потребують Libex. Коли ABM не отримує відповіді, пошук книжок завершується помилкою “Libex search failed”, а пошук авторів чи серій помилкою “Libex could not be reached; try again shortly”, замість порожнього списку. Причини: Libex не працює або з’єднання ABM до нього не доходить.

1. Глянь на сторінку стану ABM і сторінку стану Libex, чи не лежить він для всіх.
2. Перевір, що контейнер має вихід в інтернет і що проксі в Settings > General > Proxy правильний, якщо ти його використовуєш.
3. Спробуй ще раз за хвилину.
4. Тим часом ти можеш і далі додавати та імпортувати книжки вручну.

Фонове завдання, яке натрапляє на збій, завершується помилкою з причиною. Воно повторюється саме, до шести разів або протягом шести годин, залежно від того, що настане раніше.

Оновлення змінило дані книжки

Назва, опис, автори, диктори та подібні поля приходять із джерела метаданих, і оновлення застосовує те, що там зараз написано. Вручну їх в ABM не відредагуєш. Ти керуєш обкладинкою (її можна заблокувати), тим, які файли записуються, тегами і тим, чи записують оновлення супровідні файли та теги. Дивись Твої метадані під твоїм контролем.

Книжка показує Missing Files

Книжку завантажено, але її файлів немає там, де шукає ABM. Перевір монтування та права доступу, потім запусти Refresh & Scan. Якщо теку книжки не вдається прочитати, сканування книжку не чіпає, а завдання показується як Partial із причиною.

Імпорт зупиняється з “Files left by an interrupted import”

Дивись розділ про .abmstage вище.

Завантаження завершуються, але не імпортуються

Додай зіставлення віддаленого шляху або зроби так, щоб ABM і клієнт бачили теку за тим самим шляхом. Підтека, яку не можна прочитати, блокує все завантаження, доки не виправлено її права доступу. Дивись Клієнти завантажень.

Docker не може достукатися до джерела метаданих чи індексаторів

Спершу перевір DNS і налаштування проксі. У Docker ABM дістається до Libex і твоїх індексаторів, лише якщо контейнер має вихід в інтернет.

Досі не виходить

Запитай у Discord ABM, створи issue або напиши на support@audiobookmanager.com.