Skip to content

Latest commit

 

History

History
185 lines (132 loc) · 17.1 KB

open.md

File metadata and controls

185 lines (132 loc) · 17.1 KB

Выборы без решения владельца

Здесь — места, где был настоящий выбор, а решения владельца (PLUGINS.md 1, 12; DIRECTIONS.md, «Решения владельца: платформа плагинов») не было. По каждому — что выбрано, почему и что было бы иначе. Владелец может перерешить любой пункт; номер О-N упоминается в остальных документах.

О-1. Общая библиотека протоколов: один плагин net1, wolfSSL внутри и скрыт

Выбрано. Стек 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).

О-2. libsteer-plugin.so.1 — загрузчик в ядре; плагин с ним не связывается

Выбрано. Таблица steer_host_v1 приходит плагину в init; .so экспортирует один символ и не имеет DT_NEEDED ни на какую libsteer*. libsteer-plugin.so.1 — библиотека steer-core с загрузчиком и таблицей, SONAME по major ABI.

Почему. Связь по символам привязала бы плагин к имени файла ядра или заставила бы держать второй список экспорта; таблица с полем size растёт без пересборки плагинов. Отдельный файл по major позволяет ядру 3.x держать .so ABI 1 через переходник.

О-3. Ось steer-core — только нижняя граница

Выбрано. compat.steer-core принимает лишь >=X.Y.Z. Почему. Тег «=версия ядра» снят (В10), но плагину бывает нужна правка ядра, вышедшая в конкретном выпуске, а не новая функция API. Верхней границы нет: несовместимость — дело major steer-api/steer-abi.

О-4. Ротация ключей: несколько блоков подписи, роль — по подписанному индексу

Выбрано. Файл подписи может нести несколько блоков usign; годится любой доверенный ключ нужной роли. Роль ключа архива (protocols/plugins) берётся из key_role подписанного индекса, ключи — по каталогам ролей в /usr/share/steer/keys/, отзыв — файл revoked там же. Почему. В8 говорит «ротация через keys/ в steer-core»; без двойной подписи на время перехода роутеры со старым ядром перестали бы принимать новые архивы, а без привязки роли разделение ключей ничего бы не давало.

О-5. Установка без подписи — только из файла, флагом, без автообновления

Выбрано. --unsigned только для локального файла; права те же (В6), красная плашка, автообновления нет. Почему. Разработчику плагина нужно ставить свою сборку, не заводя репозиторий; из сети без подписи — нет, это подмена на зеркале.

О-6. Одно пространство имён на роутере

Выбрано. id, виды, подкоманды и службы уникальны на роутере, а не <repo>/<id>. Второй плагин с занятым именем не ставится, отказ называет занявшего. Почему. Имя вида пишется в спеке человека, подкоманда — в командной строке; два vless из разных репозиториев сделали бы их неоднозначными. Каталог, объект ubus и цепочки nft строятся из id.

О-7. Хуки спеки — в одном шаге подготовки; load_spec не исполняет программ

Выбрано. 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 в каждом — медленно и недетерминированно. Хуки обязаны быть детерминированными, без сети и времени.

О-8. Плагинные виды — только в спеке v2

Выбрано. Спека v1 видов плагинов не знает; migrate переводит сохранённую v1 с протоколами в v2. Почему. Формат v1 заморожен (steer/src/kinds/kind.h:359-363 — «её формат заморожен»), а ключи у v1 и v2 местами разные (opts_file/strategy, sub_file/subscription, kind.h:155-161): два разбора на каждый плагин — лишняя поверхность.

О-9. Набор @wan_dev ведёт ядро

Выбрано. Ядро держит набор 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 и к имени интерфейса.

О-10. Автообновление: ночное окно, отказ от неудачной версии, закрепление

Выбрано. Проверка раз в сутки со случайным сдвигом и при подъёме WAN; установка — в окне 03:00–05:00 (настройка); отзыв по безопасности — сразу; неудачная версия попадает в bad_versions; человек может закрепить версию (pinned) или выключить автообновление плагина. Почему. В10 требует фона, но перезапуск помощника рвёт соединения выхода; закрепление — для того, кто чинит или проверяет.

О-11. sysupgrade сохраняет и сами плагины

Выбрано. keep.d/steer-plugins сохраняет /usr/lib/steer/plugins/ целиком, а не только state.json. Почему. После прошивки без сети плагины иначе пришлось бы брать из семени, а версии семени старее стоявших. Цена — архив sysupgrade больше на размер плагинов.

