Входящие

inbounds — массив слушающих сервисов. В отличие от Xray-core здесь нет вложенного блока settings: каждая запись — плоский объект, состоящий из описанного ниже конверта type / tag и собственных полей выбранного типа, объединённых на том же уровне. Сначала декодируется конверт, затем оставшиеся ключи декодируются в структуру параметров, зарегистрированную для type; неизвестные поля отклоняются.

Конверт

Поле	Тип	По умолчанию	Допустимые значения	Описание
type	string	—	tun | redirect | tproxy | direct | socks | http | mixed | shadowsocks | snell | vmess | trojan | naive | shadowtls | vless | anytls | hysteria | tuic | hysteria2 | cloudflared	Тип входящего. Определяет, в какую структуру параметров декодируется остальная часть объекта. Незарегистрированное значение приводит к ошибке запуска "unknown inbound type".
tag	string	—	—	Уникальное имя этого входящего. На него ссылаются правила маршрутизации (inbound) и строки журнала.

Исходный код: option/inbound.go:21-25 · зафиксировано на v1.14.2 (af6e64c)

Поля конкретных типов описаны на страницах протоколов: TUN, Перенаправление и TProxy, Direct, HTTP и SOCKS (также mixed), Shadowsocks, VMess, Trojan, Naive, VLESS, AnyTLS, Hysteria2, TUIC. snell и cloudflared описаны на страницах Snell и cloudflared.

Общие поля прослушивания (ListenOptions)

Каждый входящий на основе сокета встраивает ListenOptions; поля располагаются на том же плоском уровне, что и конверт.

Поле	Тип	По умолчанию	Допустимые значения	Описание
listen	*badoption.Addr	—	—	Адрес для привязки, например "::" или "127.0.0.1".
listen_port	uint16	—	—	Порт для прослушивания.
bind_interface	string	—	—	Сетевой интерфейс, к которому привязывается слушатель.
routing_mark	FwMark	—	—	SO_MARK (fwmark), устанавливаемый на слушающем сокете. Только Linux.
reuse_addr	bool	false	true | false	Установить SO_REUSEADDR на слушателе.
netns	string	—	—	Сетевое пространство имён, в котором вести прослушивание: имя или путь либо тег элемента верхнеуровневого network_namespaces. Только Linux.
disable_tcp_keep_alive	bool	false	true | false	Отключить TCP keep-alive для принятых соединений.
tcp_keep_alive	badoption.Duration	—	—	Период простоя до начала keep-alive-проб. Строка длительности, например "15m".
tcp_keep_alive_interval	badoption.Duration	—	—	Интервал между keep-alive-пробами. Строка длительности.
tcp_fast_open	bool	false	true | false	Включить TCP Fast Open на слушателе.
tcp_multi_path	bool	false	true | false	Включить Multipath TCP (требуется поддержка MPTCP в Go на данной платформе).
udp_fragment	*bool	false	true | false	Разрешить фрагментацию UDP-пакетов крупнее MTU вместо их отбрасывания.
udp_timeout	UDPTimeoutCompat	—	—	Тайм-аут простоя записей UDP NAT. Строка длительности; фактическое значение по умолчанию зависит от протокола, определённого сниффингом.
detour	string	—	—	Передавать принятые соединения напрямую в другой входящий, указанный по его тегу.
proxy_protocol	bool	—	—	Не поддерживается: поддержки заголовка PROXY-протокола нет; установка этого поля — ошибка.
proxy_protocol_accept_no_header	bool	—	—	Не поддерживается, как и proxy_protocol.

Исходный код: option/inbound.go:79-103 · зафиксировано на v1.14.2 (af6e64c)

Минимальный пример

{
  "inbounds": [
    {
      "type": "mixed",
      "tag": "mixed-in",
      "listen": "127.0.0.1",
      "listen_port": 2080
    }
  ]
}

Примечания

• Строгий анмаршалер действует и внутри записей входящих: опечатка в имени любого поля — ошибка запуска, а не молчаливое игнорирование.
• У входящих нет полей сниффинга: sniff, sniff_override_destination, sniff_timeout, domain_strategy и udp_disable_domain_unmapping отклоняются при запуске с ошибкой, ссылающейся на миграцию к действиям правил. Сниффинг задаётся в правилах маршрутизации.
• shadowsocksr зарегистрирован лишь как заглушка, возвращающая ошибку: реализации ShadowsocksR в sing-box нет.
• hysteria, tuic и hysteria2 требуют сборки с тегом with_quic, а cloudflared — с тегом with_cloudflared (официальные релизные бинарники включают оба).
• snell — серверная сторона Snell, парная исходящему snell.
• cloudflared запускает встроенный клиент Cloudflare Tunnel, аутентифицируемый token туннеля, и пропускает входящий трафик туннеля (TCP, UDP, ICMP) через маршрутизацию sing-box. Он не слушает локальный сокет, поэтому ListenOptions к нему не применяются.

Сравнение с другими ядрами

• Xray-core вкладывает поля протокола в объект settings и держит сниффинг на уровне входящего. См. Входящие Xray.
• mihomo использует отдельные корневые ключи (port, socks-port, mixed-port, …) плюс список listeners. См. HTTP и SOCKS и Перенаправление и TProxy.

Исходный код: option/inbound.go:21-25 · v1.14.2 (af6e64c)