Перейти к основному содержимому

Конфигурационный файл

b4 хранит конфигурацию в одном JSON-файле, по умолчанию /etc/b4/b4.json. Флаг --config указывает другой путь.

Расположение по платформам​

ПлатформаПуть
Linux/etc/b4/b4.json
OpenWRT (с extroot или USB-накопителем)/opt/etc/b4/b4.json
OpenWRT (без USB-накопителя)/etc/b4/b4.json
ASUS Merlin/opt/etc/b4/b4.json
Keenetic/opt/etc/b4/b4.json
Docker/etc/b4/b4.json внутри контейнера

Без --config b4 ищет b4.json и config.json в каталогах /etc/b4 и /opt/etc/b4, а если не находит, берёт /etc/b4/b4.json. Выбранный путь пишется в лог при запуске.

Карточка Скачать конфигурацию в разделе Настройки > Система > Бэкап сохраняет конфигурацию в том виде, в каком b4 записывает этот файл. Её безопасная копия маскирует учётные данные и частные имена хостов для передачи другим, а конфигурацию, в которой остались заглушки [redacted], b4 не загружает и не сохраняет.

Хранится только то, что отличается от умолчаний​

Файл разрежённый. Настройка со встроенным значением по умолчанию в него не попадает, поэтому свежая установка даёт очень короткий файл, а раздел, в котором ничего не менялось, отсутствует. Отсутствующий ключ - не пропавшая настройка, и дописывание его с тем же значением ничего не меняет. Сохранения из веб-интерфейса, через API и через MCP записывают файл так же.

Структура​

{
"version": 52,
"queue": {
"start_num": 537,
"threads": 4,
"mark": 32768,
"ipv4": true,
"ipv6": false,
"tcp_conn_bytes_limit": 19,
"udp_conn_bytes_limit": 8,
"interfaces": [],
"mss_clamp": { "enabled": false, "size": 88 },
"devices": { "enabled": false, "vendor_lookup": false }
},
"system": {
"tables": {
"skip_setup": false,
"monitor_interval": 10,
"engine": "",
"masquerade": { "enabled": false, "interfaces": [] },
"dscp": { "enabled": false, "value": 0, "interfaces": [] }
},
"logging": {
"level": 1,
"directory": "/var/log/b4",
"instaflush": true,
"syslog": false
},
"web_server": {
"port": 7000,
"bind_address": "0.0.0.0",
"expose": false,
"tls_cert": "",
"tls_key": "",
"username": "",
"password": "",
"language": "en",
"mcp": { "enabled": false, "allow_writes": false }
},
"dns": {
"tcp_disabled": false,
"tcp_port": 5453,
"query_timeout_sec": 5,
"keep_ipv6_answers": false
},
"socks5": {
"enabled": false,
"port": 1080,
"bind_address": "0.0.0.0",
"expose": false,
"allowed_sources": ["192.168.1.0/24", "127.0.0.1/32"]
},
"mtproto": { "enabled": false, "port": 3128, "bind_address": "0.0.0.0", "expose": false },
"checker": {
"discovery_timeout": 5,
"config_propagate_ms": 1500,
"dns_server": ""
},
"geo": { "sitedat_path": "", "ipdat_path": "", "sitedat_url": "", "ipdat_url": "" },
"timezone": ""
},
"sets": []
}

Пример показывает часть разделов и часть их ключей. В реальном файле есть только ключи, которые отличаются от умолчаний.

  • system.mtproto.secrets - список именованных секретов, у каждого есть id, name, secret и enabled. Файл, записанный до версии конфигурации 50, содержал одну строку mtproto.secret, и миграция переносит её в список записью с именем default.
  • system.socks5.allowed_sources отсутствует, пока список пуст. Это значение по умолчанию, и прокси тогда принимает соединения с любого источника. Каждая запись - IP-адрес или CIDR-диапазон. 0.0.0.0/0, ::/0 и некорректные записи отклоняются при загрузке и сохранении файла.

