Repository navigation
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.4The 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-launcherUpdate later with brew upgrade --cask singbox-launcher. The Cask installs the latest stable release, not a pre-release.
Option 3: Manual Installation
- Download:
singbox-launcher-v2.4.4-macos.zip - Extract the ZIP file
- Remove quarantine attribute (required):
xattr -cr "singbox-launcher.app" && chmod +x "singbox-launcher.app/Contents/MacOS/singbox-launcher"
- Double-click
singbox-launcher.appto 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)
- Download:
singbox-launcher-v2.4.4-win64-setup.exe - 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
- 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
- or
- 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-launcherinstead
- Under
- Run
singbox-launcher.exefrom 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-boxandwintun.dllon first launch
Windows 7 (x86, legacy)
- Download:
singbox-launcher-v2.4.4-win7-32.zip - 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
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
-autotwin 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 samett://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(num10), rule fieldrules[].dns.blockHttps; per-rule DNS order Block HTTPS → Force IPv4 → server / Fixed IP; registry listrule_dns_mirror_gatereplaced byrule_dns_mirror_unseen(keys not copied, no longer blocking) and newrule_dns_block_https_domains; corpusrule_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(paramstarget,count,tags),source_detour_missingremoved; the build report kindtarget_missingis gone (a stripped hop is anemit_degradedentry 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 rootvars[]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.DecodeVarContaineris the only reader of the container; load errors name a variable assections[<id>].vars[<name>]. The bundled template is laid out in ten sections. Corpustemplate/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), decodertlvandemit.container: "tlv"incore/config/linkmap/tlv.go, no scheme names in the engine;json_maprefs take a|fallback chain.trusttunnelgetsmappers.uri(tt://, DEEP_LINK.md version 2 withtls_profile), codestt_field_unsupported,tt_subscription_ignored,tt_subscription_only;hostnamegoes totls.server_name,custom_sniis reported. Corpusuri/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'stlvtable and re-detected (MAPPER_ENGINE.md§2.1); source kindtrusttunnel_endpoint_jsonfor the TrustTunnel subscription answer, node origin is thett://link;tt_subscription_onlycarries the address in itssubscription_urlparameter andsubscription.SubscriptionURLOfLinkturns a pasted pointer link into a subscription;trusttunnelgetsbody.form. Corpusbody/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(num10), поле правила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.