Здесь — места, где был настоящий выбор, а решения владельца (PLUGINS.md 1, 12; DIRECTIONS.md, «Решения владельца: платформа плагинов») не было. По каждому — что выбрано, почему и что было бы иначе. Владелец может перерешить любой пункт; номер О-N упоминается в остальных документах.
Выбрано. Стек TUN, транспорты, TLS 1.3, REALITY, HTTP/2, QUIC и wolfSSL для протоколов — один
плагин-библиотека net1 с одной libs2p-net.so.1; wolfSSL вкомпилирован в неё со скрытыми символами,
экспорт — только s2p_*. Ядро держит свою копию TLS/QUIC и libsteer-wolfssl.
Почему. Решение владельца — одна общая зависимость вместо копий; открытым оставалось, сколько
библиотек и как. Отдельная libs2p-wolfssl.so экспортировала бы wolfSSL_*, совпадающие по именам с
libsteer-wolfssl ядра, а musl версий символов не различает: в процессе steerd вызовы ушли бы не в ту
копию. Ядро не может брать TLS у net1: менеджер скачивает первый плагин, когда плагинов нет, и
обновление net1 в фоне не должно ронять DNS роутера (DoH/DoQ в резолвере, steer/build/sources.mk:120-124).
Иначе. Протоколы на libsteer-wolfssl ядра — нельзя: SONAME несёт версию wolfSSL
(steer/build/build-libs.sh:156-163), протоколы ломались бы с каждым обновлением ядра (В10).
Выбрано. Таблица steer_host_v1 приходит плагину в init; .so экспортирует один символ и не
имеет DT_NEEDED ни на какую libsteer*. libsteer-plugin.so.1 — библиотека steer-core с загрузчиком
и таблицей, SONAME по major ABI.
Почему. Связь по символам привязала бы плагин к имени файла ядра или заставила бы держать второй
список экспорта; таблица с полем size растёт без пересборки плагинов. Отдельный файл по major позволяет
ядру 3.x держать .so ABI 1 через переходник.
Выбрано. compat.steer-core принимает лишь >=X.Y.Z. Почему. Тег «=версия ядра» снят (В10), но
плагину бывает нужна правка ядра, вышедшая в конкретном выпуске, а не новая функция API. Верхней
границы нет: несовместимость — дело major steer-api/steer-abi.
Выбрано. Файл подписи может нести несколько блоков usign; годится любой доверенный ключ нужной
роли. Роль ключа архива (protocols/plugins) берётся из key_role подписанного индекса, ключи — по
каталогам ролей в /usr/share/steer/keys/, отзыв — файл revoked там же. Почему. В8 говорит
«ротация через keys/ в steer-core»; без двойной подписи на время перехода роутеры со старым ядром
перестали бы принимать новые архивы, а без привязки роли разделение ключей ничего бы не давало.
Выбрано. --unsigned только для локального файла; права те же (В6), красная плашка, автообновления
нет. Почему. Разработчику плагина нужно ставить свою сборку, не заводя репозиторий; из сети без
подписи — нет, это подмена на зеркале.
Выбрано. id, виды, подкоманды и службы уникальны на роутере, а не <repo>/<id>. Второй
плагин с занятым именем не ставится, отказ называет занявшего. Почему. Имя вида пишется в спеке
человека, подкоманда — в командной строке; два vless из разных репозиториев сделали бы их
неоднозначными. Каталог, объект ubus и цепочки nft строятся из id.
Выбрано. check, expand, pre_apply — в шаге spec_prepare (apply-plan, check, reload, старт
демона); итог кэшируется в /etc/steer/plugins/cache/spec.prepared.json по ключу. Почему. Спеку
читают больше десяти мест (status, diag, explain, сторож, супервизор — load_spec в
steer/src/daemon/*.c), fork/exec в каждом — медленно и недетерминированно. Хуки обязаны быть
детерминированными, без сети и времени.
Выбрано. Спека v1 видов плагинов не знает; migrate переводит сохранённую v1 с протоколами в v2.
Почему. Формат v1 заморожен (steer/src/kinds/kind.h:359-363 — «её формат заморожен»), а ключи у v1
и v2 местами разные (opts_file/strategy, sub_file/subscription, kind.h:155-161): два разбора на
каждый плагин — лишняя поверхность.
Выбрано. Ядро держит набор wan_dev в своей таблице — устройства маршрутов по умолчанию таблицы
main (v4 и v6), обновляет по netlink. Почему. recheck нужен WAN (oifname "$_wan",
recheck/integration/openwrt/root/usr/lib/recheck/recheck.sh:94-120), а понятия WAN в ядре нет; брать
его у netifd (network.wan) значило бы привязать ядро к OpenWrt и к имени интерфейса.
Выбрано. Проверка раз в сутки со случайным сдвигом и при подъёме WAN; установка — в окне 03:00–05:00
(настройка); отзыв по безопасности — сразу; неудачная версия попадает в bad_versions; человек может
закрепить версию (pinned) или выключить автообновление плагина. Почему. В10 требует фона, но
перезапуск помощника рвёт соединения выхода; закрепление — для того, кто чинит или проверяет.
Выбрано. keep.d/steer-plugins сохраняет /usr/lib/steer/plugins/ целиком, а не только
state.json. Почему. После прошивки без сети плагины иначе пришлось бы брать из семени, а версии
семени старее стоявших. Цена — архив sysupgrade больше на размер плагинов.
Выбрано. Частые реакции — служба, подписанная на сокет (STEER_CTL_SOCK); для редких — hooks.event
(программа на событие). Предел подписчиков (прежний CTL_SUBS_MAX 8) снят.
Выбрано. API 1.0 резервирует STEER_TUN_FD (готовый дескриптор от ядра). На телефоне в 2.1
менеджера плагинов нет: сборка статическая (dlopen нет, steer/src/kinds/kind.c:110-114), протоколы
вкомпилированы из исходников плагинов, как сейчас вкомпилированы модули. Плагины на Android — отдельный
заход (ANDROID_AGENT_TASK.md хаба).
Выбрано. Что стоит и включено — state.json, настройки плагина — conf/<id>/, службы плагина
(recheck) включаются включением плагина. Почему. Спека описывает маршрутизацию; её пишет и
применяет и коннектор, которому нет дела до плагинов splify2.
Выбрано. conflicts: splify2<26.11. Почему. splify2 26.10 ставит пакеты steer-<m>, которых
больше нет, и показывал бы модули «не установлены» без способа поставить. Проверить на стенде, что apk
3.0.5 и opkg принимают конфликт с версией.
Выбрано. HTTPS-клиент ядра — wb_https (steer/src/proto/warp/wbhttps.h:35, сейчас в STACK_SRC,
steer/build/sources.mk:213-214), переносится в src/lib. Поправка к PLUGINS.md 3.1: там сказано,
что HTTP/1.1-клиент есть у модуля vless в subfetch.c; на деле subfetch.c качает внешними curl,
uclient-fetch или wget (steer/src/proto/vless/subfetch.c:375-395, 520-540), своего клиента в нём нет.
Выбрано. Очереди NFQUEUE — от 4300 вверх, порты — от 10480 вверх (вне рядов ядра 8480… и 9480…,
steer/src/profile/profile.c:19-23), биты метки — вне поля steer и известных соседей. Номер выдаётся раз
и хранится в alloc.json. Почему. Нынешние зашитые 4340/4341 (splify2) и 4350/4351 (recheck)
попадают в ряд и при переходе освобождаются.
Выбрано. Правило моста tgws (steer/src/kinds/tgws.c:115-128) выражается шаблоном nft вида в слоте
prerouting-dnat; помощник obfs вида interface ищется по имени подкоманды в реестре плагинов, как
сейчас по CMD_MOD (steer/src/daemon/helpers.c:96-106). Почему. Так ни один протокол не остаётся
кодом в ядре (В3), а interface — вид ядра.
Выбрано. Десять слотов с приоритетами из таблицы steer-api.md 5.2; файл плагина — set/map/chain <слот>, ядро переименовывает в p_<id>_*/plugin_<id>_*. Почему. Плагин не угадывает числа и не
может сломать чужие объекты таблицы; всё идёт одной транзакцией с набором steer и общей проверкой.
Выбрано. Снять EVLINE_MAXFIELDS 6 и EVLINE_KEYLEN 16 (steer/src/lib/evline.h:126-127);
событие awg переименовать в общее revive (старое имя принимается до API 2.0); состояние для status —
файлом и событием state, а не строкой: строка ограничена PIPE_BUF.
Выбрано. Плагин языка несёт i18n/host/<язык>.json с ключами ns.key; функции-строки панели
(ui/src/copy/ru.ts:12, 30) записываются шаблоном с {0} и формами множественного числа; русский
остаётся вшитым. Почему. В9 делает переводы плагинами; код в словаре был бы JS сторонних авторов в
каждом языке.
С переездом стека в net1 (О-1) семя несёт и библиотеку: больше ≈0,57 МБ из PLUGINS.md 7.4 —
ориентир порядка 1–2 МБ без сжатия на x86-64. Решение «не экономить флеш» (CLAUDE.md хаба) это
допускает; точное число — после сборки net1.
pack() берёт в provides только первое имя «заменяет» (steer/build.sh:548-551). Переход на 2.1.0
требует provides на каждое прежнее имя пакета — правка в задачах упаковки
(migration-2.1.md, 2).
Сделано иначе (steer 2.1, ветка tgws-plugin). Плагин tgws — один, статическая программа со своим TLS под
супервизором steerd (репозиторий splify2-extended-plugins, исходник — steer/plugins/tgws); вариантов и мини-ядра
нет, мини-сборка stgws из дерева steer снята. Ниже — прежнее предложение, на случай если мини-роутеры без
steer-core понадобятся снова.
Предлагалось. Плагин tgws выходит вариантами full (на net1) и lite (статический stgws), у
lite есть standalone: на мини-роутере без steer-core он сам себе ядро и сам обновляет только
себя из официального индекса. Переход — переходным выпуском пакета stgws (правка brb), который ставит
плагин и снимает себя; конфликт steer-core ↔ stgws в пакетах не объявляется, чтобы migrate успел
перенести настройки. Почему. Решение владельца — stgws становится плагином и обновляется в фоне; на
4/32 steer-core (steerd и библиотеки — около двух мегабайт на x86-64 сегодня, steer/build/libs/x86_64/)
не помещается, а менеджер живёт в steer-core. Иначе. Четвёртый пакет «мини-ядро» — против решения
«три пакета»; или оставить мини-роутеры без обновлений — против решения владельца. Что сверить:
пакет и настройки stgws в /root/brb этот заход не читал (нет доступа).