Раздел queue​

КлючСмыслПо умолчанию
start_numПервый номер NFQUEUE537
threadsКоличество рабочих потоков4
markМетка очереди, см. Метки пакетов32768
ipv4Обрабатывать IPv4-трафикtrue
ipv6Обрабатывать IPv6-трафикfalse
tcp_conn_bytes_limitСколько пакетов в начале TCP-соединения проверяет b419
udp_conn_bytes_limitТо же для UDP8
interfacesИнтерфейсы захвата, фильтр по интерфейсу, через который проходит пакет. Пустой список означает все[]

tcp_conn_bytes_limit и udp_conn_bytes_limit действуют для всех сетов. Собственные tcp.conn_bytes_limit и udp.conn_bytes_limit сета ни на что не влияют, и поля для них в веб-интерфейсе нет.

queue.ipv6 определяет, обрабатывает ли IPv6 сам b4, а не пользуется ли им роутер. При выключенном значении, а оно по умолчанию, b4 обрабатывает только IPv4 и не пишет IPv6-правил файрвола ни для одного сета, поэтому клиент, открывший сайт по IPv6, проходит мимо сетов. b4 тогда убирает IPv6-адреса из DNS-ответов для доменов, с которыми совпадают сеты, см. DNS. Исключение - режим NFQUEUE, пока у включённого сета включено dns.strip_ech. В этом режиме b4 пишет IPv6-правила для DNS-ответов и DNS поверх TCP, но только чтобы убрать из них ключи ECH. Изменение действует в полном объёме после перезапуска. --ipv6 задаёт то же самое на один запуск.

Раздел sets​

Каждый сет - объект в массиве sets, несущий всю свою конфигурацию. Его ключи соответствуют вкладкам редактора сета:

  • targets - домены, IP, категории GeoSite и GeoIP, ASN, устройства-источники
  • tcp - общие настройки TCP, окно реальных TCP-пакетов, desync, window, incoming, защита от RST
  • fragmentation - метод фрагментации и его параметры
  • faking - SNI faking, SYN-фейки, мутация
  • udp - фильтр QUIC, фильтр портов, обработка звонков и режим действия для UDP
  • dns - резолверы сета и закреплённые адреса
  • routing - режим маршрутизации, выходной интерфейс, вышестоящий прокси или блокировка
  • dscp - собственное значение DSCP сета
  • discovery - адреса Дискавери сета и переключатель его мониторинга
  • escalate - на какой сет переключаться, когда этот перестаёт работать

Вкладка Импорт/Экспорт редактора сета показывает сет в виде JSON и принимает вставленный обратно. В экспортируемом JSON нет значений, равных умолчаниям, и настроек выключенных функций. В нём нет и идентификатора сета, устройств-источников, targets.ip_priority, переключателя мониторинга и настроек эскалации, а если у сета есть устройства-источники, то и его dscp. Сет, в который импортируется JSON, сохраняет собственное значение targets.ip_priority.

dscp сета​

КлючСмыслПо умолчанию
dscp.enabledВключить DSCP для сета: записывать собственное значение сета в пакеты к адресам сета, см. DSCPfalse
dscp.valueЗначение, которое записывается в поле DSCP, 0-63. 0 обнуляет поле0

Каждый ключ хранится, только пока отличается от умолчания: включённый переключатель со значением 0 сохраняется как "dscp": {"enabled": true}, значение при выключенном переключателе - как "dscp": {"value": 12}. Пока dscp.enabled равно true, dscp.value вне 0-63 отклоняется, а не подрезается: веб-интерфейс не даёт сохранить такое значение, а файл с ним останавливает b4 при запуске. Ни один из ключей нельзя изменить через MCP, и ни один не передаётся в общем сете.

tcp.wssize сета​

