Skip to content

Troubleshooting.ru

Jump to bottom
Iman edited this page Sep 7, 2026 · 5 revisions

Устранение неполадок для домашних пользователей

Начните с кабеля Ethernet от роутера к компьютеру с Caspian. Для точки доступа используйте встроенный Wi-Fi, а на Linux можно использовать совместимый USB-адаптер Wi-Fi. Так интернет и точка доступа работают через разные адаптеры. Это рекомендуемая начальная схема, а не гарантия измеренной скорости.

Не задана страна Wi-Fi

Автоматическое определение остаётся режимом по умолчанию. Оставьте поле Country пустым, если Caspian определяет страну. При ошибке «Wi-Fi country is not set» откройте Set Wi-Fi country. В расширенных настройках укажите двухбуквенный код страны, где находится компьютер, сохраните его и снова включите Caspian. Выбор сохраняется после перезапуска службы. Чтобы вернуть автоматический режим, очистите поле и сохраните. Caspian не подставляет IR и не выбирает страну по языку панели или прокси-серверу.

Если установленная версия скрывает поле Country, доступное поле добавляется в исправлении issue #3. Сообщите версии Caspian и Linux, схему подключения адаптеров и результат выбора страны в обновлённой панели. Не отправляйте личную конфигурацию или полные журналы. Успех ручной команды iw не доказывает необходимость изменения системных настроек радио приложением. Автоматический iw reg set в это изменение не входит.

Выберите схему подключения

На схемах [1] означает интернет-роутер, [2] компьютер с Caspian, [3] телефон или другое устройство. ETH означает кабель Ethernet. USB-адаптер Ethernet подаёт интернет на компьютер; USB-адаптер Wi-Fi обеспечивает беспроводное соединение. Это разные устройства.

A  [1] --ETH--> [2] --built-in Wi-Fi--> [3]
B  [1] --ETH--> [2] --USB Wi-Fi-------> [3]
C  [1] --Wi-Fi A--> [2] --Wi-Fi B----> [3]
D  [1] --Wi-Fi--> [2: one radio] --Wi-Fi--> [3]
Интернет для Caspian Точка доступа для устройств Linux / Raspberry Pi macOS
A. Ethernet Встроенный Wi-Fi Поддерживается, если драйвер умеет создавать точку доступа Поддерживаемая схема
B. Ethernet Внешний USB Wi-Fi Нужен Linux-драйвер с режимом точки доступа (AP) Caspian не поддерживает его как точку доступа
C. Адаптер Wi-Fi A Отдельный адаптер Wi-Fi B Адаптер B должен поддерживать AP Точка доступа на внешнем USB Wi-Fi не поддерживается
D. Wi-Fi Тот же радиомодуль Wi-Fi Зависит от совместной работы станции и AP; канал может быть общим На встроенном радиомодуле не поддерживается

Таблица описывает схемы, которые текущий код может построить или отклонить. Она не подтверждает работу каждого адаптера, обновления ОС или ноутбука. Адаптер, который подключается к домашнему Wi-Fi, не обязательно умеет создавать точку доступа. USB-схемы Linux проверены на моделях; имеющиеся аппаратные испытания не подтверждают работу всех USB-адаптеров. На Mac используйте Ethernet и встроенный Wi-Fi. Подключение USB Wi-Fi это ограничение не снимает.

Сначала подключите сеть, затем запустите Caspian

  1. Выполняйте настройку на компьютере с Caspian. Если работать только с телефона в его Wi-Fi, остановка точки доступа отключит телефон.

  2. Оставьте Caspian выключенным. Подключите кабель к исправному LAN-порту роутера и компьютеру. Подключите USB Ethernet или поддерживаемый USB Wi-Fi до открытия приложения.

  3. В настройках сети компьютера проверьте, что Ethernet подключён. При работающем Wi-Fi открывшийся сайт ещё не доказывает наличие интернета по кабелю. Отключитесь от домашней сети Wi-Fi и проверьте снова; оставьте радиомодуль доступным для точки доступа.

  4. Пока Caspian выключен, откройте сайт, который обычно доступен через это соединение. Если он не открывается, сначала проверьте кабель, роутер или вход в сеть. Caspian нужен уже работающий интернет.

  5. Откройте Caspian и веб-панель. На самом компьютере используйте http://127.0.0.1:8088/, если служба панели работает. На телефоне этот адрес относится к телефону, а не к компьютеру с Caspian.

  6. Проверьте в панели выбор подключения к интернету и адаптера точки доступа. Начните с автоматического выбора. При ошибочном выборе укажите Ethernet для интернета и нужный Wi-Fi для точки доступа. Имена USB-адаптеров различаются; не копируйте имя интерфейса с чужого компьютера.

  7. Сохраните конфигурацию прокси, имя и пароль точки доступа. Начните с 2.4 ГГц для устройств, которые не видят 5 ГГц. Укажите свою страну и оставьте автоматический канал, если нет причины менять его.

  8. Включите Caspian один раз и дождитесь результата. Ready в Caspian Control означает, что службы отвечают. Состояние туннеля и точки доступа смотрите в веб-панели. Подключите один телефон к новой сети и откройте сайт.

Если вы сменили кабель или адаптер

Остановите Caspian, измените подключение и снова проверьте интернет до запуска. Закрытие браузера или окна управления не обязательно останавливает фоновые службы. Повторные нажатия не исправят несовместимый адаптер.

На Mac откройте Caspian Control, затем Advanced options > Restart services. Дождитесь результата, снова откройте панель и включите Caspian, если он выключен. Перезапуск отключает клиентские устройства и может закрыть панель. Сохранённые настройки прокси и точки доступа остаются.

