Решение проблем

Какой инструмент использовать

ДО УСТАНОВКИ                → meridian preflight IP
  "Будет ли этот сервер работать с Meridian?"

ПОСЛЕ УСТАНОВКИ, НЕ МОГУ ПОДКЛЮЧИТЬСЯ → meridian test IP
  "Доступен ли прокси отсюда?"

ПОСЛЕ УСТАНОВКИ, ЧТО-ТО СЛОМАЛОСЬ → meridian doctor IP
  "Собрать всё для отладки."

Добавьте --ai к preflight или doctor для готовой к AI диагностической подсказки.

Не может подключиться вообще

Порт 443 не доступен

Причины:

  1. Брандмауэр облачного провайдера / группа безопасности блокирует входящий порт 443
  2. ISP или сетевая блокировка IP-адреса сервера целиком
  3. Сервер не работает или прокси не запущен
  4. UFW на сервере не разрешает порт 443

Решения:

  1. Проверьте консоль облачного провайдера — убедитесь, что 443/TCP разрешен входящему трафику
  2. Попробуйте с другой сети (мобильные данные, другой Wi-Fi)
  3. SSH на сервер и проверьте: docker ps (3x-ui работает?), ss -tlnp sport = :443
  4. Проверьте UFW: ufw status — должно показать 443/tcp ALLOW

TLS handshake не пройден

Причины:

  1. Xray не работает внутри Docker контейнера
  2. Порт 443 занят другим сервисом
  3. Целевой SNI Reality недоступен с сервера

Решения:

  1. Проверьте Xray: docker logs 3x-ui --tail 20
  2. Проверьте порт: ss -tlnp sport = :443 — должен быть haproxy
  3. Протестируйте SNI: meridian preflight IP

Домен не доступен

Причины:

  1. DNS не указывает на IP сервера
  2. Caddy не работает или не получил TLS сертификат
  3. HAProxy не маршрутизирует домен SNI правильно

Решения:

  1. Проверьте DNS: dig +short yourdomain.com @8.8.8.8
  2. Проверьте Caddy: systemctl status caddy
  3. Проверьте HAProxy: /etc/haproxy/haproxy.cfg

Соединение прерывается через несколько секунд

Причины:

  1. Рассинхронизация системных часов >30 секунд между клиентом и сервером
  2. Проблемы с MTU на сетевом пути
  3. ISP сбрасывает долгоживущие TLS сессии

Решения:

  1. Сервер: timedatectl set-ntp true. Клиент: включите автоматическую установку даты/времени
  2. Попробуйте другую сеть
  3. Используйте WSS/CDN подключение (режим домена)

Установка не удалась

Конфликт порта 443

Другой сервис (Apache, Nginx) использует порт 443. Остановите его или используйте чистый сервер. meridian preflight скажет вам, что использует порт.

Docker установка не удалась

Конфликтующие Docker пакеты из репозиториев дистрибутива. Meridian автоматически их удаляет, но если Docker уже работает с контейнерами, он пропускает для предотвращения сбоев.

Ошибки подключения SSH

Протестируйте SSH вручную: ssh root@SERVER_IP. Убедитесь, что у вас есть доступ на основе ключей. Используйте флаг --user если не root.

Было работающим, теперь остановилось

Самая частая причина: IP-адрес сервера был заблокирован. Это очень частое явление в цензурируемых регионах.

Решения:

  1. Запустите meridian test IP — если TCP не пройден, IP вероятно заблокирован
  2. Используйте WSS/CDN ссылку (режим домена)
  3. Разверните новый сервер: получите новый IP и переустановите meridian deploy

Другие причины:

  • Сервер перезагрузился и Docker не запустился автоматически → docker start 3x-ui
  • Диск переполнен → df -h /, docker system prune -af

Низкая скорость

  1. Выберите сервер географически ближе (Финляндия, Нидерланды, Швеция для Европы/Ближнего Востока)
  2. Проверьте нагрузку на сервер: htop или uptime
  3. Попробуйте WSS/CDN ссылку — может иметь лучшую маршрутизацию через Cloudflare
  4. Проверьте, включен ли BBR: sysctl net.ipv4.tcp_congestion_control

НЕ запускайте другие протоколы (OpenVPN, WireGuard) на том же сервере — это помечает IP.

AI-усиленная помощь

meridian doctor --ai

Копирует диагностическую подсказку в буфер обмена для использования с любым AI ассистентом.

Или соберите диагностику для GitHub issue:

meridian doctor
On this page