Усунення проблем у Capka
Перевіряйте Capka від зовнішнього до внутрішнього: спочатку сервер і контейнери, потім модель, після цього окрему пісочницю й задачу.
Інстанс не відкривається
- Перевірте сервер, вільний диск і пам’ять.
- Переконайтеся, що Docker працює, а контейнери Capka справні.
- Перевірте reverse proxy, DNS і TLS для адреси інстансу.
- Знайдіть перший помилковий крок у виводі встановлення чи оновлення.
Модель не відповідає
- Перевірте ключ, endpoint і назву моделі.
- Переконайтеся, що OpenAI-сумісний endpoint доступний із сервера Capka.
- Для Ollama перевірте завантажену модель і доступність endpoint із мережі застосунку.
- Спочатку виконайте короткий текстовий запит, а тоді файлову задачу.
Задача в пісочниці падає
- Перевірте ліміти пам’яті й диска.
- Переконайтеся, що мережева політика дозволяє потрібні хости.
- Повторіть із малим типовим файлом.
- Запишіть версію релізу, кроки й потрібні логи до створення issue.
Допомога
Спочатку пошукайте в GitHub Issues. Додайте версію Capka, архітектуру сервера, очікуваний і фактичний результат та мінімальне безпечне відтворення. Ніколи не публікуйте API-ключі, приватні файли чи секрети.