github Leadaxe/singbox-launcher v2.4.4
release v2.4.4

57 minutes ago

Release v2.4.4

Downloads

macOS (Universal) - Supports both Apple Silicon and Intel

Option 1: Installation Script (Recommended)

Install with a single command (version v2.4.4):

curl -fsSL https://raw.githubusercontent.com/Leadaxe/singbox-launcher/develop/scripts/install-macos.sh | bash -s -- v2.4.4

The script will:

  • Download the release archive
  • Extract and install to /Applications/
  • Fix macOS quarantine attributes and permissions
  • Launch the application automatically

Option 2: Homebrew (stable releases only, available a few hours after the release)

brew install --cask leadaxe/tap/singbox-launcher

Update later with brew upgrade --cask singbox-launcher. The Cask installs the latest stable release, not a pre-release.

Option 3: Manual Installation

  1. Download: singbox-launcher-v2.4.4-macos.zip
  2. Extract the ZIP file
  3. Remove quarantine attribute (required):
    xattr -cr "singbox-launcher.app" && chmod +x "singbox-launcher.app/Contents/MacOS/singbox-launcher"
  4. Double-click singbox-launcher.app to run
    • If macOS blocks the app, go to System Settings → Privacy & Security and click "Open Anyway"
    • Alternatively, right-click the app and select "Open" (first time only)

Windows (amd64)

Option 1: Installer (Recommended)

  1. Download: singbox-launcher-v2.4.4-win64-setup.exe
  2. Run it and confirm the administrator prompt once. The launcher goes to C:\Program Files\singbox-launcher, your data to %LOCALAPPDATA%\singbox-launcher; sing-box.exe, wintun.dll, the config template and Mesa3D are included, nothing is downloaded on first launch
    • Tasks: desktop shortcut, Start with Windows, software OpenGL (Mesa3D) for RDP / VMs without a GPU
    • Installing over a previous version keeps your data; uninstall from Settings → Apps asks whether to remove the data too
    • The installer is not code-signed yet: if SmartScreen shows "Windows protected your PC", click More info → Run anyway

Option 2: Portable ZIP

  1. Download: singbox-launcher-v2.4.4-win64.zip
    • or singbox-launcher-v2.4.4-win64-full.zip — full bundle: sing-box.exe, wintun.dll, the config template and Mesa3D (mesa3d/, used only when no hardware OpenGL — RDP, VMs) are already inside, nothing is downloaded on first launch
  2. Extract the ZIP file to a folder your account can write to, for example D:\Tools\singbox-launcher\ — settings stay next to the program (portable.txt)
    • Under C:\Program Files\ the launcher keeps its data in %LOCALAPPDATA%\singbox-launcher instead
  3. Run singbox-launcher.exe from that folder — no administrator rights, no UAC prompt
    • TUN needs administrator rights: Start offers Restart as administrator or Switch to proxy mode
    • The regular archive downloads sing-box and wintun.dll on first launch

Windows 7 (x86, legacy)

  1. Download: singbox-launcher-v2.4.4-win7-32.zip
  2. Extract the ZIP file to a folder and run singbox-launcher-win7-32.exe
    • For Windows 7 / 32-bit or legacy compatibility only
    • Runs as administrator (UAC prompt on every start), settings stay next to the program (portable.txt); no installer and no daemon service

Linux Support

⚠️ Linux build temporarily unavailable - мы ищем тестировщика для ручного тестирования перед включением автоматической сборки.

Checksums

See checksums.txt for SHA256 checksums of all files.

Release notes — v2.4.4 (2026-11-21)

EN

A patch release after v2.4.3. Core sing-box-lx 1.14.4-lx.35 (unchanged), contract 1.1.176 (was 1.1.170).