КлючСмыслПо умолчанию
tcp.wssize.enabledИзменять окно реальных TCP-пакетов, см. Окно реальных TCP-пакетов (wssize)false
tcp.wssize.windowЗначение, которое записывается в поле окна, 0-65535. 0 оставляет окно без изменений0
tcp.wssize.scaleВерхняя граница для опции Window Scale в SYN, 0-14. 0 оставляет опцию без изменений0
tcp.wssize.strip_scaletrue удаляет опцию Window Scale из SYN, в редакторе это Удалить опцию. tcp.wssize.scale при этом не используется и при сохранении сбрасывается в 0false
tcp.wssize.cutoffГде изменение прекращается: пустая строка - После ClientHello, first_data - После первого пакета данных. Любое другое значение читается как пустая строкапусто

Пока tcp.wssize.enabled равно true, число вне диапазона отклоняется, как и включённый сет, у которого также включён routing.enabled или tcp.duplicate.enabled: веб-интерфейс не даёт сохранить такой сет, а файл с ним останавливает b4 при запуске. Включённый переключатель с обоими числами 0 и выключенным strip_scale сохраняется как "wssize": {"enabled": true} и не изменяет ни одного пакета. Ключи можно изменить через MCP. В общем сете они передаются, только пока одно из чисел больше 0 или strip_scale равно true.

Звонки сета: udp.filter_stun и udp.filter_l7​

Поле Звонки на вкладке UDP сета хранится в двух ключах, см. Сеты для звонков.

ЗвонкиКак хранится
Пропускать начало звонковudp.filter_stun равно true, это значение по умолчанию
Обрабатывать как остальной UDPudp.filter_stun равно false
Обрабатывать только звонкиudp.filter_l7 перечисляет звонки из поля Какие звонки: ["discord", "stun"] для Приложение Discord и браузеры, ["discord"] для Приложение Discord, ["stun"] для Браузеры

Непустой udp.filter_l7 означает Обрабатывать только звонки при любом значении udp.filter_stun, и udp.filter_stun тогда ни на что не влияет. Пустой список не хранится. Сету с этим списком нужен udp.dport_filter, у него не должно быть targets.sni_domains, targets.ip, targets.geosite_categories, targets.geoip_categories и targets.asns, а tcp.dport_filter должен быть пустым. Сет, который нарушает это правило, отклоняется: веб-интерфейс не даёт его сохранить, а файл с таким сетом останавливает b4 при запуске. escalate.to, который указывает на сет с этим списком, очищается, а b4 пишет предупреждение в журнал. Неизвестный элемент остаётся в списке, ни с каким трафиком не совпадает, а b4 пишет о нём предупреждение в журнал. (авто: STUN-запрос) - это "fake_payload_file": "@stun" в udp. udp.filter_l7 можно изменить через MCP, допустимы только элементы discord и stun, и ключ передаётся в общем сете.

Резолверы сета: dns.doh_url, dns.target_dns и dns.upstreams​

Поле Резолверы на вкладке DNS & Маршрутизация сета хранится в трёх ключах, см. Сет с несколькими резолверами.

РезолверыКак хранится
Первая запись, если это URL https://dns.doh_url
Первая запись, если это IP-адресdns.target_dns
Остальные записи в том порядке, в каком они стоят в полеdns.upstreams, список строк

Первым b4 опрашивает dns.doh_url, если он заполнен, иначе dns.target_dns, затем записи dns.upstreams по порядку: всего не больше восьми резолверов вместе с первым. Сет с включённым dns.enabled, у которого заполнен только dns.upstreams, тоже перенаправляет свои домены. Пустой список не хранится.

dns.target_dns - это IP-адрес и ничего больше. Имя хоста или URL в нём не даёт сету резолвера, и запросы сета уходят без изменений, если в dns.upstreams нет пригодной записи. Запись dns.upstreams - IP-адрес без порта или URL https://. Пока dns.enabled равно true, любая другая запись отклоняется, как и 0.0.0.0 и URL без хоста или с именем пользователя: веб-интерфейс не даёт сохранить сет, а файл с такой записью останавливает b4 при запуске. При выключенном dns.enabled список хранится как записан и не проверяется.

