Skip to content

Latest commit

 

History

History
52 lines (42 loc) · 5.54 KB

steer-api-1.2.md

File metadata and controls

52 lines (42 loc) · 5.54 KB

steer-api 1.2 — что добавлено к 1.1

Ядро 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 в слотах.

Службы steer.services[] работают

Раздел манифеста описан в 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

Слот Тип, хук Приоритет Место
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 наполняется

@wan_dev в файле nft плагина — устройства маршрутов по умолчанию таблицы main, IPv4 и IPv6 (ip route show default), как они лежат при печати набора правил. Раньше набор заводился пустым и правила по нему не совпадали. Сменился WAN — событие сети будит демон (hotplug 95-steer, сторож), reload печатает набор заново, и устройство в правилах новое; текст набора правил поэтому зависит и от таблицы маршрутов. Маршруты по умолчанию с несколькими следующими узлами (multipath) в набор не попадают.