О-12. События программам — подпиской службы; разовый хук event

Выбрано. Частые реакции — служба, подписанная на сокет (STEER_CTL_SOCK); для редких — hooks.event (программа на событие). Предел подписчиков (прежний CTL_SUBS_MAX 8) снят.

О-13. Телефон и TUN без /dev/net/tun

Выбрано. API 1.0 резервирует STEER_TUN_FD (готовый дескриптор от ядра). На телефоне в 2.1 менеджера плагинов нет: сборка статическая (dlopen нет, steer/src/kinds/kind.c:110-114), протоколы вкомпилированы из исходников плагинов, как сейчас вкомпилированы модули. Плагины на Android — отдельный заход (ANDROID_AGENT_TASK.md хаба).

О-14. Раздела plugins: в спеке нет

Выбрано. Что стоит и включено — state.json, настройки плагина — conf/<id>/, службы плагина (recheck) включаются включением плагина. Почему. Спека описывает маршрутизацию; её пишет и применяет и коннектор, которому нет дела до плагинов splify2.

О-15. steer-core 2.1.0 конфликтует со splify2 < 26.11

Выбрано. conflicts: splify2<26.11. Почему. splify2 26.10 ставит пакеты steer-<m>, которых больше нет, и показывал бы модули «не установлены» без способа поставить. Проверить на стенде, что apk 3.0.5 и opkg принимают конфликт с версией.

О-16. HTTP-клиент менеджера — из wbhttps.c, а не из subfetch.c

Выбрано. 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), своего клиента в нём нет.

О-17. Диапазоны ресурсов

Выбрано. Очереди NFQUEUE — от 4300 вверх, порты — от 10480 вверх (вне рядов ядра 8480… и 9480…, steer/src/profile/profile.c:19-23), биты метки — вне поля steer и известных соседей. Номер выдаётся раз и хранится в alloc.json. Почему. Нынешние зашитые 4340/4341 (splify2) и 4350/4351 (recheck) попадают в ряд и при переходе освобождаются.

О-18. tgws — вид плагина с шаблоном nft; obfs — помощник по имени подкоманды

Выбрано. Правило моста tgws (steer/src/kinds/tgws.c:115-128) выражается шаблоном nft вида в слоте prerouting-dnat; помощник obfs вида interface ищется по имени подкоманды в реестре плагинов, как сейчас по CMD_MOD (steer/src/daemon/helpers.c:96-106). Почему. Так ни один протокол не остаётся кодом в ядре (В3), а interface — вид ядра.

О-19. Слоты nft — цепочки ядра с постоянными приоритетами; файл nft — подмножество синтаксиса

Выбрано. Десять слотов с приоритетами из таблицы steer-api.md 5.2; файл плагина — set/map/chain <слот>, ядро переименовывает в p_<id>_*/plugin_<id>_*. Почему. Плагин не угадывает числа и не может сломать чужие объекты таблицы; всё идёт одной транзакцией с набором steer и общей проверкой.

О-20. evline: число полей не ограничено; awg → revive; состояние — файлом

Выбрано. Снять EVLINE_MAXFIELDS 6 и EVLINE_KEYLEN 16 (steer/src/lib/evline.h:126-127); событие awg переименовать в общее revive (старое имя принимается до API 2.0); состояние для status — файлом и событием state, а не строкой: строка ограничена PIPE_BUF.

О-21. Переводы хоста — JSON-словари с шаблонами

Выбрано. Плагин языка несёт i18n/host/<язык>.json с ключами ns.key; функции-строки панели (ui/src/copy/ru.ts:12, 30) записываются шаблоном с {0} и формами множественного числа; русский остаётся вшитым. Почему. В9 делает переводы плагинами; код в словаре был бы JS сторонних авторов в каждом языке.

О-22. Семя больше прежней оценки

С переездом стека в net1 (О-1) семя несёт и библиотеку: больше ≈0,57 МБ из PLUGINS.md 7.4 — ориентир порядка 1–2 МБ без сжатия на x86-64. Решение «не экономить флеш» (CLAUDE.md хаба) это допускает; точное число — после сборки net1.

О-23. Поправка к pack() сборки steer

pack() берёт в provides только первое имя «заменяет» (steer/build.sh:548-551). Переход на 2.1.0 требует provides на каждое прежнее имя пакета — правка в задачах упаковки (migration-2.1.md, 2).

О-24. stgws: варианты плагина и мини-ядро без steer-core

Сделано иначе (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 этот заход не читал (нет доступа).