github Leadaxe/LxBox v2.24.4
LxBox v2.24.4
on GitHub

latest releases: v2.25.20, v2.25.19, v2.25.19-rc.3...
one month ago

L×Box v2.24.4

A one-fix patch. Opening the JSON tab of a DNS server that comes from a
template or a preset showed “This section failed” instead of the server
(#143). It is a regression of
v2.24.0: the storage format moved to records 1.0 and the model lost its direct
serialization, but this tab still encoded the model as is. Servers you added
yourself were not affected. Nothing else changed since v2.24.3; the v2.24.3 notes are included below, since that release has no page of its own.

Патч с одним исправлением. Вкладка JSON у DNS-сервера из шаблона или
пресета показывала «В этом разделе произошла ошибка» вместо содержимого
(#143). Это регрессия v2.24.0:
формат хранения перешёл на записи 1.0, у модели не осталось прямой
сериализации, а вкладка по-прежнему кодировала модель как есть. Серверы,
добавленные вручную, затронуты не были. Больше с v2.24.3 ничего не менялось; описание v2.24.3 приведено ниже — своей страницы у того релиза нет.

🇬🇧 English

🩹 JSON tab of a template/preset DNS server (#143, docs/spec/tasks/458)

  • Was: for a DNS server of kind template or preset the JSON tab failed on
    open with Converting object to an encodable object failed: Instance of 'DnsServerTemplate' in Debug → Logs. The tab's “storage shape” block handed
    the controller's snapshot straight to the JSON encoder; since v2.24.0 the
    model has no toJson, the storage record is produced by a codec. The
    sibling tab of the rule editor was moved to the codec back then, this one
    was missed. Affected: v2.24.0 through v2.24.3.
  • Now: the block is built by the same codec and shows the record exactly as
    it sits in lxbox_settings.json (kind/tag/vars for a template,
    kind/ref for a preset). The resolved body preview below it and the
    editable JSON of an inline server are unchanged.

🧪 Tests

  • A widget test of the tab for both kinds; it is red without the fix.
  • flutter analyze clean over the whole project, the full test suite, four
    l10n checkers and the docs parity check green.

🇷🇺 Русский

🩹 Вкладка JSON у DNS-сервера из шаблона или пресета (#143, docs/spec/tasks/458)

  • Было: у DNS-сервера вида template или preset вкладка JSON падала при
    открытии, в Отладка → Логи: Converting object to an encodable object failed: Instance of 'DnsServerTemplate'. Блок «storage shape» вкладки
    отдавал снимок контроллера прямо в JSON-кодировщик; с v2.24.0 у модели нет
    toJson, запись хранения строит кодек. Парную вкладку редактора правил
    тогда перевели на кодек, эту пропустили. Затронуты v2.24.0 – v2.24.3.
  • Стало: блок строится тем же кодеком и показывает запись в том виде, в
    каком она лежит в lxbox_settings.json (kind/tag/vars у шаблона,
    kind/ref у пресета). Превью отрезолвленного тела ниже и редактируемый
    JSON inline-сервера не менялись.

🧪 Тесты

  • Виджет-тест вкладки для обоих видов; без фикса красный.
  • flutter analyze чист по всему проекту, полный набор тестов, четыре
    l10n-чекера и проверка паритета доков зелёные.

Also in this build: v2.24.3 / В этой сборке также: v2.24.3

v2.24.3 (17.09.2026) was tagged and shipped to Google Play, but its GitHub
release page was never published: the asset upload to GitHub failed on every
attempt. v2.24.4 is built on top of it, so everything below is in these APKs.

v2.24.3 (17.09.2026) получил тег и ушёл в Google Play, но страница релиза на
GitHub так и не была опубликована: загрузка файлов на GitHub падала при каждой
попытке. v2.24.4 собран поверх него, поэтому всё ниже есть в этих APK.

v2.24.3 — release notes / описание релиза

The node editor stops losing what you type. A NaïveProxy node with its own
root certificate in tls.certificate used to lose that field on Save, because
the TLS model knew six fields and dropped the rest (#140).
Now the model carries every TLS key the core knows, and the editor itself is
rebuilt around the source: the Source tab is the node's original text and the
only place you edit, the JSON tab shows what the core will receive. A node
whose source is a sing-box JSON object goes to the core verbatim, checked by the
core on Save. WireGuard .conf files are stored as files again, tag aside. The
core moves to v1.14.1-lx.4: TLS fragmentation finally applies to REALITY, and
REALITY gets a per-node key_share choice between the hybrid post-quantum
ClientHello and the classical one.

Редактор узла перестал терять то, что вы вписали. Узел NaïveProxy со своим
корневым сертификатом в tls.certificate терял это поле на Save: модель TLS знала
шесть полей, остальное отбрасывала (#140).
Теперь модель несёт все TLS-ключи ядра, а сам редактор перестроен вокруг
источника: вкладка Source — исходный текст узла и единственное место правки,
вкладка JSON — то, что получит ядро. Узел, чей источник — sing-box JSON,
уходит в ядро дословно, с проверкой ядром при сохранении. WireGuard .conf
снова хранится как файл, тег отдельно. Ядро поднято до v1.14.1-lx.4:
TLS-фрагментация наконец действует на REALITY, а у REALITY появился по-узловой
выбор key_share между гибридным постквантовым ClientHello и классическим.

🇬🇧 English

🔐 TLS fields survive the node editor (#140, docs/spec/tasks/454)

  • Was: the TLS model carried server_name, alpn, insecure, utls,
    reality and the public-key pin. Anything else in a node's tls block —
    certificate, certificate_path, min_version, cipher_suites,
    client_certificate, fragment — was dropped silently on Save, for every
    protocol. NaïveProxy was trimmed further, to enabled + server_name, so a
    self-signed server could not be reached at all: insecure is rejected by
    the core on naive.
  • Now: the model carries the full OutboundTLSOptions of the core. Keys the app
    does not reason about pass through in the form they arrived — a string stays
    a string, an array stays an array. Naive keeps certificate and
    certificate_path on top of the two it had; everything the core rejects on
    naive is still trimmed. The pin certificate_public_key_sha256 is now read
    from sing-box JSON too. A value of the wrong type drops the field, not the
    node. Nodes without the new fields emit byte-for-byte as before. The
    allowlist is shared with the launcher (contract TASKS_LXBOX §22).
  • Alongside: a node imported from JSON used to lose everything the share-URI
    cannot carry when moved into a folder or copied as a link — it was rebuilt
    through toUri(). It now keeps its own outbound object as its source.

📝 Node editor: Source and JSON tabs (docs/spec/tasks/455)

  • Was: the JSON tab showed the model's re-emission of the node, and Save wrote
    that copy over the original. Whatever the model did not know was gone.
  • Now: Source is the stored text of the node — a link, a WireGuard config
    or a sing-box JSON object — and the only place you edit; Save writes it as
    is (the Tag field goes into the link's fragment or the JSON body). JSON
    is read-only: what the core will receive. A node whose source is a JSON
    object goes into the config verbatim, including keys the app does not know;
    the core validates it on Save (Libbox.checkConfig), a rejected body is not
    stored and the core's message is shown. Edit JSON replaces the source
    with the shown JSON after a warning and takes you to Source; there is no way
    back to a link. Storage is unchanged: the kind of the source is derived from
    the text, there is no flag — the same rule the launcher applies to a manual
    object.

📄 WireGuard .conf is stored as the file (docs/spec/tasks/456)

  • Was: an imported INI was converted into a synthetic wg://…#name link and
    that link was stored as the source — comments and line order were lost, the
    record kind was uri.
  • Now: the source is the INI text byte for byte, the record kind is wg_ini
    (as in the launcher) and the tag is a record field applied on read. The
    initial name comes from the comment right under [Peer] (Proton writes
    # CH-FREE#11 there), else the file name, else WireGuard. An Amnezia
    vpn:// link gives each node its own INI. Records made earlier keep reading
    as before.
  • Two regressions caught on the way and fixed: the auto-emoji was lost on INI
    nodes, and a Tailscale node lost its body when moved into a folder.

⚙️ Core v1.14.1-lx.4 and REALITY key_share (docs/spec/tasks/457)

  • tls.fragment and tls.record_fragment now apply to REALITY nodes (core
    SPEC 088). Before, the REALITY client built its handshake on the bare socket
    and skipped both, including the automatic record_fragment the core enables
    under a detour; the global fragmentation toggle looked on and did nothing
    there. Nothing changed in the app — the toggle simply works now.
  • New per-node option tls.reality.key_share (core SPEC 089). hybrid
    requires X25519MLKEM768: the ClientHello grows to ~1.5–1.9 KB and leaves
    in two TCP segments — Xray servers from v26.9.8 demand it. classical
    strips the hybrid from key_share and supported_groups: ~0.5 KB, one
    segment — for older servers and for networks that drop the big handshake.
    Unset means whatever the fingerprint carries, as before. Set it in sing-box
    JSON or as key_share= in a vless/anytls share link; a value outside the
    pair is dropped silently and the node stays alive, because the core would
    reject the whole config on it. The URI parameter name is shared with the
    launcher.
  • Wire format, AAR tag sets and toolchain unchanged; the Java surface is
    identical to lx.3 (javap over all 253 classes — empty diff).

🔧 TCP keep-alive per node (docs/spec/tasks/453)

  • Was: the core accepts disable_tcp_keep_alive, tcp_keep_alive and
    tcp_keep_alive_interval since 1.13, but the app did not know them and
    dropped them on Save.
  • Now: the fields are part of the node and travel in all three forms it is
    stored and shared in — sing-box JSON, share-URI and Xray JSON (sockopt,
    whole seconds; a negative value means keep-alive off). Nine carriers, the
    protocols that dial over TCP; QUIC/UDP nodes have no socket to apply them
    to. A value that is not a Go duration is dropped on input. Nodes without the
    fields emit byte-for-byte as before. No form fields — the JSON tab and
    import only.

🧪 Tests

  • 4846 tests green, flutter analyze clean over the whole project, four l10n
    checkers and the docs parity check at zero.
  • New: TLS passthrough (naive from #140, the full allowlist on vless, wrong
    types, ech, byte parity, QUIC), verbatim body in the build, the core check
    payload, INI name from the [Peer] comment, wg_ini records with a tag,
    key_share round-trips and guards.
  • Core bump verified by a javap diff of the AAR (empty) and by the version
    string inside the built APK (1.14.1-lx.4).
  • Device verification of the naive certificate path and of key_share is
    still pending — please report on the issue if something does not behave.

🇷🇺 Русский

🔐 TLS-поля переживают редактор узла (#140, docs/spec/tasks/454)

  • Было: модель TLS держала server_name, alpn, insecure, utls,
    reality и пин публичного ключа. Всё остальное в блоке tls узла —
    certificate, certificate_path, min_version, cipher_suites,
    client_certificate, fragment — молча отбрасывалось на Save, для любого
    протокола. NaïveProxy резался ещё сильнее, до enabled + server_name, и
    до сервера с самоподписанным сертификатом было не достучаться: insecure
    ядро на naive отвергает.
  • Стало: модель несёт полный OutboundTLSOptions ядра. Ключи, о которых
    приложение не рассуждает, проходят насквозь в форме прибытия — строка
    остаётся строкой, массив массивом. Naive пропускает certificate и
    certificate_path в дополнение к двум прежним; всё, что ядро на naive
    отвергает, по-прежнему режется. Пин certificate_public_key_sha256 теперь
    читается и из sing-box JSON. Значение не того типа отбрасывает поле, а не
    узел. Узлы без новых полей эмитятся байт в байт прежними. Allowlist общий с
    лаунчером (контракт TASKS_LXBOX §22).
  • Заодно: узел из JSON терял всё, чего не несёт share-ссылка, при переезде в
    папку и в «Copy link» — его пересобирали через toUri(). Теперь он хранит
    свой объект outbound'а как источник.

📝 Редактор узла: вкладки Source и JSON (docs/spec/tasks/455)

  • Было: вкладка JSON показывала пересборку узла моделью, и Save записывал эту
    копию поверх оригинала. Чего модель не знала, то пропадало.
  • Стало: Source — хранимый текст узла (ссылка, конфиг WireGuard или
    sing-box JSON) и единственное место правки; Save пишет его как есть (поле
    Tag уходит во фрагмент ссылки или в тело JSON). JSON — только чтение: то,
    что получит ядро. Узел, чей источник — JSON-объект, идёт в конфиг дословно,
    включая ключи, которых приложение не знает; ядро проверяет его при
    сохранении (Libbox.checkConfig), отвергнутое тело не сохраняется, ошибка
    показывается словами ядра. Edit JSON после предупреждения заменяет
    источник показанным JSON и уводит в Source; обратно в ссылку узел не
    превращается. Хранение не менялось: вид источника выводится из текста,
    флага нет — то же правило, что у лаунчера для ручного объекта.

📄 WireGuard .conf хранится как файл (docs/spec/tasks/456)

  • Было: импортированный INI переводился в синтетическую ссылку wg://…#имя,
    и источником хранилась она — комментарии и порядок строк терялись, вид
    записи был uri.
  • Стало: источник — текст INI байт в байт, вид записи wg_ini (как у
    лаунчера), тег — поле записи и применяется при чтении. Начальное имя —
    комментарий сразу под [Peer] (Proton пишет туда # CH-FREE#11), иначе имя
    файла, иначе WireGuard. Ссылка Amnezia vpn:// даёт каждому узлу свой
    INI. Старые записи читаются как раньше.
  • По пути пойманы и починены две регрессии: у INI-узлов терялось
    авто-эмодзи, а узел Tailscale терял тело при переезде в папку.

⚙️ Ядро v1.14.1-lx.4 и key_share у REALITY (docs/spec/tasks/457)

  • tls.fragment и tls.record_fragment теперь действуют на REALITY-узлы
    (ядро SPEC 088). Раньше REALITY-клиент строил рукопожатие на голом сокете и
    оба пропускал, включая авто-record_fragment, который ядро включает под
    detour; глобальный тумблер фрагментации выглядел включённым и ничего там
    не делал. В приложении ничего не менялось — тумблер просто заработал.
  • Новая по-узловая опция tls.reality.key_share (ядро SPEC 089). hybrid
    требует X25519MLKEM768: ClientHello вырастает до ~1,5–1,9 КБ и уезжает
    двумя TCP-сегментами — этого требуют Xray-серверы от v26.9.8. classical
    вырезает гибрид из key_share и supported_groups: ~0,5 КБ и один сегмент
    — для серверов постарше и для сетей, которые большое рукопожатие роняют.
    Без поля — как несёт отпечаток, прежнее поведение. Задаётся в sing-box JSON
    или как key_share= в share-ссылке vless/anytls; значение вне пары
    отбрасывается молча, узел остаётся жив, потому что ядро на нём отвергло бы
    весь конфиг. Имя URI-параметра общее с лаунчером.
  • Провод, наборы тегов AAR и тулчейн без изменений; Java-поверхность совпадает
    с lx.3 (javap по всем 253 классам — дифф пуст).

🔧 TCP keep-alive на узле (docs/spec/tasks/453)

  • Было: ядро принимает disable_tcp_keep_alive, tcp_keep_alive и
    tcp_keep_alive_interval с 1.13, но приложение их не знало и теряло на
    Save.
  • Стало: поля — часть узла и ходят во всех трёх формах, в которых он хранится
    и передаётся: sing-box JSON, share-URI и Xray JSON (sockopt, целые секунды;
    отрицательное значение — keep-alive выключен). Носителей девять — протоколы с
    TCP-дозвоном; QUIC/UDP-узлам поля не к чему применить. Значение не в формате
    Go-duration отбрасывается на входе. Узлы без полей эмитятся байт в байт
    прежними. Полей в форме нет — только JSON-вкладка и импорт.

🧪 Тесты

  • 4846 тестов зелёные, flutter analyze чист по всему проекту, четыре
    l10n-чекера и проверка паритета доков на нуле.
  • Новые: сквозные TLS-поля (naive из #140, полный allowlist на vless, не те
    типы, ech, байт-паритет, QUIC), дословное тело в сборке, нагрузка проверки
    ядром, имя INI из комментария [Peer], записи wg_ini с тегом, round-trip
    и guard'ы key_share.
  • Бамп ядра подтверждён javap-диффом AAR (пуст) и строкой версии внутри
    собранного APK (1.14.1-lx.4).
  • Проверка на устройстве пути naive с сертификатом и key_share ещё не
    сделана — если что-то ведёт себя не так, напишите в issue.

Install / Установка

adb install -r LxBox-v2.24.4-arm64-v8a.apk

Без uninstall! Поверх существующей установки. Настройки и подписки сохранятся.

No uninstall needed — install over the existing one. Settings and subscriptions
are preserved.

Previous release / Предыдущий релиз: v2.24.3.

Check out latest releases or
releases around Leadaxe/LxBox v2.24.4

Don't miss a new LxBox release

NewReleases is sending notifications on new releases.

Get notifications