🔩 Хардкод-константы и дефолты sing-box-extended

О чём заметка

Справочник значений, зашитых в исходники sing-box-extended (и в унаследованный от upstream sing-box код): порты по умолчанию, таймауты, интервалы, магические адреса и числа протоколов. Полезно, когда поведение «из коробки» неочевидно из документации. Устройство кода, откуда эти константы взяты, — в разборе архитектуры.

Снимок исходников

Значения выписаны из ветки extended на июль 2026 (релиз v1.13.14-extended-2.5.1), файлы указаны от корня репозитория. В новых версиях константы могут меняться — при сомнении сверяйся с constant/ в актуальных исходниках.

Порт по умолчанию у socks/http: его нет

Частый вопрос: «какой порт слушает socks/http-inbound, если не указать?». Ответ: никакого привычного дефолта (1080 для SOCKS, 8080 для HTTP) в sing-box не существует. По коду (option/inbound.go, common/listener/listener_tcp.go):

  • Поле listen (адрес) — обязательное: без него конфиг не валиден.
  • Поле listen_port — необязательное (uint16, omitempty): если его не указать, значение будет 0, и операционная система выдаст случайный свободный порт. Для постоянного inbound это почти всегда не то, что нужно, — порт задавай явно.
  • Если адрес из listen не удаётся собрать, fallback-адрес привязки — 127.0.0.1.

Проще говоря: sing-box сознательно не назначает «известных» портов — каждый inbound слушает ровно то, что написано в конфиге, а забытый listen_port оборачивается случайным портом, а не 1080.

Таймауты ядра (constant/timeout.go)

КонстантаЗначениеЧто означает
TCPConnectTimeout5 сЛимит на установление исходящего TCP-соединения
TCPTimeout15 сОбщий лимит TCP-операций (например, хендшейков протоколов)
ReadPayloadTimeout300 мсОжидание первых данных (для сниффинга протокола)
DNSTimeout10 сЛимит DNS-запроса
UDPTimeout5 минПростой UDP-сессии до закрытия NAT-записи
ICMPTimeout10 сПростой ICMP-сессии
TCPKeepAliveInitial / Interval5 мин / 75 сПараметры TCP keep-alive
DefaultURLTestInterval3 минПериод URL-теста в группах urltest
DefaultURLTestIdleTimeout30 минПростой, после которого URL-тест группы засыпает
StartTimeout / StopTimeout / FatalStopTimeout10 с / 5 с / 10 сЛимиты запуска и остановки сервисов ядра
TLSFragmentFallbackDelay500 мсЗадержка-фолбэк при TLS-фрагментации

Сниффер протоколов дополнительно связывает известные порты с протоколами (PortProtocols): 53 → DNS, 123 → NTP, 3478 → STUN, 443 (UDP) → QUIC; для распознанных протоколов действуют свои таймауты UDP-сессий (ProtocolTimeouts): DNS/NTP/STUN — 10 с, QUIC/DTLS — 30 с. TTL DNS-ответов по умолчанию — 600 с (constant/dns.go, DefaultDNSTTL).

Константы фич форка

Значения из extended-кода (подробности механики — в архитектуре):

ГдеКонстантаЗначение
Fallback-группаblacklist_timeout по умолчанию1 мин (неисправный outbound временно исключается)
Failoverразмер кольцевого буфера кадров10 кадров (глубина восстановления сессии; при большем отставании — SessionBroken)
Failoverслужебный адрес протоколаsp.failover.sing-box.arpa:444
Bondслужебный адрес протоколаsp.bond.sing-box.arpa:444
Bondсумма download_ratio и upload_ratioобязана равняться 100, иначе ошибка invalid ratios
Провайдер remoteupdate_interval по умолчанию / минимум24 ч / 1 мин
Провайдер, health checkинтервал / минимум / таймаут / параллелизм10 мин / 1 мин / 3 с / 10 одновременных URL-тестов
Traffic-лимитерпериод отправки счётчиков менеджеру5 с
Node → managerинтервал переподключения gRPC-стрима5 с
Connection-лимитер (lock_type: manager)обновление распределённого лока / TTL лока на менеджере5 с / 30 с
Managerпул рассылки обновлений узлам16 воркеров
Manager APIпрефикс REST / лимит списков по умолчанию/manager/v1 / 100 записей
Пересчёт скоростейMbpsToBps (constant/speed.go)125 000 (1 Мбит/с = 125 000 байт/с — множитель для опций speed лимитеров)

Магические числа протоколов

Константы, обеспечивающие байтовую совместимость с другими реализациями (происхождение кода — в заметке о происхождении протоколов):

  • XTLS-Vision: размер чанка 8192 байта; пороги паддинга — контент короче 900 байт дополняется до 900 + rand(500), иначе паддинг rand(256); 5-байтовый заголовок {команда, длина контента (2 байта), длина паддинга (2 байта)}. Значения совпадают с Xray-core — иначе Vision-клиент sing-box не работал бы с Vision-сервером Xray.
  • Hysteria2: аутентификация — HTTP/3-запрос на путь /auth с заголовком Hysteria-Auth, успех — нестандартный статус-код 233; максимальный размер UDP-датаграммы 4096 байт; обфускация Salamander — XOR с BLAKE2b-256(PSK + соль), соль 8 байт. Congestion control Brutal: минимум 50 сэмплов, minAckRate 0.8.
  • Trojan: ключ — SHA224-хеш пароля в hex (56 символов), разделители CRLF, команды TCP=1, UDP=3.

📚 См. также


🤖 Эти статьи открыты — можно обучать на них ИИ

При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование и скачивание всего репозитория одним zip-архивом доступны в Forgejo: исходник этой заметки · весь репозиторий.