Changed

  • Domain rules work on Cloudflare sites with ECH, without FakeIP. Chrome took an ECH config from the DNS HTTPS record and hid the site name, so a domain rule missed and traffic went to the default route. New preset Block HTTPS/SVCB records (off by default, right after Traffic Processing) answers HTTPS/SVCB queries empty for all domains; the rule window's DNS tab has Block HTTPS/SVCB records (no ECH) for the rule's own domains — it turns on by itself when you first enter domains, and is available for SRS rules too.
  • A rule's DNS options now work with ports, protocols and network. A dedicated DNS server, Force IPv4, Fixed IP and Block HTTPS were unavailable for a rule with a port or network; they now apply to the rule's domains on any port and protocol, and the DNS tab says so.
  • Comments in a node's JSON source are kept. //, # and /* */ in text pasted into the JSON tab or the Origin field stay in the source as typed; Regen and backup import understand them, and a commented node still counts as authored. When a document is trimmed to its node arrays on save, the trimmed remainder is stored without comments.
  • A source or node whose hop is unavailable is no longer dropped. If the detour target is not in the built config — the Direction is turned off, the node was deleted, renamed or vanished from its subscription, a template group no longer exists — the hop is removed, the nodes stay and connect directly, and the source gets a ⚠ naming the target and the nodes (detour_unavailable, contract 1.1.171). Before, all such nodes were excluded. A detour onto the node itself and detour loops still exclude the nodes; a chain with a missing position still drops out whole.
  • A preset DNS server can be chosen as Final DNS and Default domain resolver. A server of an enabled preset (for example russian:yandex_udp) was offered in the dropdown, but Save answered "must be an enabled server tag": the check knew only your own servers. The check and the dropdowns now use the same set; a preset server switched off on the DNS tab is no longer offered.
  • DNS tab: the server and rule lists sit in a rounded outlined panel with its own background and zebra rows, so a list reads as a block of its own rather than more of the form; the scrollbar no longer covers buttons and rows.
  • Connection settings: an open Troubleshooting section no longer scrolls inside its own small viewport — it is shown in full in an outlined block, and the whole window scrolls.
  • A source folded into a group can be picked as a detour. The detour picker got a third branch, Replace groups, listing the groups of other folded subscriptions and folders (Manual, Auto and Both; for Both the selector itself). A group whose own nodes connect back through this source is shown with ⚠ and cannot be picked. The chain hop picker follows the same list: the -auto twin is no longer offered separately.
  • Settings are grouped under headings. The Configurator's Settings tab now shows named sections with a short description — TUN, Local proxy, Network, TLS Fragmentation, Sniff guard, QUIC, Auto Proxy, General, Clash API, DNS — instead of unnamed blocks between lines. The four Sniff guard rows lost their prefix: TLS method, QUIC method, Only nodes with a masked SNI, Remember relays across restarts. Values and the built config are unchanged.
  • TrustTunnel links tt:// are read and written. A link from the AdGuard TrustTunnel endpoint or client (tt://?…) pasted into a source becomes a TrustTunnel node: address, account, HTTP/2 or HTTP/3, certificate, the ClientHello profile. Copy link on such a node gives the same tt:// link back. Settings the core cannot express — a separate SNI, the client-random prefix or key, anti-DPI, extra addresses, the profile DNS — are named in the node's warnings. A link that carries only a subscription address becomes a subscription source when added on the Sources tab, and a TrustTunnel subscription URL (https://user:password@host/subscription) is read like any other subscription. Add server has a TrustTunnel type with a form: server, port, account, TLS, QUIC, health check, idle timeout. Needs a core with TrustTunnel (1.14.3-lx.21+).