Пока dns.enabled равно true, b4 также убирает запись, которая повторяет первый резолвер или более раннюю запись, а записи после восьмого резолвера убирает с предупреждением в журнале. dns.upstreams можно изменить через MCP: одно значение через запятую заменяет весь список. Ключ не передаётся в общем сете, как и dns.target_dns.

Настройки и их пути в конфигурации​

Таблицы перечисляют поля веб-интерфейса и путь, в котором хранится каждое. Пути редактора сета указаны относительно одного объекта сета в массиве sets: dns.strict означает sets[].dns.strict.

Настройки > Основные​

ПодвкладкаПолеПуть
Движок пакетовРежим захватаqueue.mode
Движок пакетовАплинк-интерфейсqueue.tun.out_interface
Движок пакетовШлюз аплинкаqueue.tun.out_gateway
Движок пакетовАдрес TUNqueue.tun.address
Движок пакетовИмя устройства TUNqueue.tun.device_name
Движок пакетовИнтерфейсы захватаqueue.interfaces
Движок пакетовИнтервал перепроверки (секунды)system.ip_health.retest_interval_sec
Движок пакетовЗапоминать заблокированные адресаsystem.ip_health.bans_off, инвертировано: включённый переключатель - это false
Движок пакетовПервый бан (часы)system.ip_health.ban_ttl_sec, в секундах
Движок пакетовПовторный бан (дни)system.ip_health.repeat_ban_ttl_sec, в секундах
Движок пакетовПоддержка IPv4queue.ipv4
Движок пакетовПоддержка IPv6queue.ipv6
Движок пакетовФорсировать IPv4 для совпавших доменовsystem.dns.keep_ipv6_answers, инвертировано: включённый переключатель - это false
Движок пакетовНачальный номер очередиqueue.start_num
Движок пакетовМетка пакетаqueue.mark
Движок пакетовРабочие потокиqueue.threads
Движок пакетовЛимит TCP пакетов соединенияqueue.tcp_conn_bytes_limit
Движок пакетовЛимит UDP пакетов соединенияqueue.udp_conn_bytes_limit
УстройстваВключить фильтрацию устройствqueue.devices.enabled
УстройстваИсключить выбранные устройства (чёрный список)queue.devices.wisb
УстройстваОпределение производителяqueue.devices.vendor_lookup
УстройстваУстройства, выбранные в Доступные устройства и добавленные в Ручные устройстваqueue.devices.devices
ФайрволПропустить настройку IPTables/NFTablessystem.tables.skip_setup
ФайрволДвижок файрволаsystem.tables.engine
ФайрволИнтервал мониторинга файрвола (секунды)system.tables.monitor_interval
ФайрволВключить глобальный MSS Clampingqueue.mss_clamp.enabled
ФайрволРазмер MSSqueue.mss_clamp.size
ФайрволВключить NAT Masqueradesystem.tables.masquerade.enabled
ФайрволТеги интерфейсов NAT Masqueradesystem.tables.masquerade.interfaces
ФайрволЗадать DSCPsystem.tables.dscp.enabled
ФайрволЗначение DSCPsystem.tables.dscp.value
ФайрволТеги интерфейсов DSCPsystem.tables.dscp.interfaces
DNSПерехватывать DNS поверх TCPsystem.dns.tcp_disabled, инвертировано: включённый переключатель - это false
DNSПорт слушателяsystem.dns.tcp_port
DNSТаймаут запросаsystem.dns.query_timeout_sec
DNSТаймаут простояsystem.dns.tcp_idle_sec
DNSТаймаут чтения/записиsystem.dns.tcp_io_sec
DNSТаймаут пересылкиsystem.dns.tcp_dial_sec
SOCKS5Включить SOCKS5 проксиsystem.socks5.enabled
SOCKS5Адрес привязкиsystem.socks5.bind_address
SOCKS5Портsystem.socks5.port
SOCKS5Доступ из интернетаsystem.socks5.expose
SOCKS5Имя пользователяsystem.socks5.username
SOCKS5Парольsystem.socks5.password
SOCKS5Разрешённые источникиsystem.socks5.allowed_sources

