Команда opkg install возвращает ошибку «Unknown package», а нужный пакет точно существует в репозитории — в большинстве таких случаев причина в устаревшем локальном индексе, который обновляется командой opkg update. Пакетный менеджер opkg — основной инструмент управления программным обеспечением в OpenWrt, и понимание его работы избавляет от большинства проблем при расширении функциональности роутера.
OpenWrt из коробки содержит минимальный набор компонентов, а всё остальное — VPN-серверы, файловые серверы, adblock, SQM и сотни других утилит — ставится из официальных репозиториев. В этой статье разберём оба способа установки: через веб-интерфейс LuCI и через консоль по SSH, а также типичные ошибки и ограничения флеш-памяти.
Подготовка: что проверить перед установкой
Перед установкой любого пакета убедитесь, что роутер имеет доступ в интернет — opkg загружает пакеты с серверов OpenWrt, и без сети операция невозможна. Проверить это просто: выполните ping openwrt.org в консоли роутера. Если пинги не проходят, сначала разберитесь с WAN-подключением и DNS.
Второй критичный момент — свободное место во внутренней флеш-памяти. На устройствах с 8–16 МБ флеша пространство заканчивается быстро, и установка крупных пакетов может прерваться на середине. Текущее состояние смотрят командой df -h — интересует строка с точкой монтирования /overlay.
- 🌐 Проверьте доступ в интернет с самого роутера (
pingдо внешнего хоста). - 💾 Убедитесь, что в разделе
/overlayдостаточно свободного места. - 🔄 Обновите индекс пакетов командой
opkg updateперед каждой сессией установки. - 🔢 Сверьте версию OpenWrt (
cat /etc/openwrt_release) — пакеты должны соответствовать релизу.
Установка пакетов через веб-интерфейс LuCI
Самый простой способ для тех, кто не хочет работать с консолью, — раздел System → Software в веб-интерфейсе LuCI. Откройте страницу роутера в браузере, авторизуйтесь и перейдите в этот раздел. Первым делом нажмите кнопку Update lists — это аналог opkg update, без него список доступных пакетов будет пустым или устаревшим.
После обновления списков перейдите на вкладку Available и введите имя пакета в поле фильтра — например, openvpn-openssl или adblock. Найденный пакет устанавливается кнопкой Install, зависимости подтянутся автоматически. Уже установленные компоненты видны на вкладке Installed, там же их можно удалить.
Обратите внимание: если пакет добавляет собственный интерфейс в LuCI, соответствующий пункт меню может не появиться сразу. В этом случае просто обновите страницу браузера с очисткой кеша или перезайдите в панель.
Установка через SSH: команды opkg
Консольный вариант даёт больше контроля и единственный способ увидеть полный текст ошибок. Подключитесь к роутеру по SSH (по умолчанию пользователь root) и выполните обновление индекса:
opkg updateЗатем установите нужный пакет, указав его точное имя:
opkg install luci-app-sqmНайти точное имя помогает поиск по индексу. Команда opkg list | grep часть_имени выведет все подходящие пакеты из доступных репозиториев, а opkg list-installed покажет уже установленные. Для просмотра информации о конкретном пакете — зависимостей, размера и описания — используется opkg info имя_пакета.
☑️ Порядок установки пакета через SSH
⚠️ Внимание: не прерывайте процесс установки пакетов отключением питания роутера. Прерванная запись во флеш-память может оставить систему в несогласованном состоянии, и потребуется восстановление через failsafe-режим.
Основные команды opkg: шпаргалка
Для повседневной работы достаточно небольшого набора команд. Сводка ниже охватывает типичные задачи — от установки до очистки.
| Команда | Назначение |
|---|---|
opkg update | Обновить индекс доступных пакетов |
opkg install имя | Установить пакет с зависимостями |
opkg remove имя | Удалить пакет |
opkg list-installed | Показать установленные пакеты |
opkg files имя | Список файлов, входящих в пакет |
Отдельно стоит упомянуть opkg upgrade — массовое обновление всех пакетов. В OpenWrt эта операция официально не рекомендуется: пакеты тесно связаны с версией базовой системы, и массовый апгрейд может привести к конфликтам библиотек и неработоспособности устройства. Обновляйте только конкретные пакеты при явной необходимости.
Типичные ошибки и их решение
Ошибка «Unknown package» при заведомо правильном имени почти всегда означает устаревший или отсутствующий индекс — лечится повторным opkg update. Если после обновления пакет всё равно не находится, проверьте, не ищете ли вы компонент, исключённый из репозитория вашей версии, или пакет из стороннего фида.
Ошибки вида «Failed to download» или проблемы с проверкой подписи указывают на сетевые неполадки: недоступность серверов, неверную дату на роутере (ломает проверку сертификатов при HTTPS) или проблемы с DNS. Проверьте время командой date — при сильном расхождении синхронизируйте его через NTP.
Третья частая ситуация — несовместимость версий. Пакеты из репозитория одного релиза OpenWrt не всегда корректно работают на другом. Если вы ставите .ipk-файл вручную командой opkg install ./пакет.ipk, убедитесь, что он собран именно под вашу версию системы и архитектуру процессора.
⚠️ Внимание: принудительная установка пакета с флагом --force-depends игнорирует проверку зависимостей. Используйте её только если точно понимаете последствия — система может получить пакет без необходимых библиотек и перестать загружаться корректно.
Нехватка памяти и extroot
Устройства с малым объёмом флеша упираются в лимит уже после установки пары крупных пакетов. Признаки просты: установка обрывается с ошибкой записи, df -h показывает заполненный /overlay. Первый шаг — удалить ненужные пакеты и очистить кеш загрузок командой rm /tmp/opkg-lists/* (индексы всё равно пересоздаются при opkg update).
Радикальное решение — extroot: перенос корневой файловой системы на USB-накопитель. Роутер загружается с флеша, а затем монтирует внешний накопитель как overlay, что даёт практически неограниченное место для пакетов. Настройка требует установки пакетов поддержки USB и файловых систем, форматирования накопителя и правки конфигурации монтирования — процедура описана в официальной документации OpenWrt и зависит от конкретного устройства.
Почему нельзя просто удалить «лишние» системные пакеты
Многие предустановленные пакеты входят в read-only часть прошивки (squashfs). Их удаление не освобождает место — файлы остаются в базовом образе, а в overlay лишь создаются метки удаления, которые сами занимают пространство. Реально освобождают место только пакеты, установленные поверх базовой системы.
Сторонние репозитории и ручная установка .ipk
Помимо официальных фидов существуют сторонние репозитории. Они подключаются добавлением строки в файл /etc/opkg/customfeeds.conf (в старых версиях — /etc/opkg.conf) с указанием URL фида. После правки снова выполняется opkg update, и пакеты из нового источника становятся доступны.
Доверяйте только проверенным источникам: пакет из стороннего фида выполняется с правами root и теоретически может содержать что угодно. Для одиночной установки локального файла достаточно положить .ipk в /tmp (например, через scp) и выполнить opkg install /tmp/файл.ipk.
Частые вопросы
Почему после перезагрузки opkg не находит пакеты?
Индекс пакетов хранится в /tmp, то есть в оперативной памяти, и стирается при каждой перезагрузке. Выполните opkg update заново — это нормальное поведение системы, а не неисправность.
Можно ли обновить все пакеты командой opkg upgrade?
Технически команда существует, но разработчики OpenWrt не рекомендуют её использовать из-за риска конфликтов с базовой системой. Обновление всей системы выполняется через sysupgrade с новым образом прошивки, а отдельные пакеты — точечно при необходимости.
Куда устанавливаются пакеты и сколько места они занимают?
Пакеты записываются в раздел /overlay на внутренней флеш-памяти. Занимаемый объём зависит от пакета и его зависимостей — узнать размер до установки можно командой opkg info имя_пакета, а свободное место проверяется через df -h.
Что делать, если после установки пакета роутер перестал загружаться?
OpenWrt имеет режим failsafe, в котором загружается только базовая система без содержимого overlay. Порядок входа в этот режим зависит от модели устройства — сверьтесь с официальной документацией OpenWrt для вашего роутера. Из failsafe можно смонтировать overlay и удалить проблемный пакет или полностью сбросить настройки командой firstboot.
Как узнать, какие файлы установил конкретный пакет?
Используйте команду opkg files имя_пакета — она выведет полный список путей. Обратная задача — определить, какому пакету принадлежит файл — решается через opkg search /путь/к/файлу.