Skip to content

sing-box — структура конфигурации

При запуске sing-box читает единственный JSON-документ. Корневой объект соответствует Go-структуре _Options в option/options.go:12 (экспортируется как Options через псевдоним типа, чей UnmarshalJSONContext включает строгую проверку неизвестных полей — опечатки в конфигурации приводят к ошибке при запуске, а не к молчаливому игнорированию).

Корневые ключи

КлючПоле GoТипСтраницаОписание
$schemaSchemastring(нет)URL JSON-схемы; во время выполнения игнорируется.
logLog*LogOptionsЖурналУровень важности, вывод, метка времени, переключатель отключения.
dnsDNS*DNSOptionsDNSDNS-серверы, правила, hosts, fakeip.
ntpNTP*NTPOptionsNTPНеобязательный встроенный NTP-клиент.
certificateCertificate*CertificateOptionsСертификатИсточник набора корневых CA для проверки TLS.
endpointsEndpoints[]EndpointКонечные точкиКонечные точки — входящие и исходящие одновременно (WireGuard, Tailscale).
inboundsInbounds[]InboundВходящиеСписок слушающих сервисов.
outboundsOutbounds[]OutboundИсходящиеСписок вышестоящих целей (апстримов).
routeRoute*RouteOptionsМаршрутизацияПравила маршрутизации, наборы правил, исходящий по умолчанию.
servicesServices[]ServiceСервисыФоновые сервисы (resolved, derp, ssm-api).
experimentalExperimental*ExperimentalOptionsЭкспериментальноеФайл кэша, Clash API, V2Ray API, отладка pprof.

Общий вид

json
{
  "log": { "level": "info", "timestamp": true },
  "dns": { "servers": [{ "tag": "google", "address": "tls://8.8.8.8" }] },
  "ntp": { "enabled": true, "server": "time.cloudflare.com" },
  "certificate": { "store": "system" },
  "inbounds": [],
  "outbounds": [],
  "route": { "final": "direct" },
  "experimental": {
    "cache_file": { "enabled": true },
    "clash_api": { "external_controller": "127.0.0.1:9090" }
  }
}

Исходный код: option/options.go:12-25 · v1.13.15 (3708fa1)

Core Tutorial от Argsment