На Linux со стандартной установкой через systemd следующая команда перезапускает обе службы Caspian. Выполняйте её на компьютере с Caspian в локальном терминале или через отдельное соединение, которое переживёт остановку точки доступа. Команда не предназначена для macOS, Windows или контейнера без systemd.

sudo systemctl restart caspian.service caspian-panel.service

После завершения команды откройте панель и при необходимости включите Caspian. Если служба снова выдаёт ошибку, сохраните её текст для отчёта. Не повторяйте перезапуск постоянно, не удаляйте конфигурацию и не отключайте брандмауэр ради исчезновения ошибки. В панели Advanced > Put it back and start again запускает восстановление сети с сохранёнными настройками. Это отличается от перезапуска служб; устройства могут отключиться.

Найдите свой симптом

Что происходит Что проверить
Интернета нет ещё до запуска Caspian Попробуйте другой кабель или LAN-порт роутера. Проверьте Ethernet в ОС. Выполните вход в сеть, пока Caspian выключен.
Единственный Wi-Fi-адаптер уже занят На Linux используйте Ethernet или отдельный адаптер с AP. Одному радиомодулю нужна поддержка одновременных ролей; канал может быть общим. На macOS используйте Ethernet и встроенный Wi-Fi.
Нет адаптера для точки доступа / адаптер не найден Подключение к Wi-Fi не доказывает поддержку AP. На Linux проверьте драйвер и AP. На Mac внешний USB Wi-Fi не может быть точкой доступа Caspian.
Адаптер занят или точка доступа не запускается Остановите Caspian. Отключите адаптер точки доступа от другой сети, сохранив интернет на входном адаптере. Остановите другую точку доступа, которую вы включили. При выключенном Caspian проверьте, не работает ли другой VPN, затем повторите попытку.
Телефон не видит точку доступа Проверьте её состояние в панели. Подойдите ближе, попробуйте 2.4 ГГц и проверьте страну. Закреплённый канал следует входящему Wi-Fi; отдельная настройка канала точки доступа его не заменяет.
Сеть видна, но телефон не подключается Введите пароль Wi-Fi, а не панели. После смены имени или пароля удалите старую сохранённую сеть и подключитесь снова. Если получение адреса не заканчивается, перезапустите Caspian один раз; при повторении сообщите об ошибке.
Телефон подключён, но сайты не открываются Проверьте Traffic cut и возобновите трафик, если хотите разрешить доступ. Прочтите ошибку туннеля, проверьте дату и время компьютера. Сервер из корректно прочитанной конфигурации может быть недоступен: уточните у поставщика. Временно отключите мобильные данные телефона, чтобы проверять именно Wi-Fi.
В Control написано Ready, но панель красная Ready подтверждает ответ служб. Панель показывает состояние туннеля и точки доступа. Запишите точную ошибку вместо повторных переустановок.
Панель исчезла после остановки или перезапуска Когда службы запустятся, откройте http://127.0.0.1:8088/ на компьютере с Caspian. Телефон теряет путь к панели при остановке точки доступа. Доступ из локальной сети по умолчанию выключен.
Ошибка после сна, отключения дока или смены сети Разбудите компьютер, подключите кабель и адаптеры, проверьте интернет при выключенном Caspian и запустите его снова. Не переводите компьютер в сон, пока устройства используют его точку доступа.
macOS блокирует приложение Следуйте руководству по установке на Mac. Предупреждение о непроверенном разработчике отличается от обнаружения конкретной вредоносной программы. Не обходите предупреждение с названием трояна или другого вредоносного ПО.

Проверьте формат конфигурации

Caspian принимает ссылки VLESS, VMess, Shadowsocks, SOCKS, Trojan и Hysteria2, включая псевдоним hy2. Также принимаются поддерживаемые документы Clash/Clash.Meta YAML, Xray JSON, списки ссылок и содержимое подписки в base64. Из списка используется первая ссылка; URL подписки не загружается. Попросите поставщика дать саму поддерживаемую конфигурацию, а не пароль аккаунта или ссылку на веб-страницу.

Поддерживаемые названия транспорта: raw/tcp, ws, grpc, httpupgrade, xhttp/splithttp и kcp/mkcp. Протокол, транспорт и параметры безопасности должны сочетаться; работают не все комбинации. Ссылки TUIC, WireGuard, SSR, AnyTLS и Hysteria v1 не поддерживаются. Не переименовывайте протокол для обхода проверки. Ограничения и результаты тестов приведены в руководстве по протоколам.

Обратитесь за помощью без раскрытия секретов

В форме ошибки укажите версию Caspian, ОС или дистрибутив и его версию, схему Ethernet-to-Wi-Fi или Wi-Fi-to-Wi-Fi, встроенный или внешний тип каждого адаптера, работал ли интернет до запуска, точный текст ошибки и уже выполненные действия. Название чипсета или драйвера полезно, если известно; серийный номер не нужен.

Не публикуйте ссылки прокси, содержимое подписок, файлы конфигурации, пароли, ключи, QR-коды, публичные IP, имена домашнего Wi-Fi, MAC/BSSID, персональные имена компьютеров и непроверенные журналы или снимки экрана. Скопируйте короткую ошибку и удалите идентификаторы. Для поддержки не открывайте панель в интернет и не перенаправляйте порт роутера.

Известные ограничения и проверки

Реестр дефектов описывает пробелы в безопасности и восстановлении. Эти инструкции их не устраняют. Например, периодической проверки с восстановлением правил брандмауэра, удалённых другой программой, нет. Не запускайте одновременно другой инструмент раздачи сети. Тесты ниже проверяют выбор схемы и отказы на контролируемых данных, а не работу на вашем оборудовании.

Clone this wiki locally