Ядро steer 2.1 говорит steer-api 1.2. Это прибавка к steer-api.md (1.0) и
steer-api-1.1.md: плагин, написанный по 1.0 или 1.1, работает без изменений. Плагину, которому
нужно новое, пишут compat.steer-api: "^1.2"; ядро отвечает steer version --json с "api":"1.2". Тест
совместимости — sh tests/compat/run.sh --steer <каталог плагина> (заглушка ядра tests/compat/steer-2.1/host.py
проверяет и службы).
Появилось по нужде первого плагина «служба + слот nft» — recheck (решение В7): DPI-обход на весь трафик в WAN —
служба под надзором steer и правила queue в слотах.
Раздел манифеста описан в manifest.md (steer.services[]) и был в 1.0; ядро 1.2 исполняет его.
- Служба — одна на роутер, а не на выход:
name,prog,argv,env,timeout_s. Умолчаниеargv—["<name>"]. Подстановки вargv— все плагинные:{plugin_dir},{plugin_conf},{plugin_state},{mark},{mark0}…,{queue0}…,{port0}…; подстановок выхода ({out},{conf}) у службы нет — отказ. - Служба идёт, пока плагин включён и ядро steer включено: тем же супервизором, что помощники выходов, с той же
паузой перезапуска (5 с с удвоением до 5 мин), трубой событий (
STEER_EVENT_FD) иPR_SET_PDEATHSIG. Подпись перезапуска — версия плагина, словаargvс выданными ресурсами иenv: сменился номер очереди — служба перезапускается. - События службы:
helloпервым (как у помощника:api,ver,mod), затем по смыслуready(поднялась, то же, чтоup),up/downсwhyиstate(переписан файл состояния). Остальные события выходов — узлы, устройства, приговоры,health— служба не говорит; ядро их пропускает. - Ядро шлёт подписчикам
helper-up/helper-downиplugin-stateс полемservice(имя службы) вместоout: служба — не выход.steer ctl helper <служба>отвечает так же, с"service":"<имя>";plugin,plugin_ver,rejectedиlast_down— как у помощника выхода. - Окружение программы плагина (
STEER_API,STEER_PLUGIN_ID,STEER_PLUGIN_DIR,STEER_PLUGIN_CONF,STEER_PLUGIN_STATE, … — раздел 1.2 основного описания) получает и помощник выхода, и служба: раньше ядро выставляло его хукам и подкомандам, но не помощникам. Каталогиconf/<id>иplugin/<id>созданы до запуска. - Ресурсы плагина (
resourcesманифеста) ядро выдаёт при подготовке спеки; плагину с службой этот шаг нужен всегда. - Служба и слот nft одного плагина делят выданные ресурсы:
queue … to {queue0}в правилах и{queue0}вargvслужбы — одно число. - Имя службы глобально: плагин, чья служба названа как служба стоящего раньше (по
id), выключен с причиной.
| Слот | Тип, хук | Приоритет | Место |
|---|---|---|---|
output-raw |
filter, output | raw+1 (−299) | до conntrack (−200): notrack на пакеты, которые плагин сам породил, чтобы поддельные пакеты не меняли запись соединения |
Остальные слоты output-pre и output-post — после conntrack (route, mangle), notrack в них уже не действует.
Приоритет — постоянное число API v1; слот зеркален prerouting-raw. Карта steer nft-map печатает его.
@wan_dev в файле nft плагина — устройства маршрутов по умолчанию таблицы main, IPv4 и IPv6 (ip route show default), как они лежат при печати набора правил. Раньше набор заводился пустым и правила по нему не совпадали.
Сменился WAN — событие сети будит демон (hotplug 95-steer, сторож), reload печатает набор заново, и устройство
в правилах новое; текст набора правил поэтому зависит и от таблицы маршрутов. Маршруты по умолчанию с несколькими
следующими узлами (multipath) в набор не попадают.