Настройки > Система​

ПодвкладкаПолеПуть
СервисЯзыкsystem.web_server.language
СервисЧасовой поясsystem.timezone
СервисЛимит памятиsystem.memory_limit
СервисЗеркала обновленияsystem.update.mirrors
СервисУровень логированияsystem.logging.level
СервисПапка логовsystem.logging.directory
СервисМгновенный сбросsystem.logging.instaflush
СервисSyslogsystem.logging.syslog
Веб-серверАдрес привязкиsystem.web_server.bind_address
Веб-серверПортsystem.web_server.port
Веб-серверДоступ из интернетаsystem.web_server.expose
Веб-серверTLS Сертификатsystem.web_server.tls_cert
Веб-серверTLS Ключsystem.web_server.tls_key
Веб-серверИмя пользователяsystem.web_server.username
Веб-серверПарольsystem.web_server.password, хранится как хеш

Настройки > Geodat настройки​

КарточкаПолеПуть
База данных GeositeФайл, который записывают Обновить и Загрузитьsystem.geo.sitedat_path
База данных GeositeИсточникsystem.geo.sitedat_url
База данных GeoIPФайл, который записывают Обновить и Загрузитьsystem.geo.ipdat_path
База данных GeoIPИсточникsystem.geo.ipdat_url
АвтообновлениеОбновлять при запускеsystem.geo.auto_update.on_startup
АвтообновлениеРасписаниеsystem.geo.auto_update.interval: daily, weekly или monthly
АвтообновлениеПоследний запускsystem.geo.auto_update.last_run, записывает b4

Настройки > Дискавери​

КарточкаПолеПуть
Конфигурация тестированияТаймаут поискаsystem.checker.discovery_timeout
Конфигурация тестированияЗадержка распространения конфигурацииsystem.checker.config_propagate_ms
Конфигурация тестированияДоверенный DNS-серверsystem.checker.dns_server
МониторингВключить мониторингsystem.checker.watchdog.enabled
МониторингИнтервал проверкиsystem.checker.watchdog.interval_sec
МониторингИнтервал после ошибкиsystem.checker.watchdog.failure_interval
МониторингПерерыв между discoverysystem.checker.watchdog.cooldown_sec
МониторингТаймаут проверкиsystem.checker.watchdog.timeout_sec
МониторингМакс. попытокsystem.checker.watchdog.max_retries
МониторингСтарый список доменовsystem.checker.watchdog.domains

Настройки > Telegram​

