Опис компонента OPKG

Інструкція користувача

Опис компонента OPKG

Менеджер пакетів opkg призначений для розширення можливостей пристроїв Keenetic шляхом встановлення додаткових програмних пакетів. За допомогою opkg досвідчені користувачі можуть встановлювати та оновлювати модулі, які не входять до базової прошивки пристрою, що дозволяє їм гнучко налаштоввувати функціональність маршрутизатора для конкретних завдань.

У цій статті описано принципи використання opkg у KeeneticOS, включаючи процедуру встановлення, методи підключення зовнішніх накопичувачів та рекомендації щодо використання пакетів із репозиторію.

Компонент Підтримка відкритих пакетів має бути встановлений на пристрої для використання відкритих пакетів.

Компонент:

додає команди налаштування opkg,
монтує файлову систему USB в /opt,
розпаковує файли *.ipk та *.tar.gz з каталогу /opt/install,
виконує хук-скрипти.

Налаштування

Команда opkg disk використовується для визначення файлової системи /opt. Файлову систему можна ідентифікувати за UUID або за міткою тому. Наприклад,

(config)> opkg disk OPT_LABEL:
Opkg::Manager: Disk is set to: OPT_LABEL.
(config)> system configuration save

Підтримуються файлові системи NTFS та EXT2/3. Після налаштування opkg disk та підключення накопичувача, компонент opkg:

