sing-box — структура конфигурации
При запуске sing-box читает единственный JSON-документ. Корневой объект соответствует Go-структуре _Options в option/options.go:12 (экспортируется как Options через псевдоним типа, чей UnmarshalJSONContext включает строгую проверку неизвестных полей — опечатки в конфигурации приводят к ошибке при запуске, а не к молчаливому игнорированию).
Корневые ключи
| Ключ | Поле Go | Тип | Страница | Описание |
|---|---|---|---|---|
$schema | Schema | string | (нет) | URL JSON-схемы; во время выполнения игнорируется. |
log | Log | *LogOptions | Журнал | Уровень важности, вывод, метка времени, переключатель отключения. |
dns | DNS | *DNSOptions | DNS | DNS-серверы, правила, hosts, fakeip. |
ntp | NTP | *NTPOptions | NTP | Необязательный встроенный NTP-клиент. |
certificate | Certificate | *CertificateOptions | Сертификат | Источник набора корневых CA для проверки TLS. |
endpoints | Endpoints | []Endpoint | Конечные точки | Конечные точки — входящие и исходящие одновременно (WireGuard, Tailscale). |
inbounds | Inbounds | []Inbound | Входящие | Список слушающих сервисов. |
outbounds | Outbounds | []Outbound | Исходящие | Список вышестоящих целей (апстримов). |
route | Route | *RouteOptions | Маршрутизация | Правила маршрутизации, наборы правил, исходящий по умолчанию. |
services | Services | []Service | Сервисы | Фоновые сервисы (resolved, derp, ssm-api). |
experimental | Experimental | *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)
