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

Это руководство охватывает типичные проблемы, с которыми вы можете столкнуться при работе с ShredStream.com, и способы их решения.

Используете наш SDK? SDK автоматически обрабатывает парсинг и валидацию пакетов. Описанные ниже сетевые проблемы (firewall, IP, тюнинг буферов) актуальны независимо от того, используете ли вы SDK или собственный UDP-слушатель.


❌ Данные не поступают

Если ваш UDP-слушатель запущен, но shreds не приходят:

  1. Проверьте firewall -- Убедитесь, что firewall разрешает входящий UDP-трафик на настроенном порту. В Linux:
    bash
    sudo ufw allow <port>/udp
  2. Убедитесь, что стрим активен -- Откройте Панель управления и проверьте, что статус стрима показывает Активна. Истёкшие или приостановленные стримы не отправляют данные. Если стрим показывает Подготовка или Error, подождите и обновите страницу. Если статус не меняется, обратитесь в поддержку через Discord.
  3. Проверьте совпадение IP -- IP-адрес назначения стрима должен точно совпадать с публичным IP вашего сервера. Проверить публичный IP можно так:
    bash
    curl -4 ifconfig.me
  4. Привяжите к 0.0.0.0 -- Убедитесь, что UDP-сокет привязан к 0.0.0.0, а не к 127.0.0.1 или IP конкретного интерфейса. Привязка к localhost молча отбрасывает весь внешний трафик.

📉 Высокая потеря пакетов

Shreds поступают по UDP, который не ретранслирует потерянные пакеты. Минимизация потерь критически важна.

  1. Увеличьте буфер приёма UDP минимум до 25 МБ:

    bash
    # Check current value
    sysctl net.core.rmem_max
    # Set to 25 MB
    sudo sysctl -w net.core.rmem_max=26214400
    sudo sysctl -w net.core.rmem_default=26214400

    Примечание: Linux удваивает значение, установленное через setsockopt(). Если вы запрашиваете 25 МБ, ядро выделяет 50 МБ. Значение sysctl -- это верхняя граница до удвоения.

  2. Выберите ближайший регион -- Задержка и потеря пакетов увеличиваются с расстоянием. Выберите ближайший к вашему серверу регион в настройках стрима.

  3. Избегайте блокирующего ввода-вывода в цикле приёма -- Любая задержка обработки в потоке, вызывающем recvfrom(), приводит к переполнению буфера ядра и потере пакетов. Выносите парсинг и логику в отдельный поток.

  4. Отслеживайте потери на уровне ядра:

    bash
    # Per-socket drops (Linux)
    ss -u -a -n
    # System-wide UDP stats
    netstat -su

    Ищите счётчик RcvbufErrors или packet receive errors. Если это число растёт, буфер слишком мал или приложение не успевает считывать данные.


💳 Платёж не подтверждается

Платежи обрабатываются в блокчейне Solana. Если платёж завис:

  1. Подождите 30–60 секунд -- Транзакции Solana обычно подтверждаются за несколько секунд, но перегрузка сети может вызвать задержки.
  2. Убедитесь, что отправлено достаточно SOL -- Отправленная сумма должна соответствовать сумме, указанной в окне оплаты. При оплате с биржи учитывайте комиссию за вывод, чтобы полная сумма поступила на адрес оплаты.

Если транзакция не прошла ончейн, вы можете повторить оплату из панели управления.


⚠️ Стрим неожиданно остановился

Если стрим, который ранее работал, перестал доставлять shreds:

  1. Проверьте дату окончания -- Откройте страницу деталей стрима в панели управления. Если стрим истёк, продлите его для возобновления доставки.
  2. Проверьте статус региона -- Иногда регион может проходить техническое обслуживание. Проверьте панель управления на наличие уведомлений о статусе региона.
  3. Обратитесь в поддержку -- Если стрим показывает активный статус и регион работает нормально, откройте тикет в Discord в канале #ticket.

🌍 Смена региона не удалась

При неудачной смене региона ShredStream.com автоматически откатывает стрим к исходному региону, чтобы избежать прерывания.

  1. Проверьте ёмкость целевого региона -- Выбранный регион может быть временно на полной мощности. Попробуйте снова через несколько минут.
  2. Убедитесь, что стрим активен -- Смена региона возможна только для активных стримов. Истёкшие или ошибочные стримы необходимо сначала продлить.
  3. Попробуйте другой регион -- Если целевой регион стабильно недоступен, выберите альтернативный регион, расположенный географически близко.

После неудачной смены ваш стрим продолжает работать в исходном регионе без потери данных.


🔌 Проблемы с подключением

Если вам не удаётся настроить стрим или возникают ошибки подключения:

  1. Используйте публичный IPv4-адрес -- ShredStream.com доставляет данные только на публичные IP. Приватные диапазоны не поддерживаются:
    • 10.0.0.0/8
    • 172.16.0.0/12
    • 192.168.0.0/16
  2. Используйте порт от 1024 до 65535 -- Порты ниже 1024 зарезервированы и могут требовать привилегий root или быть заблокированы хостинг-провайдерами.
  3. Убедитесь, что NAT не блокирует входящий UDP -- Если ваш сервер находится за NAT-шлюзом (часто у облачных провайдеров), убедитесь, что NAT или группа безопасности перенаправляет UDP-трафик на выбранном порту на ваш инстанс.

💬 Всё ещё нужна помощь?

Если ничего из вышеперечисленного не решило вашу проблему, обратитесь в нашу команду поддержки:

  • Discord (быстрее всего): Откройте тикет в канале #ticket
  • Telegram: @shredstream

Укажите ID стрима, регион сервера и описание проблемы, чтобы мы могли помочь вам быстро.

Устранение неполадок — Documentations | ShredStream.com