Змонтує файлову систему OPT_LABEL до /opt.
Якщо каталог /opt/install існує, розпакує усі файли /opt/install/*.ipk до /opt. Це розпакування має бути завершено за 120 секунд, інакше воно буде перервано за тайм-аутом.
Виконає /opt/etc/initrc.

Хук-скрипти

Хук-скрипти розташовані в:

/opt/etc/initrc — скрипт автозапуску за замовчуванням (можна визначити за допомогою команди opkg initrc),
/opt/etc/ndm/*.d/ — обробники подій.

Каталоги скриптів та змінні середовища описані в окремих розділах нижче.

Змінні PATH та LD_LIBRARY_PATH попередньо визначені для вибору виконуваних файлів та динамічних бібліотек з /opt:

PATH=/opt/bin:/opt/sbin:/opt/usr/bin:/opt/usr/sbin:/bin:/sbin:/usr/bin:/usr/sbin
LD_LIBRARY_PATH=/opt/lib:/opt/usr/lib:/lib:/usr/lib

Префікс /opt завжди мається на увазі в директиві shebang хук-скрипта. Тобто, і #!/bin/sh, і #!/opt/bin/sh будуть виконувати інтерпретатор /opt/bin/sh.

Для кожного скрипту, що виконується, встановлено тайм-аут у 24 секунди.

Усі хук-skrypt запускаються в одній черзі, тобто поки виконується /opt/etc/ndm/wan.d/01-one.sh, жодні інші скрипти не будуть запущені ні з /opt/etc/ndm/wan.d/, ні з /opt/etc/ndm/netfilter.d/.

initrc

Скрипт ініціалізації /opt/etc/initrc виконується після монтування /opt. Він може виконувати деякі інші скрипти ініціализации, наприклад /opt/etc/init.d/*, для запуску фонових процесів. Якщо /opt/etc/initrc відсутній, компонент OPKG виконає /opt/etc/init.d/* в алфавітному порядку.

Наприклад, скрипт запуску dropbear може бути:

#!/bin/sh

if [ ! -d /opt/etc/dropbear ]; then
    mkdir /opt/etc/dropbear
fi

if [ ! -f /opt/etc/dropbear/dropbear_dss_host_key ]; then
    dropbearkey -t dss -f /opt/etc/dropbear/dropbear_dss_host_key
fi

if [ ! -f /opt/etc/dropbear/dropbear_rsa_host_key ]; then
    dropbearkey -t rsa -f /opt/etc/dropbear/dropbear_rsa_host_key
fi

dropbear

Для сумісності з системами ініціалізації, подібними до Sys-V, скрипти /opt/etc/initrc та /opt/etc/init.d викликаються з аргументом командного рядка start. Коли користувач хоче вийняти накопичувач /opt, /opt/etc/initrc викликається з аргументом stop.

ndm/wan.d

Скрипти подій /opt/etc/ndm/wan.d/ виконуються, як только з’явиться нове підключення до Інтернету.

1-й параметр	Опис
`start`	Підключення до Інтернету встановлено
`stop`	Підключення до Інтернету розірвано

Змінна	Опис
`$interface`	WAN-інтерфейс, наприклад `ppp0`
`$address`	IP-адреса інтерфейсу
`$mask`	Маска підмережі інтерфейсу
`$gateway`	IP-адреса WAN-шлюзу

Коли підключення до Інтернету не працює, скрипти wan.d виконуються з усіма невизначеними змінними, що зазначені вище.

Якщо підключення до Інтернету було встановлено до монтування /opt, скрипти wan.d виконуються відразу після initrc.

ndm/user.d

Скрипти /opt/etc/ndm/user.d виконуються, коли основна система оновлює /etc/passwd та /etc/group. Додайте скрипти до user.d, якщо вам потрібно змінити /etc/passwd або /etc/group. В іншому випадку будь-які зміни в цих файлах будуть перезаписані.

Змінна	Опис
`$user`	Ім'я користувача з доступом до `OptWare`, якщо додано через основну систему

Коли користувач видаляється, скрипти user.d виконуються з невизначеною змінною $user.

Наприклад, ви можете створити домашні каталоги за допомогою хука user.d наступним чином:

#!/bin/sh

home=/opt/home

[ -z "$user" ] && exit 0       # $user is undefined
[ -d $home/$user ] && exit 0   # home already exists

if mkdir -p $home/$user; then
    chmod 0755 $home
    chmod 0700 $home/$user
    chown $user $home/$user
fi

ndm/netfilter.d

Скрипти /opt/etc/ndm/netfilter.d виконуються, коли система переписує таблицю netfilter. Хуки netfilter.d можуть змінювати таблицю за допомогою iptables. Змінні $table та $type слід перевіряati, щоб запобігти дублюванню правил.

Змінна	Опис
`$type`	протокол netfilter, такий як `iptables` для IPv4 або `ip6tables` для IPv6
`$table`	таблиця netfilter, така як `filter`, `nat` або `mangle`

Наприклад, ви можете додати деякі правила mangle наступним чином:

#!/bin/sh

[ "$type" == "ip6tables" ] && exit 0   # check the protocol type in backward-compatible way
[ "$table" != "mangle" ] && exit 0   # check the table name

iptables -A PREROUTING -i br0 -t mangle -p tcp --dport 22 -j MARK --set-mark 1
iptables -A PREROUTING -i br0 -t mangle -p tcp --dport 23 -j MARK --set-mark 1

ndm/usb.d

Скрипти /opt/etc/ndm/usb.d виконуються, коли USB-пристрій під'єднано або від'єднано.

1-й параметр	Опис
`start`	USB-пристрій під'єднано
`stop`	USB-пристрій від'єднано

Наступні змінні середовища визначені, щоб дозволити вам ідентифікувати ключ.

Змінна	Опис	Приклад
`$usb_device`	Шлях до пристрою `/proc/bus/usb`	`/proc/bus/usb/002/001`
`$usb_devname`	Назва пристрою в `/proc/bus/usb`	`bus/usb/002/001`
`$usb_devpath`	Шлях в sysfs	`/devices/platform/xhci-hcd/usb2`
`$usb_model`	ID моделі USB	`0003`
`$usb_port`	Номер універсального порту USB	`2`
`$usb_vendor`	ID виробника USB	`1d6b`

Будь-який пристрій, підключений до виконання скрипту ініціалізації opkg, запустить ці скрипти зворотного виклику, заплановані для запуску під час виконання скрипту ініціалізації OPKG.

ndm/fs.d

Скрипти /opt/etc/ndm/fs.d викликаються, коли файлова система змонтована, готується до розмонтування або несподівано вилучена.

1-й параметр	Опис
`start`	Файлова система змонтована
`stop`	Файлова система готується до розмонтування або несподівано витягнута

Типом файлової системи може бути будь-який з: VFAT, EXFAT, NTFS, EXT2, EXT3, EXT4 або HFSP.

Змінна	Опис	Приклад
`$type`	Тип файлової системи	`EXT2`
`$name`	ID файлової системи	`583a7335-6ef8-460b-a4c1-43a2e5c70e71:`
`$label`	Мітка файлової системи / розділу	`SecondPart`
`$directory`	Каталог монтування файлової системи (абсолютний шлях)	`/tmp/mnt/SecondPart`

Будь-яка файлова система, змонтована до виконання скрипта ініціалізації OPKG, запустить ці скрипти зворотного виклику, заплановані для запуску під час виконання скрипта ініціалізації OPKG.

ndm/time.d

Скрипти /opt/etc/ndm/time.d викликаються, коли системний час змінюється (синхронізується через NTP).

ndm/button.d

Скрипти /opt/etc/ndm/button.d викликаються при натисканні кнопки FN та/або кнопки(ок) WPS.

Змінна	Опис	Приклад
`$button`	Яка кнопка була натиснута	`WLAN`
`$action`	Тип натискання	`натискання`, `подвійне натискання` або `утримання`

Спочатку вам потрібно налаштувати деякі деталі з вебінтерфейсу.

ndm/schedule.d

Скрипти /opt/etc/ndm/schedule.d викликаються із запланованими подіями (якщо розклади визначені через CLI).

1-й параметр	Опис
`start`	Початок запланованого завдання
`stop`	Кінець запланованого завдання