> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Распространённые проблемы, диагностика и процедуры решения

В этом руководстве описаны распространённые проблемы, затрагивающие не-валидирующие ноды, с практической диагностикой и шагами решения. Быстрое устранение неполадок критически важно для поддержания доступности RPC и надёжного доступа к данным транзакций со стейблкоинами.

<Note>
  Большинство проблем связаны с ограничениями системных ресурсов, сетевым подключением к консенсус-точкам или неправильной конфигурацией. Всегда начинайте с базовых проверок здоровья перед исследованием специфичных для Plasma крайних случаев.
</Note>

## Проблемы синхронизации

<AccordionGroup>
  <Accordion title="Нода отстаёт">
    Если нода отстаёт от головы сети:

    * **Проверьте нагрузку системы**: CPU, память и I/O должны быть достаточными для высокочастотной выработки блоков Plasma.
    * **Проверьте задержку консенсус-точки**: высокая задержка влияет на скорость получения блоков.
    * **Отслеживайте производительность БД**: медленные запросы или конфликты блокировок могут стать узким местом синхронизации.

    **Диагностика:** Проверьте `block_height` против головы сети, время применения состояния на блок и задержку до каждой консенсус-точки.
  </Accordion>

  <Accordion title="Синхронизация полностью останавливается">
    Если синхронизация останавливается:

    * **Проверьте дисковое пространство**: заполненные диски останавливают запись в БД.
    * **Проверьте подключение к точкам**: убедитесь, что DNS-разрешение, правила фаервола и маршрутизация не блокируют консенсус-трафик.
    * **Проверьте лимиты ресурсов контейнера**: недостаток памяти или CPU может крашить процессы синхронизации.

    **Plasma-специфичные проверки:** Проверьте доступность точек, валидность JWT-токенов / статус в allowlist и совместимость версии не-валидирующей ноды.
  </Accordion>

  <Accordion title="Плохое соединение с пирами">
    Ограниченные или нестабильные соединения с консенсус-точками снижают свежесть данных для RPC-потребителей.

    **Проверьте:** ограничения IP или политики маршрутизации, количество и время безотказной работы соединений с точками и поведение отказоустойчивости между несколькими точками.

    **Ключевые метрики:** активные соединения, частота разрывов и задержка прибытия блоков.
  </Accordion>
</AccordionGroup>

## Сетевое подключение

### Доступ к портам и фаерволам

Убедитесь, что необходимые порты открыты для:

* **Коммуникации консенсуса**
* **Обслуживания RPC для приложений**

Распространённые блокировщики включают корпоративные фаерволы, облачные группы безопасности или неправильно настроенные правила iptables.

**Проверьте:**

* Доступность порта снаружи и внутри контейнера
* Разрешённый исходящий трафик для синхронизации консенсуса

### Сбои DNS

Неразрешённые консенсус-домены ломают синхронизацию.

* Подтвердите DNS-разрешение для всех доменов сервисов Plasma
* Отслеживайте задержку и надёжность резолвера
* Добавьте резервные резолверы при необходимости

### Проблемы с прокси и NAT

Сложные сетевые окружения (VPN, прокси, NAT) могут мешать:

* Синхронизации консенсуса
* Входящему доступу к RPC

**Проверьте:**

* Правила аутентификации прокси
* Проброс портов NAT для входящего RPC
* Маршруты до инфраструктуры Plasma

## Ошибки конфигурации

<AccordionGroup>
  <Accordion title="Неверная конфигурация не-валидирующей ноды">
    Ошибки запуска часто вызваны неправильными или отсутствующими консенсус-точками, неверно сформированными URL или JWT-токенами или устаревшими флагами.

    **Проверьте логи на:** ошибки парсинга конфигурации, несоответствия chain ID и неизвестные флаги или опции.
  </Accordion>

  <Accordion title="Проблемы Docker">
    Неправильно настроенные контейнеры могут предотвращать нормальную работу.

    **Проверьте:** монтирование томов для постоянного хранения БД, сетевой доступ внутри контейнера, лимиты ресурсов (CPU, память) и совместимость версии образа.
  </Accordion>

  <Accordion title="Конфликты переменных окружения">
    Конфликтующие или неверно упорядоченные переменные окружения могут переопределять желаемые настройки.

    **Проверьте:** URL и токены консенсус-точек, сеть и chain ID и флаги функций (например, поддержка пользовательского газа). Документируйте использование переменных окружения, чтобы избежать дрейфа между развёртываниями.
  </Accordion>
</AccordionGroup>

## Ограничения ресурсов

### Дисковое пространство

Отслеживайте рост использования диска из-за:

* Данных блокчейна
* Логов и временных файлов

**Лучшие практики:**

* Внедрите ротацию логов
* Запланируйте задания очистки
* Отслеживайте оповещения об использовании

### Дескрипторы файлов

Низкие ulimit могут сломать:

* Консенсус-соединения
* RPC-сессии

Увеличьте лимиты дескрипторов файлов через `ulimit`, systemd или конфигурации рантайма контейнера.

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

### Анализ логов

Используйте логи для отслеживания:

* Прогресса синхронизации
* Ошибок RPC
* Подключения к консенсусу
* Сбоев, связанных с ресурсами

**Лучшие практики:**

* **Логи синхронизации консенсуса**: отслеживайте подключение и прогресс синхронизации с Plasma.
* **Логи обработки транзакций**: отслеживайте обработку транзакций и ошибки.
* **Логи RPC-запросов**: анализируйте паттерны и производительность запросов от платёжных приложений.
* **Логи использования ресурсов**: выявляйте узкие места, влияющие на обработку платежей.

### Профилирование производительности

Профилируйте нагрузки не-валидирующей ноды для выявления узких мест в:

* Производительности RPC
* Задержке запросов к БД
* Применении состояния консенсуса

**Зоны фокуса:**

* Пропускная способность проверки балансов
* Задержка подтверждения переводов
* Использование ресурсов под нагрузкой

Поддерживайте базовые показатели и отслеживайте изменения через обновления или изменения конфигурации.

Систематическое устранение неполадок и наблюдаемость необходимы для надёжной работы не-валидирующей ноды. Правильная диагностика, логирование и гигиена конфигурации обеспечивают стабильную производительность и доступность для RPC-сервисов, поддерживающих инфраструктуру стейблкоинов.