Technical / Internal

  • Contract 1.1.173 (D-150): preset block-https (num 10), rule field rules[].dns.blockHttps; per-rule DNS order Block HTTPS → Force IPv4 → server / Fixed IP; registry list rule_dns_mirror_gate replaced by rule_dns_mirror_unseen (keys not copied, no longer blocking) and new rule_dns_block_https_domains; corpus rule_dns +7 cases.
  • Contract 1.1.172: comments (//, #, /* */) in a JSON node source are allowed and kept as typed; every reader strips them before parsing (internal/jsonfmt.StripComments), backup dedup compares the source without them.
  • Contract 1.1.171: new warning code detour_unavailable (params target, count, tags), source_detour_missing removed; the build report kind target_missing is gone (a stripped hop is an emit_degraded entry with the code).
  • Contract 1.1.174 (D-151, SPEC 183): template variables are declared in root sections[] — {id, name, description?, chapter?, vars[]}, the LxBox form (TEMPLATE_LANG.md §2.3); the flat root vars[] stays a reading form (older templates, corpus fragments); both in one template is a load error, and so is {"separator": true} inside a section. core/template.DecodeVarContainer is the only reader of the container; load errors name a variable as sections[<id>].vars[<name>]. The bundled template is laid out in ten sections. Corpus template/grammar +2. New troubleshooting section: a node through a detour fails while the same server works directly (a relay redirects by the sniffed SNI; Sniff guard).
  • Contract 1.1.175 (D-152, LxBox §157): registry primitive tlv — a binary tag–length–value container described by a section table (mappers.<kind>.tlv, MAPPER_ENGINE.md §4a), decoder tlv and emit.container: "tlv" in core/config/linkmap/tlv.go, no scheme names in the engine; json_map refs take a | fallback chain. trusttunnel gets mappers.uri (tt://, DEEP_LINK.md version 2 with tls_profile), codes tt_field_unsupported, tt_subscription_ignored, tt_subscription_only; hostname goes to tls.server_name, custom_sni is reported. Corpus uri/trusttunnel — 30 cases; emitted links match the AdGuard encoder byte for byte. The live-core corpus check skips protocols whose build tag the check core lacks.
  • Contract 1.1.176 (D-153, SPEC 184): document unwrapper container_link — a JSON object with container keys is printed as a link through the section's tlv table and re-detected (MAPPER_ENGINE.md §2.1); source kind trusttunnel_endpoint_json for the TrustTunnel subscription answer, node origin is the tt:// link; tt_subscription_only carries the address in its subscription_url parameter and subscription.SubscriptionURLOfLink turns a pasted pointer link into a subscription; trusttunnel gets body.form. Corpus body/trusttunnel +2, form/trusttunnel_form +2.

RU

Патч после v2.4.3. Ядро sing-box-lx 1.14.4-lx.35 (без изменений), контракт 1.1.176 (был 1.1.170).

Изменено

  • Правила по доменам срабатывают на сайтах Cloudflare с ECH и без FakeIP. Chrome брал ECH-конфиг из HTTPS-записи DNS и прятал имя сайта — правило по доменам промахивалось, трафик уходил по маршруту по умолчанию. Новый пресет Block HTTPS/SVCB records (выключен по умолчанию, сразу после Traffic Processing) отвечает на HTTPS/SVCB-запросы пустым для всех доменов; во вкладке DNS окна правила — Block HTTPS/SVCB records (no ECH) для доменов самого правила: включается сам при первом вводе доменов, доступен и SRS-правилам.
  • DNS-настройки правила работают с портами, протоколами и network. Свой DNS-сервер, Force IPv4, Fixed IP и Block HTTPS были недоступны правилу с портом или network; теперь они действуют на домены правила при любом порте и протоколе, вкладка DNS об этом говорит.
  • Комментарии в JSON-исходнике узла сохраняются. //, # и /* */ в тексте, вставленном на вкладке JSON или в поле Origin, остаются в исходнике как набраны, Regen и импорт бэкапа их понимают; узел с комментариями по-прежнему считается авторским. Если документ при сохранении обрезается до узловых массивов, обрезанный остаток хранится без комментариев.
  • Источник или узел с недоступным хопом больше не выбрасывается. Если цели detour нет в собранном конфиге — Направление выключено, узел удалён, переименован или пропал из подписки, группы шаблона больше нет, — хоп снимается, узлы остаются и подключаются напрямую, а у источника ⚠ с целью и узлами (detour_unavailable, контракт 1.1.171). Раньше такие узлы исключались все. detour узла на самого себя и кольца detour по-прежнему исключают узлы; цепочка с пропавшей позицией по-прежнему выпадает целиком.
  • DNS-сервер пресета можно выбрать как Final DNS и Default domain resolver. Сервер включённого пресета (например russian:yandex_udp) был в выпадающем списке, но Save отвечал «must be an enabled server tag»: проверка знала только собственные серверы. Теперь проверка и списки берут один набор; сервер пресета, выключенный галочкой на вкладке DNS, в списки не попадает.
  • Вкладка DNS: списки серверов и правил лежат в скруглённой рамке со своим фоном и зеброй — список читается как отдельный блок, а не продолжение формы; полоса прокрутки больше не ложится на кнопки и строки.
  • Connection settings: раскрытая секция Troubleshooting больше не прокручивается сама в маленьком окошке — она раскрыта целиком в блоке с рамкой, а прокручивается всё окно.
  • Источник, свёрнутый в группу, можно выбрать как detour. В пикере detour появилась третья ветка Replace groups — группы других свёрнутых подписок и папок (Manual, Auto и Both; у Both — сам селектор). Группа, узлы которой сами подключаются через этот источник, показана с ⚠ и не выбирается. Пикер позиций цепочки берёт тот же список: двойник -auto отдельно больше не предлагается.
  • Настройки сгруппированы под заголовками. На вкладке Settings Конфигуратора теперь именованные разделы с коротким пояснением — TUN, Local proxy, Network, TLS Fragmentation, Sniff guard, QUIC, Auto Proxy, General, Clash API, DNS — вместо безымянных блоков между линиями. Четыре строки Sniff guard лишились префикса: TLS method, QUIC method, Only nodes with a masked SNI, Remember relays across restarts. Значения и собираемый конфиг не изменились.
  • Ссылки TrustTunnel tt:// читаются и пишутся. Ссылка от узла или клиента AdGuard TrustTunnel (tt://?…), вставленная в источник, становится узлом TrustTunnel: адрес, учётная запись, HTTP/2 или HTTP/3, сертификат, профиль ClientHello. Copy link у такого узла отдаёт ту же ссылку tt://. Настройки, которые ядро выразить не может, — отдельный SNI, префикс или ключ client random, anti-DPI, запасные адреса, DNS профиля — названы в предупреждениях узла. Ссылка, в которой только адрес подписки, при добавлении на вкладке Sources становится источником-подпиской, а адрес подписки TrustTunnel (https://user:password@host/subscription) читается как любая другая подписка. В Add server появился тип TrustTunnel с формой: сервер, порт, учётная запись, TLS, QUIC, health check, idle timeout. Нужно ядро с TrustTunnel (1.14.3-lx.21+).

Техническое / Внутреннее

  • Контракт 1.1.173 (D-150): пресет block-https (num 10), поле правила rules[].dns.blockHttps; порядок DNS-правил правила Block HTTPS → Force IPv4 → сервер / Fixed IP; список реестра rule_dns_mirror_gate заменён на rule_dns_mirror_unseen (ключи не копируются и больше не блокируют) и новый rule_dns_block_https_domains; корпус rule_dns +7 кейсов.
  • Контракт 1.1.172: комментарии (//, #, /* */) в JSON-исходнике узла разрешены и хранятся как набраны; каждый читатель снимает их перед разбором (internal/jsonfmt.StripComments), дедуп импорта сравнивает исходник без них.
  • Контракт 1.1.171: новый код предупреждения detour_unavailable (параметры target, count, tags), source_detour_missing снят; вид записи отчёта сборки target_missing убран (снятый хоп — запись emit_degraded с кодом).
  • Контракт 1.1.174 (D-151, SPEC 183): переменные шаблона объявляются в корневом sections[] — {id, name, description?, chapter?, vars[]}, форма LxBox (TEMPLATE_LANG.md §2.3); плоский корневой vars[] остаётся формой чтения (старые шаблоны, фрагменты корпуса); обе формы в одном шаблоне — ошибка загрузки, как и {"separator": true} внутри раздела. Контейнер читает только core/template.DecodeVarContainer; ошибки загрузки называют переменную как sections[<id>].vars[<name>]. Поставляемый шаблон разложен на десять разделов. Корпус template/grammar +2. Новый раздел в траблшутинге: узел через detour не работает, а тот же сервер напрямую работает (релей уводит соединение по подсмотренному SNI; Sniff guard).
  • Контракт 1.1.175 (D-152, LxBox §157): примитив реестра tlv — бинарный контейнер «тег–длина–значение», описанный таблицей секции (mappers.<kind>.tlv, MAPPER_ENGINE.md §4a), декодер tlv и emit.container: "tlv" в core/config/linkmap/tlv.go, имён схем в движке нет; ссылка json_map принимает цепочку через |. У trusttunnel — mappers.uri (tt://, DEEP_LINK.md version 2 с tls_profile), коды tt_field_unsupported, tt_subscription_ignored, tt_subscription_only; в tls.server_name едет hostname, custom_sni называется кодом. Корпус uri/trusttunnel — 30 кейсов; ссылки эмита совпадают с энкодером AdGuard байт в байт. Проверка корпуса живым ядром пропускает протоколы, тега сборки которых у ядра проверки нет.
  • Контракт 1.1.176 (D-153, SPEC 184): распаковщик документа container_link — объект JSON с ключами контейнера печатается ссылкой по таблице tlv секции и уходит на повторный детект (MAPPER_ENGINE.md §2.1); вид источника trusttunnel_endpoint_json для ответа подписки TrustTunnel, происхождение узла — ссылка tt://; tt_subscription_only несёт адрес в параметре subscription_url, subscription.SubscriptionURLOfLink превращает вставленную ссылку-указатель в подписку; у trusttunnel — body.form. Корпус body/trusttunnel +2, form/trusttunnel_form +2.

Don't miss a new singbox-launcher release

NewReleases is sending notifications on new releases.