КарточкаПолеПуть
MTProto ПроксиВключить MTProto проксиsystem.mtproto.enabled
MTProto ПроксиАдрес привязкиsystem.mtproto.bind_address
MTProto ПроксиПортsystem.mtproto.port
MTProto ПроксиДоступ из интернетаsystem.mtproto.expose
MTProto ПроксиДомен для Fake SNIsystem.mtproto.fake_sni
MTProto ПроксиМакс. подключенийsystem.mtproto.max_connections
MTProto ПроксиTCP User Timeout (сек)system.mtproto.tcp_user_timeout_sec
MTProto ПроксиТайм-аут простоя (сек)system.mtproto.idle_timeout_sec
СекретыСписок секретовsystem.mtproto.secrets
Транспорт к Telegram (общий)Режим транспортаsystem.mtproto.upstream_mode
Транспорт к Telegram (общий)DC Relaysystem.mtproto.dc_relay
Транспорт к Telegram (общий)Сет для Telegramsystem.mtproto.upstream_set
Транспорт к Telegram (общий)Домен Cloudflare Workersystem.mtproto.cfworker_domain
Транспорт к Telegram (общий)Свой WebSocket-доменsystem.mtproto.ws_custom_domain
Транспорт к Telegram (общий)IP edge-сервера Telegramsystem.mtproto.ws_endpoint_host
Транспорт к Telegram (общий)Имя для фронтинга WS-узла Telegramsystem.mtproto.ws_front_sni
Транспорт к Telegram (общий)CF-резервsystem.mtproto.cfproxy_enabled
Транспорт к Telegram (общий)URL списка CF-доменовsystem.mtproto.cfproxy_url
Транспорт к Telegram (общий)Резервное зеркало списка DCsystem.mtproto.dc_fallback_enabled
Транспорт к Telegram (общий)URL зеркала списка DCsystem.mtproto.dc_fallback_url
Транспорт к Telegram (общий)Ожидание рукопожатия в мосте (сек)system.mtproto.bridge_wait_sec
Telegram через WebSocketВключить Telegram через WebSocketsystem.mtproto.bridge.enabled
WEB-прокси Telegram DesktopВключить WEB-каналsystem.mtproto.web_proxy.enabled
WEB-прокси Telegram DesktopХост релеяsystem.mtproto.web_proxy.hostname
WEB-прокси Telegram DesktopПорт relaysystem.mtproto.web_proxy.port
WEB-прокси Telegram DesktopДоступ из интернетаsystem.mtproto.web_proxy.expose
WEB-прокси Telegram DesktopФайл сертификатаsystem.mtproto.web_proxy.tls_cert
WEB-прокси Telegram DesktopФайл закрытого ключаsystem.mtproto.web_proxy.tls_key

Настройки > Интеграции​

КарточкаПолеПуть
IPinfoТокен доступаsystem.api.ipinfo_token
AI-помощникВключить AI-помощникаsystem.ai.enabled
AI-помощникВкладки провайдеровsystem.ai.provider
AI-помощникМодельsystem.ai.model
AI-помощникEndpointsystem.ai.endpoint
AI-помощникМакс. токеновsystem.ai.max_tokens
AI-помощникТемператураsystem.ai.temperature
AI-помощникТаймаут (с)system.ai.timeout_sec
MCP-серверВключить MCP-серверsystem.web_server.mcp.enabled
MCP-серверТокен доступаsystem.web_server.mcp.token
MCP-серверРазрешить изменение настроекsystem.web_server.mcp.allow_writes
MCP-серверРазрешить активные проверкиsystem.web_server.mcp.allow_active_probes
Хаб сообществаВключить хаб сообществаsystem.hub.enabled
Хаб сообществаЗеркала хабаsystem.hub.urls
Хаб сообществаПубличный ключ хабаsystem.hub.public_key

API-ключ AI-помощника в этот файл не входит: b4 хранит его в ai_secrets.json.

Редактор сета​

ВкладкаПолеПуть
ЦелиФильтр версии IPtargets.ip_version
ЦелиТолько по доменуtargets.domain_only
ЦелиПриоритет IPtargets.ip_priority
TCP > ОсновныеФильтр портовtcp.dport_filter
TCP > ОсновныеИзменять окно реальных TCP-пакетовtcp.wssize.enabled
TCP > ОсновныеРазмер окнаtcp.wssize.window
TCP > ОсновныеОпция Window ScaleНе изменять: tcp.wssize.scale равно 0, tcp.wssize.strip_scale равно false. Уменьшить до значения: tcp.wssize.scale больше 0. Удалить опцию: tcp.wssize.strip_scale равно true
TCP > ОсновныеМасштаб окна (Window Scale)tcp.wssize.scale
TCP > ОсновныеПрекратить изменение окнаtcp.wssize.cutoff: пустая строка - После ClientHello, first_data - После первого пакета данных
TCP > ФейкингСгенерированный payloadfaking.payload_file, путь вида captures/tls_youtube_com.bin
UDPСовпадение QUICudp.filter_quic
UDPФильтр портовudp.dport_filter
UDPЗвонкиudp.filter_stun, true для Пропускать начало звонков и false для Обрабатывать как остальной UDP. Обрабатывать только звонки - это непустой udp.filter_l7, см. Звонки сета
UDPКакие звонкиudp.filter_l7, discord и stun для Приложение Discord и браузеры, discord для Приложение Discord, stun для Браузеры
UDPРежим действияudp.mode
UDPPayload фейкового пакетаudp.fake_payload_file, @stun для (авто: STUN-запрос)
DNS & МаршрутизацияВключить перенаправление DNSdns.enabled
DNS & МаршрутизацияРезолверыdns.doh_url или dns.target_dns для первого резолвера и dns.upstreams для остальных, см. Резолверы сета
DNS & МаршрутизацияФрагментировать DNS-запросыdns.fragment_query
DNS & МаршрутизацияОтдавать SERVFAIL, если ни один резолвер не доступенdns.strict
DNS & МаршрутизацияУбирать ключи ECH из ответов DNSdns.strip_ech
DNS & МаршрутизацияЗакреплённые адресаdns.pins, имя и его адреса
DNS & МаршрутизацияВключить DSCP для сетаdscp.enabled
DNS & МаршрутизацияЗначение DSCPdscp.value
ДискавериСписок адресовdiscovery.urls
ДискавериПоддерживать работу сета с помощью мониторингаdiscovery.watchdog

