splify2
splify2

splify2#

Управляющий слой для маршрутизатора OpenWrt поверх ядра steer: выбранные сервисы идут через туннель на всех устройствах сети, остальное — напрямую. Интерфейс — страница LuCI (Сервисы → splify2), бэкенд — объект rpcd на shell; сам трафик маршрутизирует ядро steer (nftables и таблицы маршрутизации ядра Linux), splify2 пишет ему спеку и показывает состояние.

Telegram Поддержать проект

Какое ядро нужно#

splify2 26.11 работает с ядром steer 2.1.0 или новее — это пакет steer-core. Протоколы и виды выходов в ядре 2.1 — его плагины: vless, hysteria2, proxy (Trojan, Shadowsocks, SOCKS, HTTP, VMess), xsteer, obfs (WireGuard поверх поддельного TCP), awg (свой туннель WireGuard или AmneziaWG) и warpbox (WARP) лежат в самом пакете ядра и ставятся без сети; мост Telegram (tgws) и warpbox-ui — из репозитория splify2-extended-plugins. Выход без своего плагина ядро показывает недоступным.

Ядро старее 2.1.0 карточка ядра в «Настройки → Интерфейс» называет «Ядро устарело»: изменения на нём не применяются, плагины не ставятся — менеджер плагинов есть только в ядре 2.1. Карточка ставит и обновляет ядро: пакет steer-core и затем недостающие плагины протоколов — отмеченные и нужные выходам спеки. При первой установке протоколы выбираются галочками, по умолчанию VLESS, Hysteria2 и протоколы прокси. Ставит ядро плагин updater: без него в карточке остаются ссылка на выпуски и команда установщика.

Если на роутере стоит steer-box-connector (sing-box для podkop и forkop на ядре steer), ядро ведёт он: splify2 пишет «Ядро занято: podkop» (или forkop; если нет ни того, ни другого — steer-box-connector), не запускает службу steer, не применяет настройки и не трогает пакеты ядра. Коннектором splify2 не управляет.

Что умеет#

Правила. Правило — «что» + «кого касается» + «куда». «Что» — сервисы каталога и свои списки (домены и подсети, текстом, ссылкой или файлом), либо весь трафик. «Кого» — вся сеть либо выбранные устройства (по MAC из аренд DHCP или по адресу, подсети, диапазону a-b — IPv4 и IPv6). «Куда» — выход. Список читается сверху вниз, побеждает первое совпадение: исключение («Напрямую») должно стоять выше туннельных правил. Правило можно выключить, не удаляя; у правила с доменами выбираются режим (поддельные или настоящие адреса) и свой сервер DNS (из раздела «DNS» — сервер или несколько серверов — или адресом прямо в правиле), а в режиме поддельных адресов — порт назначения: соединения к этим доменам уходят на него вместо запрошенного.

Первая настройка. На роутере без правил главная предлагает мастер «Настроим splify2» в три шага: через что пустить трафик (подписка VPN, свой туннель файлом или текстом, туннель роутера), что пустить и каким DNS спрашивать — и первое правило готово; «Пропустить» закрывает мастер. На пустой главной есть и карточка быстрого старта: вставьте ссылку подписки — выход на её узлах создастся сам; отметьте плитки (YouTube, Discord, Telegram, нейросети или весь трафик) — правила запишутся и применятся. Плитка есть, только если каталог знает такой сервис; «Не сейчас» прячет карточку насовсем. Оба выключаются в настройках плагина andromeda.

Весь трафик устройства — в VPN. На экране правил кнопка «Устройство целиком в VPN»: выберите устройство из списка (в правило ложится MAC) или введите его адрес и выберите выход — всё, что устройство отправляет в интернет, идёт через выход. Свою сеть это не затрагивает: роутер и соседи по дому остаются доступны. Подсеть и диапазон адресов не подходят — только одно устройство.

