sing-box на OpenWrt: установка и базовая настройка
Проверьте совместимость OpenWrt и пакета, установите sing-box из доверенного источника, запустите минимальный конфиг и лишь затем настройте маршруты LAN.
Содержание
Проверьте роутер до установки
Нужны точная модель, архитектура CPU, версия OpenWrt, свободное место и доступная память. Пакет для другой архитектуры не установится, а даже установленный core может не вместиться вместе с rule-set. Сохраните резервную копию OpenWrt и убедитесь, что у вас есть доступ к устройству без sing-box: настройки сети могут временно лишить вас веб-интерфейса.
Выберите источник пакета
Официальная документация sing-box описывает installation script, который поддерживает OpenWrt, но удалённые shell-скрипты запускайте только после проверки источника и содержимого. Если используете репозиторий своей сборки OpenWrt, проверьте название, версию и архитектуру пакета в нём. Не смешивайте пакеты из разных релизов и не скачивайте случайный .ipk из чата.
Отдельные сборки tiny/full/extended и LuCI-оболочки могут иметь другой набор возможностей; их наличие не гарантирует официальный core. Сначала добейтесь запуска core без дополнительных панелей.
Минимальный запуск
- Сохраните конфигурацию роутера и доступные данные текущей сети.
- Установите совместимый пакет из проверенного источника.
- Сохраните минимальный JSON в защищённом файле: без реальных ключей в истории команд.
- Проверьте JSON командой
sing-box check -c /path/to/config.json, затем запустите сервис и откройте его журнал. - Проверьте один исходящий профиль на самом роутере, прежде чем перенаправлять устройства LAN.
Точный путь файла и имя init-сервиса зависят от пакета. Не копируйте их вслепую из инструкции для другого образа.
DNS и трафик локальной сети
Работающий процесс не означает, что трафик телефонов и ноутбуков уже проходит через него. Для LAN нужны согласованные DHCP/DNS, firewall и правила маршрутизации. Выберите одно тестовое устройство, проверьте его DNS и внешний маршрут, затем добавляйте остальные. Сохраняйте исключения для адресов локальной сети и управления роутером, иначе можно потерять доступ к его панели.
Если что-то пошло не так
Пакет не ставится — проверьте архитектуру, репозитории, подписи и свободное место. Сервис не стартует — читайте точную ошибку в журнале, проверьте JSON и занятые порты. Сервис стартовал, но LAN без доступа — начните с DHCP/DNS и firewall, а не меняйте серверный ключ. При потере доступа верните сохранённую конфигурацию OpenWrt через локальную консоль или заранее подготовленный способ восстановления.
Проверено на практике
- Дата проверки: 2026-09-29
- Среда: Сверено с официальной документацией установки sing-box и OpenWrt; на физическом роутере не проверялось
- Версии: Версии OpenWrt и пакетов зависят от модели
Мини-чеклист
- Узнать модель, OpenWrt release и архитектуру
- Сохранить бэкап и путь локального восстановления
- Установить совместимый пакет из проверенного источника
- Проверить core и журнал до настройки LAN
- Проверить одно LAN-устройство, затем остальные
Частые ошибки
- Ставить ipk для другого OpenWrt релиза
- Включать прозрачную маршрутизацию до проверки core
- Путать статус сервиса с работающим DNS для LAN
Источники и документация
FAQ
Нужен ли LuCI для sing-box?
Нет, core может работать без веб-оболочки. LuCI — отдельный инструмент и должен подходить вашей сборке.
Почему работает на роутере, но не на телефоне?
Проверьте DNS и маршрут LAN-клиента, DHCP и firewall. Эти настройки не следуют автоматически из запуска процесса.
Хотите перейти сразу к рабочему доступу?
Если сценарий уже ясен и не хочется проходить все шаги вручную, оформите доступ и проверьте подключение на своем устройстве.
Получить доступ