package daemon // import "github.com/docker/docker/daemon" import ( "context" "fmt" "os" "runtime" "strings" "time" "github.com/containerd/log" "github.com/docker/docker/api" "github.com/docker/docker/api/types" "github.com/docker/docker/api/types/system" "github.com/docker/docker/cli/debug" "github.com/docker/docker/daemon/config" "github.com/docker/docker/daemon/logger" "github.com/docker/docker/dockerversion" "github.com/docker/docker/pkg/fileutils" "github.com/docker/docker/pkg/meminfo" "github.com/docker/docker/pkg/parsers/kernel" "github.com/docker/docker/pkg/parsers/operatingsystem" "github.com/docker/docker/pkg/platform" "github.com/docker/docker/pkg/sysinfo" "github.com/docker/docker/registry" metrics "github.com/docker/go-metrics" "github.com/opencontainers/selinux/go-selinux" ) // SystemInfo returns information about the host server the daemon is running on. func (daemon *Daemon) SystemInfo() *system.Info { defer metrics.StartTimer(hostInfoFunctions.WithValues("system_info"))() sysInfo := daemon.RawSysInfo() cfg := daemon.config() v := &system.Info{ ID: daemon.id, Images: daemon.imageService.CountImages(), IPv4Forwarding: !sysInfo.IPv4ForwardingDisabled, BridgeNfIptables: !sysInfo.BridgeNFCallIPTablesDisabled, BridgeNfIP6tables: !sysInfo.BridgeNFCallIP6TablesDisabled, Name: hostName(), SystemTime: time.Now().Format(time.RFC3339Nano), LoggingDriver: daemon.defaultLogConfig.Type, KernelVersion: kernelVersion(), OperatingSystem: operatingSystem(), OSVersion: osVersion(), IndexServerAddress: registry.IndexServer, OSType: runtime.GOOS, Architecture: platform.Architecture, RegistryConfig: daemon.registryService.ServiceConfig(), NCPU: sysinfo.NumCPU(), MemTotal: memInfo().MemTotal, GenericResources: daemon.genericResources, DockerRootDir: cfg.Root, Labels: cfg.Labels, ExperimentalBuild: cfg.Experimental, ServerVersion: dockerversion.Version, HTTPProxy: config.MaskCredentials(getConfigOrEnv(cfg.HTTPProxy, "HTTP_PROXY", "http_proxy")), HTTPSProxy: config.MaskCredentials(getConfigOrEnv(cfg.HTTPSProxy, "HTTPS_PROXY", "https_proxy")), NoProxy: getConfigOrEnv(cfg.NoProxy, "NO_PROXY", "no_proxy"), LiveRestoreEnabled: cfg.LiveRestoreEnabled, Isolation: daemon.defaultIsolation, CDISpecDirs: promoteNil(cfg.CDISpecDirs), } daemon.fillContainerStates(v) daemon.fillDebugInfo(v) daemon.fillAPIInfo(v, &cfg.Config) // Retrieve platform specific info daemon.fillPlatformInfo(v, sysInfo, cfg) daemon.fillDriverInfo(v) daemon.fillPluginsInfo(v, &cfg.Config) daemon.fillSecurityOptions(v, sysInfo, &cfg.Config) daemon.fillLicense(v) daemon.fillDefaultAddressPools(v, &cfg.Config) return v } // SystemVersion returns version information about the daemon. func (daemon *Daemon) SystemVersion() types.Version { defer metrics.StartTimer(hostInfoFunctions.WithValues("system_version"))() kernelVersion := kernelVersion() cfg := daemon.config() v := types.Version{ Components: []types.ComponentVersion{ { Name: "Engine", Version: dockerversion.Version, Details: map[string]string{ "GitCommit": dockerversion.GitCommit, "ApiVersion": api.DefaultVersion, "MinAPIVersion": api.MinVersion, "GoVersion": runtime.Version(), "Os": runtime.GOOS, "Arch": runtime.GOARCH, "BuildTime": dockerversion.BuildTime, "KernelVersion": kernelVersion, "Experimental": fmt.Sprintf("%t", cfg.Experimental), }, }, }, // Populate deprecated fields for older clients Version: dockerversion.Version, GitCommit: dockerversion.GitCommit, APIVersion: api.DefaultVersion, MinAPIVersion: api.MinVersion, GoVersion: runtime.Version(), Os: runtime.GOOS, Arch: runtime.GOARCH, BuildTime: dockerversion.BuildTime, KernelVersion: kernelVersion, Experimental: cfg.Experimental, } v.Platform.Name = dockerversion.PlatformName daemon.fillPlatformVersion(&v, cfg) return v } func (daemon *Daemon) fillDriverInfo(v *system.Info) { v.Driver = daemon.imageService.StorageDriver() v.DriverStatus = daemon.imageService.LayerStoreStatus() const warnMsg = ` WARNING: The %s storage-driver is deprecated, and will be removed in a future release. Refer to the documentation for more information: https://docs.docker.com/go/storage-driver/` switch v.Driver { case "overlay": v.Warnings = append(v.Warnings, fmt.Sprintf(warnMsg, v.Driver)) } fillDriverWarnings(v) } func (daemon *Daemon) fillPluginsInfo(v *system.Info, cfg *config.Config) { v.Plugins = system.PluginsInfo{ Volume: daemon.volumes.GetDriverList(), Network: daemon.GetNetworkDriverList(), // The authorization plugins are returned in the order they are // used as they constitute a request/response modification chain. Authorization: cfg.AuthorizationPlugins, Log: logger.ListDrivers(), } } func (daemon *Daemon) fillSecurityOptions(v *system.Info, sysInfo *sysinfo.SysInfo, cfg *config.Config) { var securityOptions []string if sysInfo.AppArmor { securityOptions = append(securityOptions, "name=apparmor") } if sysInfo.Seccomp && supportsSeccomp { if daemon.seccompProfilePath != config.SeccompProfileDefault { v.Warnings = append(v.Warnings, "WARNING: daemon is not using the default seccomp profile") } securityOptions = append(securityOptions, "name=seccomp,profile="+daemon.seccompProfilePath) } if selinux.GetEnabled() { securityOptions = append(securityOptions, "name=selinux") } if rootIDs := daemon.idMapping.RootPair(); rootIDs.UID != 0 || rootIDs.GID != 0 { securityOptions = append(securityOptions, "name=userns") } if Rootless(cfg) { securityOptions = append(securityOptions, "name=rootless") } if cgroupNamespacesEnabled(sysInfo, cfg) { securityOptions = append(securityOptions, "name=cgroupns") } if noNewPrivileges(cfg) { securityOptions = append(securityOptions, "name=no-new-privileges") } v.SecurityOptions = securityOptions } func (daemon *Daemon) fillContainerStates(v *system.Info) { cRunning, cPaused, cStopped := stateCtr.get() v.Containers = cRunning + cPaused + cStopped v.ContainersPaused = cPaused v.ContainersRunning = cRunning v.ContainersStopped = cStopped } // fillDebugInfo sets the current debugging state of the daemon, and additional // debugging information, such as the number of Go-routines, and file descriptors. // // Note that this currently always collects the information, but the CLI only // prints it if the daemon has debug enabled. We should consider to either make // this information optional (cli to request "with debugging information"), or // only collect it if the daemon has debug enabled. For the CLI code, see // https://github.com/docker/cli/blob/v20.10.12/cli/command/system/info.go#L239-L244 func (daemon *Daemon) fillDebugInfo(v *system.Info) { v.Debug = debug.IsEnabled() v.NFd = fileutils.GetTotalUsedFds() v.NGoroutines = runtime.NumGoroutine() v.NEventsListener = daemon.EventsService.SubscribersCount() } func (daemon *Daemon) fillAPIInfo(v *system.Info, cfg *config.Config) { const warn string = ` Access to the remote API is equivalent to root access on the host. Refer to the 'Docker daemon attack surface' section in the documentation for more information: https://docs.docker.com/go/attack-surface/` for _, host := range cfg.Hosts { // cnf.Hosts is normalized during startup, so should always have a scheme/proto proto, addr, _ := strings.Cut(host, "://") if proto != "tcp" { continue } if cfg.TLS == nil || !*cfg.TLS { v.Warnings = append(v.Warnings, fmt.Sprintf("WARNING: API is accessible on http://%s without encryption.%s", addr, warn)) continue } if cfg.TLSVerify == nil || !*cfg.TLSVerify { v.Warnings = append(v.Warnings, fmt.Sprintf("WARNING: API is accessible on https://%s without TLS client verification.%s", addr, warn)) continue } } } func (daemon *Daemon) fillDefaultAddressPools(v *system.Info, cfg *config.Config) { for _, pool := range cfg.DefaultAddressPools.Value() { v.DefaultAddressPools = append(v.DefaultAddressPools, system.NetworkAddressPool{ Base: pool.Base, Size: pool.Size, }) } } func hostName() string { hostname := "" if hn, err := os.Hostname(); err != nil { log.G(context.TODO()).Warnf("Could not get hostname: %v", err) } else { hostname = hn } return hostname } func kernelVersion() string { var kernelVersion string if kv, err := kernel.GetKernelVersion(); err != nil { log.G(context.TODO()).Warnf("Could not get kernel version: %v", err) } else { kernelVersion = kv.String() } return kernelVersion } func memInfo() *meminfo.Memory { memInfo, err := meminfo.Read() if err != nil { log.G(context.TODO()).Errorf("Could not read system memory info: %v", err) memInfo = &meminfo.Memory{} } return memInfo } func operatingSystem() (operatingSystem string) { defer metrics.StartTimer(hostInfoFunctions.WithValues("operating_system"))() if s, err := operatingsystem.GetOperatingSystem(); err != nil { log.G(context.TODO()).Warnf("Could not get operating system name: %v", err) } else { operatingSystem = s } if inContainer, err := operatingsystem.IsContainerized(); err != nil { log.G(context.TODO()).Errorf("Could not determine if daemon is containerized: %v", err) operatingSystem += " (error determining if containerized)" } else if inContainer { operatingSystem += " (containerized)" } return operatingSystem } func osVersion() (version string) { defer metrics.StartTimer(hostInfoFunctions.WithValues("os_version"))() version, err := operatingsystem.GetOperatingSystemVersion() if err != nil { log.G(context.TODO()).Warnf("Could not get operating system version: %v", err) } return version } func getEnvAny(names ...string) string { for _, n := range names { if val := os.Getenv(n); val != "" { return val } } return "" } func getConfigOrEnv(config string, env ...string) string { if config != "" { return config } return getEnvAny(env...) } // promoteNil converts a nil slice to an empty slice of that type. // A non-nil slice is returned as is. func promoteNil[S ~[]E, E any](s S) S { if s == nil { return S{} } return s }