后续章节请继续阅读下方详细说明。

模块定位与边界

daemon/config/config.go 是 dockerd 的纯配置数据模型 + 加载/校验工具套件：

• 数据模型： Config、CommonConfig、BuilderConfig、BridgeConfig、LogConfig、DNSConfig、TLSOptions、NetworkConfig、Proxies 等，跨网站结构通过匿名嵌入实现扁平化映射。其实，
• 加载工具： New 、MergeDaemonConfigurations 、Reload。
• 校验工具： Validate，ValidateMinAPIVersion 等细粒度检查。
• 网站 setPlatformDefaults/validatePlatformConfig/IsRootless 等，每个网站在对应的 config_.go 中实现。

它不做：

• No runtime state mutation – 所有“应用配置”动作由调用方（daemon.Daemon.Reload,DaemonCli.reloadConfig) 完成。
• No direct flag parsing – flag 集合由外部传入 (*

顶层常量速查

// config.goconst (
DefaultMaxConcurrentDownloads =
DefaultMaxConcurrentUploads =
DefaultDownloadAttempts =
DefaultShmSize int64 = * * // MiB
DefaultNetworkMtu =
DisableNetworkBridge = "none"
DefaultLogDriver = "json-file"
DefaultShutdownTimeout =
DefaultInitBinary = "docker-init"
DefaultRuntimeBinary = "runc"
DefaultContainersNamespace = "moby"
DefaultPluginNamespace = "plugins.moby"
MaxAPIVersion = ""
defaultMinAPIVersion = ""
MinAPIVersion = ""
SeccompProfileDefault = "builtin"
SeccompProfileUnconfined = "unconfined"
LibnetDataPath = "network/files")


API 版本区间：`MaxAPIVersion` 是当前支持最高 API。`MinAPIVersion` 是绝对下限，三者形成合法区间 ``。

命名空间划分：`DefaultContainersNamespace` 与 `DefaultPluginNamespace` 决定 dockerd 在 containerd 中的业务容器 vs 插件命名空间。说起来，

`DisableNetworkBridge = "none"` 对应 CLI `--bridge=none` 的禁用关键字。


三张“白名单” map

`config.go` 顶部定义了三张关键 map，用于控制解析行为：

// 不能被 flatten 的字段——这些 key 在 daemon.json 里要整体当 map 处理
var flatOptions = mapbool{
"cluster-store-opts": true,"default-network-opts": true,"log-opts": true,"runtimes": true。"default-ulimits": true,"features": true,"builder": true,"nri-opts": true,}


// unknown-key 校验时跳过这些
var skipValidateOptions = mapbool{
"features": true,... // 略
}

// 冲突检测时跳过这些
var skipDuplicates = mapbool{
"runtimes": true,}


常见踩坑：误把需要保持整体的 key 放进 flatOptions，会导致配置被错误展开，引发不可预期的行为！请务必核对此表格后再修改代码。

数据模型总览


// config.Config ← 网站相关结构
// └── embeds config.CommonConfig ← 跨网站公共字段
// ├── AuthorizationPlugins string
// ├── ExecOptions string
// ├── GraphDriver string
// ├── GraphOptions string
// ├── Labels string
// ├── Root / ExecRoot / Pidfile …// ├── Proxies …// ├── LiveRestoreEnabled bool
// ├── MaxConcurrentDownloads / Uploads / DownloadAttempts …不过，// ├── ShutdownTimeout int
// ├── Hosts string
// ├── TLS *bool / TLSVerify *bool // 三态：未设置 / true / false
// ├── DaemonLogConfig …// ├── TLSOptions …其实，// ├── DNSConfig …老实说，// ├── LogConfig …
// ├── BridgeConfig …// ├── NetworkConfig …老实说，...
// ValuesSet mapany ← 不序列化。记录“哪些字段是文件里显式设置的”



痛点：很多使用者以为空字符串或零值代表“未设置”，实际只有 `ValuesSet` 能判断是否为使用者显式写入。
误用会导致热重载时默认值覆盖已有运行状态！


ValuesSet

type CommonConfig struct {
// ...
ValuesSet mapany json:"-" // 不参与序列化
}
func IsValueSet bool {
_。ok := conf.ValuesSet
return ok
}



`ValuesSet` 在 `getConflictFreeConfiguration` 中填充，用来判断某选项是否在 `daemon.json` 中显式出现。其实，热重载只会修改那些已显式设置的字段，从而避免意外
默认值。其实，

嵌入式子结构逐一解读

LogConfig 

type LogConfig struct {
Type string json:"log-driver。omitempty"
Config mapstring json:"log-opts,omitempty"
}



`flatOptions == true` 表示该键 **不** 被展平，而是整体保存为 map，以适配不同日志驱动各自不同的选项集合。误把它从白名单中移除会导致选项被错误拆散成顶层键，引起冲突检测失败。

DaemonLogConfig 

type DaemonLogConfig struct {
LogLevel string json:"log-level,omitempty" // panic/fatal/error/warn/info/debug/trace
LogFormat log.OutputFormat json:"log-format。omitempty" // text/json
RawLogs bool json:"raw-logs,omitempty" // 不做 daemon 序号前缀
}



常见错误：把自定义日志级别写成大写或拼写错误，会在 Validate 时直接报错且无法启动！话说回来，请严格遵循小写枚举。

TLSOptions 

type TLSOptions struct {
CAFile string json:"tlscacert,omitempty"
CertFile string json:"tlscert。omitempty"
KeyFile string json:"tlskey,omitempty"
}



`CommonConfig.TLS` 与 `TLSVerify` 为 `*bool*` 三态设计——未设置 使用默认行为；显式 `true/false*` 覆盖默认。这是防止零值误覆盖的关键机制，也是许多使用者在配置中遗漏布尔标记导致 “TLS 不生效” 的根源所在。

DNSConfig 

type DNSConfig struct {
DNS netip.Addr json:"dns,omitempty"
DNSOptions string json:"dns-opts,omitempty"
DNSSearch string json:"dns-search。omitempty"
HostGatewayIP net.IP json:"host-gateway-ip,omitempty" // Deprecated
HostGatewayIPs netip.Addr json:"host-gateway-ips,omitempty" // 新版多 IP 支持
}



迁移陷阱：旧键 host-gateway-ip 与新键 host-gateway-ips 同时出现会触发冲突错误；仅保留老键且未迁移也会被自动转换为新版格式。务必检查旧配置文件，

迁移映射表

var migratedNamedConfig = mapstruct{
newName string
migrate func
}{
"host-gateway-ip": {newName: "host-gateway-ips",migrate: migrateHostGatewayIP}。}



Proxies 

type Proxies struct {


HTTPProxy string json:"http-proxy,omitempty"











---