Устранение неполадок

В этом разделе описаны распространённые проблемы, возникающие при работе PRX, и способы их решения.

Быстрая диагностика

Запустите встроенную команду doctor для комплексной проверки состояния:

prx doctor

Она проверяет:

• Корректность конфигурационного файла
• Подключение к провайдерам и аутентификацию
• Системные зависимости
• Дисковое пространство и разрешения
• Статус активного демона

Распространённые проблемы

Демон не запускается

Симптомы: prx daemon завершается немедленно или не может привязать порт.

Решения:

• Проверьте, не запущен ли другой экземпляр: prx daemon status
• Убедитесь, что порт свободен: ss -tlnp | grep 3120
• Проверьте журналы: prx daemon logs
• Валидируйте конфигурацию: prx config check

Ошибка аутентификации провайдера

Симптомы: ошибки "Unauthorized" или "Invalid API key".

Решения:

• Проверьте ваш API-ключ: prx auth status
• Повторите аутентификацию: prx auth login <provider>
• Проверьте переменные окружения: env | grep API_KEY

Высокое потребление памяти

Симптомы: процесс PRX потребляет чрезмерный объём памяти.

Решения:

• Уменьшите количество параллельных сессий: задайте [agent.limits] max_concurrent_sessions
• Включите очистку памяти: prx memory compact
• Проверьте долгоживущие сессии: prx session list

Выполнение инструмента зависает

Симптомы: агент зависает во время выполнения инструмента.

Решения:

• Проверьте конфигурацию песочницы
• Убедитесь, что зависимости инструмента установлены
• Установите таймаут: [agent] session_timeout_secs = 300
• Отмените сессию: prx session cancel <id>

Получение помощи

• Ознакомьтесь со страницей Диагностика для подробных процедур диагностики
• Создайте issue на GitHub: https://github.com/openprx/prx/issues
• Присоединяйтесь к Discord-сообществу для помощи в реальном времени

Связанные страницы

• Диагностика