Как применяются настройки. Кнопок «Сохранить» и «Применить» в панели нет: правка записывается на роутер сама, а применяет её сам роутер — плагин autoapply — через секунду после последней правки, даже если страницу уже закрыли. Правки подряд уходят одним применением. Пока роутер применяет, сверху стоит «Применение…»; потом — «Применено: N изменений» со списком, у каждой строки «Отменить», над списком «Отменить всё». Записанное и не применённое (отказ ядра, восстановление из архива, другое окно) называется «Ждёт применения» и показывает, что изменится; роутер доприменяет его сам раз в пять минут. Отвергнутое ядром не повторяется, пока вы не поменяете настройки: строка говорит «Не применено, роутер работает по прежним настройкам» и причину словами ядра. Удалённое правило или выход возвращается кнопкой «Вернуть» в сообщении. Если настройки на роутере поменяли за спиной страницы (вторая вкладка, ssh), страница сливает свои правки с лежащими и говорит об этом, а не затирает чужое.

Пауза, доприменение и само автоприменение — настройки плагина autoapply. Выключите его — применять будет открытая страница панели (через 0,8 с после последней правки); в базовом виде — кнопка «Применить».

Правило = что перенаправляем + кого касается + куда. Читается сверху вниз, побеждает первое совпадение

VPN (раздел «VPN» — один и под LuCI, и в приложении для компьютера). Здесь только добавляют: сверху ссылки подписок — добавить, обновить, удалить; ниже «Свои туннели», «Узлы и автообновление» (узлы подписок, ссылки узлов через пробел — vless://, hysteria2://, trojan://, ss://, socks://, vmess://, прокси http(s)://адрес:порт; у подписки по ссылке остаток трафика и свой период автообновления) и XSTEER. Какие конфигурации взять и как выбирать между ними — решает правило.

Свой туннель файлом. В «VPN → Свои туннели» и в мастере первой настройки — «Добавить туннель»: имя и файл WireGuard или AmneziaWG ([Interface] и [Peer]), который выдал сервер, — файлом или вставленным текстом. Устройство туннеля заводит ядро steer (выход kind: awg), в настройки сети роутера идти незачем. Нужен плагин ядра awg: панель ставит его сама («Ставим модуль туннеля…»), а он — модуль ядра Linux kmod-amneziawg или kmod-wireguard из репозитория пакетов, поэтому роутеру при этом нужен интернет. Файл лежит в /etc/steer/awg/<имя>.conf, закрытый от чтения (0600); приватный ключ не показывается и не попадает в сообщения об ошибках. Туннель с тем же именем уже есть — отказ «Туннель … уже есть — выберите другое имя»: ключи добавленного туннеля другой файл не заменит; имя другого выхода — «Имя … занято другим выходом». Удалить туннель можно, когда его не читает ни сохранённая, ни применённая спека. Туннели, уже заведённые в сети роутера (WireGuard, AmneziaWG, OpenVPN), включаются переключателем в «Туннели роутера».

XSTEER. Новый туннель добавляется ссылкой xs:// от хаба: интерфейс с протоколом xsteer splify2 заводит в сети роутера сам и запоминает, что завёл его он. Имя, занятое интерфейсом другого протокола, — отказ.

Куда (блок в правиле). Правило само собирает свой выход: подписки — «Авто» (любой рабочий узел протокола) или отдельные конфигурации с проверкой задержки; WARP (нужны плагины warpbox и warpbox-ui); свои туннели; либо «Блок» и «Напрямую». У подписок и своих туннелей — способ выбора: «Самый быстрый», «Первый живой» (по порядку отметок), «Вручную» (один) и «Раздача» (новые соединения делятся между выбранными). Несколько блоков сразу — выход «первый живой» над ними в порядке: подписки, WARP, свои туннели. Одинаковые наборы у правил — один общий выход (под блоком сказано, с каким правилом он общий); правка набора у такого правила заводит ему свой выход, остальные остаются как были.

У подписок в «Куда» — страны узлов: «Только эти страны» и «Кроме этих стран» (флажки по странам узлов подписок; страна узла — флаг в его имени). Страна не бывает в обоих списках: отметка в одном снимает её в другом. Ядро берёт узлы только отмеченных стран и не берёт узлы исключённых, в том числе новые после обновления подписки; при «Самом быстром» меряются только они. Для режима «Вручную» (один узел) выбора стран нет. Под подписками видна страна, которую видят сайты через выход (проверка выхода с роутера, плагин node-check); если она разошлась с флагом в имени узла — предупреждение с обеими странами.

Выход в спеке остаётся обычным: пул, группа, туннель по подписке (VLESS — плагин vless, hysteria2 — hysteria2, trojan, shadowsocks, socks, HTTP, vmess — proxy), свой туннель awg, WARP, tgws. Бейджи конфигурации — протокол (VLESS, Hysteria2, Trojan, Shadowsocks, VMess, SOCKS, HTTP, xsteer, WireGuard, AmneziaWG), транспорт, защита и особенности узла — стоят у пилюль узлов и у выходов на главной.

Фаервол. Зоны и пробросы для выходов и клиентов splify2 заводит сам и убирает, когда они больше не нужны, — только то, что завёл он (записано в /etc/splify2/fw-owned). Устройства туннелей без своей зоны попадают в зону steer_zone, устройства клиентов без зоны — в steer_clients. Проброс в зону туннелей идёт из настоящих зон устройств клиентов, а наружу — в настоящую зону внешней сети, как бы они ни назывались; не нашлась зона внешней сети — проброса нет, и splify2 об этом говорит. Туннель, который вы положили в свою зону, в ней и остаётся: splify2 саму зону не меняет, а заводит в неё проброс из зоны клиентов.

DNS (раздел «DNS»). Серверы встроенного резолвера ядра: DoH, DoT, DoQ, DoH3 (адрес h3://имя[/путь]) и обычный DNS (по UDP или TCP), для каждого выход, через который уходит запрос, адреса сервера и серверы для разрешения его имени; кэш ответов и сроки хранения в нём, режим доменных правил; состояние серверов и кэша берётся из журнала резолвера.

«Для имён под правилами» и «Для остальных сайтов» выбирается одно из трёх: DNS роутера, один сервер или несколько из уже добавленных. Несколько серверов спрашиваются «По очереди» — следующий, когда предыдущий отказал или молчит полторы секунды; отказавший на время уходит в конец и потом проверяется снова, — или «Сразу все», и ответ берётся первый годный. Порядок серверов задаётся стрелками; видно, кого спросят первым и кто сейчас не отвечает. Сайты вне правил без выбора спрашиваются у DNS роутера; с выбранным сервером имена своей сети (имена устройств, .lan, обратные зоны) всё равно остаются у DNS роутера, а если сервер не отвечает, ответ даёт DNS роутера — интернет не пропадает. В правиле сервер DNS выбирается и из групп нескольких серверов.

У сервера DoT и DoH (tls://, https://) — в разделе и у своего сервера в правиле — есть выключатель «Делить первый пакет»: он пишет fragment: true; при смене адреса на другой вид (udp, tcp, quic, h3) ключ снимается.

Выключатель «Клиенты Tailscale и ZeroTier» (dns.mesh_clients) заворачивает запросы DNS клиентов mesh-VPN (устройства tailscale* и zt*) на резолвер ядра, и доменные правила действуют на этих клиентов. Нужна и настройка самой сети: Tailscale-клиент спрашивает свой MagicDNS, и до роутера запрос доходит, только если сеть выдаёт клиентам адрес роутера как сервер имён; ZeroTier — то же через DNS-сервер сети. Выключен — чужую сеть ядро не трогает.

Серверы, настроенные на самом роутере (dnsmasq, https-dns-proxy), splify2 не создаёт, не читает и не меняет.

Каталог и списки (плагин lists-catalog). Каталог сервисов приходит ссылкой (по умолчанию splify2-lists) и обновляется без переустановки; свои списки добавляются текстом, ссылкой или файлом (.lst, .txt или набор sing-box .srs), до 1 МБ на список. Списки, на которые ссылаются правила, обновляются раз в сутки; адресные подгоняются под свободную память роутера, а список, сократившийся при обновлении кратно, не заменяется — порог в настройках плагина.

Состояние. Главная: работает ли маршрутизация — по проверкам ядра и по выходам правил: выход правила не отвечает — заголовок «Выход не отвечает» и чей трафик остановлен или идёт напрямую; правила с трафиком, выходы с откликом и страной, остаток подписки, «Куда пойдёт запрос» (ответ ядра steer по живым правилам ядра Linux). Для групп — какой член несёт трафик. У выхода подписки — внешний адрес: IPv4, которым выход ходит наружу (по ответу https://1.1.1.1/cdn-cgi/trace, запрошенному через сам выход; по нему же страна). Адрес закрыт размытием и открывается значком глаза. У выходов и правил рядом со скоростью — график за последние минуты. Раздел «Диагностика» печатает приговоры ядра дословно, а ниже — журнал ядра с поиском.

Раздел «Запросы» — что ядро делает с трафиком прямо сейчас, в одном месте. «Имена»: какие имена спрашивали у резолвера ядра и какое правило, выход и узел им достались (или что имя идёт мимо правил), «Почему сюда» — ответ ядра для этого имени. «Соединения»: кто (имя из аренд DHCP или адрес), куда, через какой выход, по какому правилу и узлу. «Трафик»: скорость каждого выхода, график за сутки и сколько прошло с запуска; сколько унёс каждый клиент (если ядро Linux считает объём соединений). Поиск есть на каждой вкладке, «Пауза» останавливает обновление списка. История копится, пока панель открыта: время, когда её не было, на графике — пропуск, а не нули.

Вид у панели один: и под LuCI, и в приложении для компьютера — главная блоками, правила открываются с неё; на узком экране разделы — в нижней панели, которая прокручивается, если не помещается.

Обслуживание. Архив настроек (плагин backup: выгрузить и восстановить, в нём и настройки плагинов, и файлы своих туннелей), обновление ядра и самой панели (плагин updater), остановка всей маршрутизации одной кнопкой, splify2-purge (убрать следы), настройки переживают sysupgrade.

Упал узел — трафик на следующий; упали все — трафик останавливается, а не утекает мимо туннеля

Плагины#

Вкладка «Плагины» панели: каталог с поиском сверху, репозитории, установленные плагины карточками ниже. В карточке — выключатель, версия и репозиторий, «Обновлять автоматически», корзина с подтверждением и строка состояния; имя раскрывает настройки плагина. Плагин из чужого репозитория помечен «не официальный, splify2 за него не отвечает». Плагин, нужный выходам, снять нельзя — отказ называет эти выходы. В базовом виде то же — вкладка «Плагины».

Плагины ставит менеджер плагинов ядра steer подписанными архивами .s2p; подпись он проверяет ключами из пакета ядра. Подключены два официальных репозитория — splify2-core-plugins и splify2-extended-plugins (/etc/steer/plugins/repos.d/). Свой репозиторий добавляется адресом и ключом: панель показывает номер ключа — сверьте его с тем, что опубликовал автор. Плагины чужого репозитория работают на роутере с теми же правами, что и официальные.

Плагины из коробки — в семени пакета splify2 (/usr/share/splify2/seed/), ставятся при установке и обновлении пакета без сети; потом обновляются из репозитория. Что не встало, повторяется раз в десять минут (или сразу — командой splify2-seed); снятый вами плагин при обновлении пакета не возвращается.

Плагин Что делает
andromeda панель splify2 с этими экранами (Andromeda)
autoapply сохранённое применяет сам роутер
subscriptions автообновление подписок со своим периодом у каждой, остаток трафика, свои названия
lists-catalog каталог списков, свои списки, обновление раз в сутки
backup архив настроек
node-check проверка узлов подписок и страна выхода с роутера
group-check проверка членов групп выходов и история отказов
updater версии и установка ядра steer и splify2
lang-ru, lang-en русский и английский панели, базового вида и сообщений роутера

Без плагина его часть панели отвечает «нужен плагин» — остальное работает.

Базовый вид — запасная страница на обычном LuCI: обзор с состоянием ядра, формы разделов спеки, спека текстом с проверкой ядром, плагины и настройки. Открывается пунктом «Базовый вид» в меню разделов Andromeda или ?basic=1 в адресе; поле «Интерфейс» на его вкладке «Настройки» выбирает, какой вид открывать по умолчанию. Если Andromeda не встала или не загрузилась, на её месте открывается базовый вид.

Безопасный режим. Плагин сломал панель — откройте её с ?safe=1 в адресе: Andromeda загрузится без своих плагинов интерфейса. Плагин мешает работе роутера — создайте файл /etc/splify2/safe (touch /etc/splify2/safe): хуки, задачи по расписанию, события и замены методов всех плагинов выключаются, остаются каркас, менеджер плагинов и методы, вынесенные из каркаса в официальные плагины (каталог списков, архив настроек, подписки, страна выхода, версии и установка). Автоприменения в этом режиме нет — применяет открытая страница. Выход из режима — rm /etc/splify2/safe. Дальше плагин выключается или снимается во вкладке «Плагины».

Где что лежит#

Что Где
Спека ядра /etc/steer/spec.yaml (до первой записи панелью — /etc/steer/spec.json; прежний spec.json остаётся копией spec.json.bak)
Последняя применённая спека и предыдущая /etc/steer/spec.applied.json, /etc/steer/spec.prev.json
Подписки /etc/steer/subs/, /etc/steer/sub.txt
Списки /etc/steer/lists/
Свои туннели (kind: awg) /etc/steer/awg/<имя>.conf
Настройки панели /etc/config/splify2
Что splify2 завёл в фаерволе и в сети, какие плагины поставил из семени /etc/splify2/fw-owned, /etc/splify2/net-owned, /etc/splify2/seeded
Плагины, их состояние и настройки /usr/lib/steer/plugins/<id>/, /etc/steer/plugins/state.json, /etc/steer/plugins/conf/<id>/
Репозитории плагинов /etc/steer/plugins/repos.d/

Как откатить#

  • Правку — «Отменить» у строки в «Применено: N изменений» или «Отменить всё»; удалённое правило или выход — «Вернуть» в сообщении.
  • Все настройки — архивом: «Настройки → Дополнительно», архив настроек (плагин backup) выгружается файлом и восстанавливается из него.
  • Плагин — выключателем или корзиной в его карточке; сломавший панель — через безопасный режим (выше).
  • Версию ядра или панели — выбором версии в карточке ядра или обновления в «Настройки → Интерфейс».

Установка и обновление#

wget -O /tmp/splify2-install.sh https://raw.githubusercontent.com/splify2/splify2/main/install.sh && sh /tmp/splify2-install.sh

splify2 26.11 работает с ядром steer 2.1.0 или новее (пакет steer-core). Пакет splify2 зависит от luci-base, ip-full, curl (страна, внешний адрес и отклик выходов), ucode, ucode-mod-fs и ucode-mod-ubus. Если на роутере стоит splify первой версии, установщик находит её и говорит об этом до установки; сам он из первой версии ничего не удаляет и не переносит.

Если GitHub закрыт, роутер скачивает списки и пакеты через зеркало на GitLab и запасные хосты GitHub. Сразу через туннель: Настройки → Общее → Скачивать списки и обновления через туннель.

Обновление с 26.10#

Нажмите «Обновить» у панели. Панель увидит ядро 2.0.x и сама обновит его до 2.1 в фоне: ход виден на странице базового вида, плагины протоколов для ваших выходов, Andromeda и официальные плагины появятся после него. Нет сети — панель повторит сама раз в час, кнопка «Обновить ядро» повторяет сразу (пока плагины не встали, базовый вид говорит по-английски, и кнопка называется «Update the core»).

Установщик одной строкой обновляет и 2.0.x: спека, списки и подписки остаются на месте.

Ядро из прежней панели 26.10.x отдельно не обновляйте — сначала панель.

Полное удаление#

splify2-purge без ключей только показывает, что будет сделано; splify2-purge --yes убирает настройки, спеку, подписки, списки и файлы своих туннелей (/etc/steer), правила и зоны фаервола, заведённые splify2, записи расписания и следы прежних версий (splify2-purge --yes --keep-config оставляет настройки). Чужое — зона фаервола, настройка https-dns-proxy, интерфейсы с протоколом xsteer, заведённые в настройках сети, — остаётся, о каждом случае печатается строка; интерфейс xsteer, который панель завела из ссылки, и пробросы, которые она дописала в вашу зону фаервола, убираются. Плагины убирают свои следы сами. Пакеты команда не снимает, а называет команду пакетного менеджера. Если ядро ведёт steer-box-connector, ядро steer, его таблица nftables и пакеты ядра остаются: это не наше. Кнопка «Удалить splify2» в «Настройки → Интерфейс» делает то же и сама снимает пакеты splify2 и ядра steer (при steer-box-connector — только пакеты splify2).

Чего splify2 не делает#

  • Обход DPI (Zapret). Выход kind: zapret ядро не принимает. При обновлении выходы kind: zapret из спеки убираются, а правила, что вели в них, идут напрямую (direct); прежняя спека остаётся копией spec.json.zapret.bak. Установленные Zapret и Zapret Manager не снимаются, не читаются и не настраиваются.
  • Настройка https-dns-proxy. Пакет не зависимость и не настраивается; шифрованный DNS делает резолвер ядра. Уже установленный https-dns-proxy и его файл остаются как есть.

Ссылки#