Установка sing-box через opkg: типовые ошибки пакета
Команда opkg относится к OpenWrt 24.10 и старше; в 25.12+ используется apk. Ошибки установки проверяйте по версии прошивки, архитектуре, репозиторию и свободному месту.
Содержание
Уточните менеджер пакетов
На OpenWrt 24.10 и более старых релизах применяется opkg, на 25.12 и новее — apk. Если инструкция требует opkg install, а на роутере уже новая ветка, не пытайтесь перенести IPK напрямую. Сначала откройте документацию именно своего релиза и проверьте доступные репозитории.
Почему пакет не находится
Чаще всего пакет отсутствует в подключённых feed, списки не обновлены, архитектура не совпадает или пакет рассчитан на другой релиз. Проверьте номер прошивки, target/architecture и точное имя пакета. Установка из случайного репозитория может затянуть несовместимые библиотеки и нарушить работу роутера.
Почему прерывается установка
Сравните текст ошибки с причиной: «not found» указывает на feed или имя; конфликт зависимостей — на версию или смешанные репозитории; «no space left» — на flash. Не используйте принудительное игнорирование зависимостей как стандартное исправление. Не обновляйте все системные пакеты вручную на рабочем роутере ради одного клиента.
Безопасный порядок
- Сохраните резервную копию конфигурации OpenWrt.
- Запишите релиз, target, architecture и свободное место.
- Обновите индекс в соответствующем менеджере пакетов.
- Проверьте наличие пакета в доверенном feed.
- После установки проверьте версию sing-box, JSON и журнал.
Базовая настройка клиента после установки описана в основном руководстве. Если нужного пакета нет для вашей модели, не подменяйте его сборкой с другой архитектурой.
Проверено на практике
- Дата проверки: 2026-09-29
- Среда: Сверено с указанными первоисточниками; устройство читателя не проверялось
- Версии: Зависит от версии core, клиента и прошивки
Мини-чеклист
- Определить версию OpenWrt и пакетный менеджер
- Сверить архитектуру
- Проверить feed и свободное место
- Не обходить зависимости силой
- Проверить core после установки
Частые ошибки
- Применять opkg к OpenWrt 25.12+
- Ставить чужой IPK
- Игнорировать ошибку зависимостей
Источники и документация
FAQ
Почему opkg не найден?
В OpenWrt 25.12+ используется apk. Сверьте версию прошивки перед выбором команды.
Хотите перейти сразу к рабочему доступу?
Если сценарий уже ясен и не хочется проходить все шаги вручную, оформите доступ и проверьте подключение на своем устройстве.
Получить доступ