Дашборд​

ЭлементПуть
Раскладка, сохранённая через Настроитьui.dashboard

Настройки без поля в интерфейсе​

Эти настройки есть только в файле.

ПутьЧто делаетПо умолчанию
system.web_server.mcp.allowed_originsOrigin страниц браузера, которые точка доступа MCP принимает помимо собственного адреса b4. Одиночная * принимает любой originПусто
system.checker.watchdog.heal_validation_triesСколько загрузок подряд должна пройти стратегия при поиске во время восстановления3
system.checker.watchdog.verify_triesСколько попыток получает каждый адрес в проверке после того, как восстановление записало стратегию2
system.checker.discovery_flow_mark, system.checker.discovery_injected_markМетки тестового трафика Дискавери, см. Метки пакетовМетка очереди плюс 1 и плюс 2
queue.tun.route_tableФиксированная таблица маршрутизации для движка TUN вместо свободной, которую выбирает b4, см. Метки пакетовВыбирает b4
sets[].routing.fwmark, sets[].routing.tableЗакреплённые метка и таблица для сета, который маршрутизирует трафик. Используются, только когда заданы обе, см. Метки пакетовВыбирает b4

Правка вручную​

version в начале файла - версия формата конфигурации. b4 читает её, чтобы понять, что нужно мигрировать, поэтому при правке остального её не меняют.

предупреждение

Значения в файле проверяются только при запуске b4, и файл, не прошедший проверку, останавливает b4 с ошибкой invalid configuration. b4 читает файл только при запуске, поэтому ручная правка вступает в силу после перезапуска. Любое сохранение до перезапуска записывает в файл работающую конфигурацию, и ручная правка теряется. Сохраняют веб-интерфейс, MCP, восстановление мониторингом, закачка геоданных и обновление префиксов ASN.

Миграции​

Когда формат меняется между выпусками, b4 мигрирует файл при запуске: новые поля приходят со значениями по умолчанию, переименованные переносятся. Прежде чем что-либо изменить, b4 кладёт рядом резервную копию с именем по версии, с которой мигрирует, например b4.json.v51.bak.

Файл, который не удаётся прочитать при запуске, например обрезанный при пропадании питания или с синтаксической ошибкой JSON, копируется рядом как b4.json.corrupt. Если там уже лежит копия с другим содержимым, имя будет b4.json.corrupt.1 и далее. Лог называет эту копию. Затем b4 запускается со значениями по умолчанию, а следующее сохранение заменяет исходный файл, так что непрочитанные настройки остаются только в копии.

Файл, у которого version выше, чем понимает запущенная сборка, загружается как есть, с предупреждением. Незнакомые этой сборке настройки отбрасываются при следующем сохранении.