// Package dockerdaemon implements the systemd-managed Docker daemon Target. package dockerdaemon import ( "context" "crypto/sha256" "encoding/hex" "encoding/json" "errors" "fmt" "io/fs" "net/url" "os" "os/exec" "path/filepath" "strings" "proxyctl/internal/profile" "proxyctl/internal/securefs" "proxyctl/internal/target" ) const service = "docker.service" type Configuration struct { DaemonConfigPath string RecoveryPath string TrustedRoot string } func DefaultConfiguration() Configuration { return Configuration{DaemonConfigPath: "/etc/docker/daemon.json", RecoveryPath: "/var/lib/proxyctl/docker-daemon.json", TrustedRoot: "/"} } type FileSystem interface { ReadFile(string) ([]byte, error) FileMode(string) (os.FileMode, error) AtomicWrite(string, []byte, os.FileMode) error Remove(string) error } type OSFileSystem struct{ store securefs.Store } func NewOSFileSystem(configuration Configuration) OSFileSystem { root := configuration.TrustedRoot if root == "" { root = "/" } return OSFileSystem{store: securefs.Store{TrustedRoot: root}} } func (f OSFileSystem) ReadFile(path string) ([]byte, error) { return f.store.ReadFile(path) } func (f OSFileSystem) FileMode(path string) (os.FileMode, error) { return f.store.FileMode(path) } func (f OSFileSystem) AtomicWrite(path string, data []byte, mode os.FileMode) error { return f.store.AtomicWrite(path, data, mode) } func (f OSFileSystem) Remove(path string) error { return f.store.Remove(path) } type CommandRunner interface { Run(context.Context, string, ...string) ([]byte, error) } type ExecRunner struct{} func (ExecRunner) Run(ctx context.Context, name string, args ...string) ([]byte, error) { output, err := exec.CommandContext(ctx, name, args...).CombinedOutput() if err != nil { return output, fmt.Errorf("%s: %s: %w", name, strings.TrimSpace(string(output)), err) } return output, nil } type Adapter struct { configuration Configuration files FileSystem runner CommandRunner } func New(configuration Configuration, files FileSystem, runner CommandRunner) *Adapter { if configuration.DaemonConfigPath == "" { configuration.DaemonConfigPath = "/etc/docker/daemon.json" } if configuration.RecoveryPath == "" { configuration.RecoveryPath = "/var/lib/proxyctl/docker-daemon.json" } if files == nil { value := NewOSFileSystem(configuration) files = value } if runner == nil { runner = ExecRunner{} } return &Adapter{configuration: configuration, files: files, runner: runner} } func (a *Adapter) ID() string { return "docker-daemon" } func (a *Adapter) Description() target.Description { return target.Description{ Name: "Docker daemon", Summary: "Configures proxying for Docker daemon operations such as registry access, not container network traffic or container/build defaults.", Details: "Uses managed Docker daemon configuration. Every change reloads systemd and immediately restarts Docker, which may disrupt running work. System-file and service permissions are required; proxyctl reports permission errors and never initiates privilege escalation.", } } func (a *Adapter) Confirmation(bool) string { return "Docker will restart immediately. This may disrupt running containers and other work. Confirm before proxyctl changes daemon configuration." } func (a *Adapter) Availability(ctx context.Context) target.Availability { availability, _ := a.detect(ctx) return availability } func (a *Adapter) detect(ctx context.Context) (target.Availability, error) { output, err := a.runner.Run(ctx, "systemctl", "show", service, "--property=LoadState", "--property=FragmentPath") if err != nil { return target.Availability{Evidence: "A supported systemd-managed Docker daemon was not detected"}, err } values := parseProperties(string(output)) if values["LoadState"] != "loaded" || strings.TrimSpace(values["FragmentPath"]) == "" { return target.Availability{Evidence: "A supported systemd-managed Docker daemon was not detected"}, nil } return target.Availability{Available: true, Evidence: "Docker daemon service is loaded and managed by systemd at " + values["FragmentPath"]}, nil } func parseProperties(output string) map[string]string { result := map[string]string{} for _, line := range strings.Split(output, "\n") { key, value, ok := strings.Cut(line, "=") if ok { result[strings.TrimSpace(key)] = strings.TrimSpace(value) } } return result } type recovery struct { Original []byte `json:"original,omitempty"` OriginalExists bool `json:"originalExists"` OriginalMode uint32 `json:"originalMode,omitempty"` ConfigFingerprint string `json:"configFingerprint"` RestartedFingerprint string `json:"restartedFingerprint,omitempty"` } func (a *Adapter) Inspect(_ context.Context, active *profile.Profile) target.Inspection { metadata, managed, metadataErr := a.readRecovery() data, configErr := a.files.ReadFile(a.configuration.DaemonConfigPath) if managed || (metadataErr != nil && !errors.Is(metadataErr, fs.ErrNotExist)) { if metadataErr != nil { return target.Inspection{State: target.Drifted, Evidence: "managed Docker daemon recovery metadata cannot be read"} } if configErr != nil { return target.Inspection{State: target.Drifted, Evidence: "managed Docker daemon configuration is missing or unreadable"} } if fingerprint(data) == metadata.ConfigFingerprint && active != nil { normalized, err := compatible(*active) if err == nil && configMatchesProfile(data, normalized) { return target.Inspection{State: target.Enabled, Evidence: "managed Docker daemon configuration matches the Active Profile"} } } return target.Inspection{State: target.Drifted, Evidence: "managed Docker daemon configuration does not match the Active Profile"} } if configErr == nil && recognizesProxy(data) { return target.Inspection{State: target.External, Evidence: "recognized proxy settings exist in Docker daemon configuration"} } return target.Inspection{State: target.Disabled, Evidence: "no recognized Docker daemon proxy configuration detected"} } func (a *Adapter) SetDesired(ctx context.Context, enabled bool, active *profile.Profile) target.OperationResult { if enabled && active == nil { return target.OperationResult{Inspection: a.Inspect(ctx, active), Err: errors.New("no Active Profile; open Profile management to create and activate one")} } var normalized profile.Profile var err error if enabled { normalized, err = compatible(*active) if err != nil { return target.OperationResult{Inspection: a.Inspect(ctx, active), Err: redact(err, active)} } } availability, detectionErr := a.detect(ctx) if detectionErr != nil { return target.OperationResult{Inspection: a.Inspect(ctx, active), Err: redact(fmt.Errorf("detect systemd-managed Docker daemon: %w", detectionErr), active)} } if !availability.Available { return target.OperationResult{Inspection: a.Inspect(ctx, active), Err: errors.New("Docker daemon Target is unavailable: a supported systemd-managed Docker daemon was not detected")} } if enabled { err = a.enable(ctx, normalized) } else { err = a.disable(ctx) } inspection := a.Inspect(ctx, active) return target.OperationResult{Inspection: inspection, Err: redact(err, active)} } func compatible(input profile.Profile) (profile.Profile, error) { p, err := profile.ValidateAndNormalize(input) if err != nil { return profile.Profile{}, err } if p.Mode == profile.AdvancedMode && p.AllURL != "" { return profile.Profile{}, errors.New("Docker daemon Target does not support an ALL/SOCKS proxy; remove it before applying") } for name, raw := range map[string]string{"HTTP": p.HTTPURL, "HTTPS": p.HTTPSURL} { if raw == "" { continue } u, _ := url.Parse(raw) if u.Scheme != "http" && u.Scheme != "https" { return profile.Profile{}, fmt.Errorf("Docker daemon Target does not support %s proxy scheme %q", name, u.Scheme) } } return p, nil } func (a *Adapter) enable(ctx context.Context, p profile.Profile) error { metadata, managed, err := a.readRecovery() if err != nil && !errors.Is(err, fs.ErrNotExist) { return fmt.Errorf("read Docker daemon recovery metadata: %w", err) } current, readErr := a.files.ReadFile(a.configuration.DaemonConfigPath) if readErr != nil && !errors.Is(readErr, fs.ErrNotExist) { return fmt.Errorf("read Docker daemon configuration: %w", readErr) } if !managed { metadata.OriginalExists = readErr == nil if metadata.OriginalExists { metadata.Original = append([]byte(nil), current...) if mode, modeErr := a.files.FileMode(a.configuration.DaemonConfigPath); modeErr == nil { metadata.OriginalMode = uint32(mode.Perm()) } else { return fmt.Errorf("inspect Docker daemon configuration permissions: %w", modeErr) } } } base := current if errors.Is(readErr, fs.ErrNotExist) { base = []byte("{}") } desired, err := mergeConfig(base, p) if err != nil { return fmt.Errorf("parse Docker daemon configuration before changing it: %w", err) } desiredFingerprint := fingerprint(desired) if managed && fingerprint(current) == metadata.ConfigFingerprint && metadata.ConfigFingerprint == desiredFingerprint && metadata.RestartedFingerprint == desiredFingerprint { return nil } metadata.ConfigFingerprint = desiredFingerprint metadata.RestartedFingerprint = "" if err := a.writeRecovery(metadata); err != nil { return fmt.Errorf("persist Docker daemon recovery metadata before changing configuration: %w", err) } if fingerprint(current) != desiredFingerprint { mode := os.FileMode(0o600) if metadata.OriginalExists { mode = os.FileMode(metadata.OriginalMode) } if err := a.files.AtomicWrite(a.configuration.DaemonConfigPath, desired, mode); err != nil { return fmt.Errorf("write Docker daemon configuration after recovery metadata persisted: %w", err) } } if err := a.reloadRestartInspect(ctx); err != nil { return err } metadata.RestartedFingerprint = desiredFingerprint if err := a.writeRecovery(metadata); err != nil { return fmt.Errorf("record completed Docker daemon restart: %w", err) } return nil } func (a *Adapter) disable(ctx context.Context) error { metadata, managed, err := a.readRecovery() if errors.Is(err, fs.ErrNotExist) || !managed { return nil } if err != nil { return fmt.Errorf("read Docker daemon recovery metadata: %w", err) } if metadata.OriginalExists { current, _ := a.files.ReadFile(a.configuration.DaemonConfigPath) if fingerprint(current) != fingerprint(metadata.Original) { if err := a.files.AtomicWrite(a.configuration.DaemonConfigPath, metadata.Original, os.FileMode(metadata.OriginalMode)); err != nil { return fmt.Errorf("restore Docker daemon configuration: %w", err) } } } else if err := a.files.Remove(a.configuration.DaemonConfigPath); err != nil && !errors.Is(err, fs.ErrNotExist) { return fmt.Errorf("remove managed Docker daemon configuration: %w", err) } if err := a.reloadRestartInspect(ctx); err != nil { return err } if err := a.files.Remove(a.configuration.RecoveryPath); err != nil && !errors.Is(err, fs.ErrNotExist) { return fmt.Errorf("remove Docker daemon recovery metadata after restart: %w", err) } return nil } func (a *Adapter) reloadRestartInspect(ctx context.Context) error { if _, err := a.runner.Run(ctx, "systemctl", "daemon-reload"); err != nil { return fmt.Errorf("reload systemd manager configuration: %w", err) } if _, err := a.runner.Run(ctx, "systemctl", "restart", service); err != nil { return fmt.Errorf("restart Docker daemon: %w", err) } output, err := a.runner.Run(ctx, "systemctl", "is-active", service) if err != nil { return fmt.Errorf("inspect Docker daemon after restart: %w", err) } if strings.TrimSpace(string(output)) != "active" { return fmt.Errorf("inspect Docker daemon after restart: service state is %q", strings.TrimSpace(string(output))) } return nil } func (a *Adapter) readRecovery() (recovery, bool, error) { data, err := a.files.ReadFile(a.configuration.RecoveryPath) if err != nil { return recovery{}, false, err } var value recovery if err := json.Unmarshal(data, &value); err != nil { return recovery{}, true, err } return value, true, nil } func (a *Adapter) writeRecovery(value recovery) error { data, err := json.MarshalIndent(value, "", " ") if err != nil { return err } return a.files.AtomicWrite(a.configuration.RecoveryPath, append(data, '\n'), 0o600) } func mergeConfig(data []byte, p profile.Profile) ([]byte, error) { var document map[string]any if len(strings.TrimSpace(string(data))) == 0 { data = []byte("{}") } if err := json.Unmarshal(data, &document); err != nil { return nil, err } if document == nil { document = map[string]any{} } proxies := map[string]any{} if existing, ok := document["proxies"].(map[string]any); ok { for key, value := range existing { proxies[key] = value } } else if _, exists := document["proxies"]; exists { return nil, errors.New("the existing proxies field is not an object") } setOrDelete(proxies, "http-proxy", p.HTTPURL) setOrDelete(proxies, "https-proxy", p.HTTPSURL) setOrDelete(proxies, "no-proxy", strings.Join(p.Bypass, ",")) document["proxies"] = proxies output, err := json.MarshalIndent(document, "", " ") if err != nil { return nil, err } return append(output, '\n'), nil } func setOrDelete(values map[string]any, key, value string) { if value == "" { delete(values, key) } else { values[key] = value } } func configMatchesProfile(data []byte, p profile.Profile) bool { var document map[string]any if json.Unmarshal(data, &document) != nil { return false } proxies, ok := document["proxies"].(map[string]any) if !ok { return false } return stringValue(proxies["http-proxy"]) == p.HTTPURL && stringValue(proxies["https-proxy"]) == p.HTTPSURL && stringValue(proxies["no-proxy"]) == strings.Join(p.Bypass, ",") } func recognizesProxy(data []byte) bool { var document map[string]any if json.Unmarshal(data, &document) != nil { return false } proxies, ok := document["proxies"].(map[string]any) if !ok { return false } for _, key := range []string{"http-proxy", "https-proxy", "no-proxy"} { if stringValue(proxies[key]) != "" { return true } } return false } func stringValue(value any) string { result, _ := value.(string); return result } func fingerprint(data []byte) string { sum := sha256.Sum256(data); return hex.EncodeToString(sum[:]) } type redactedError struct { message string class error } func (e *redactedError) Error() string { return e.message } func (e *redactedError) Is(other error) bool { return e.class != nil && errors.Is(e.class, other) } func redact(err error, active *profile.Profile) error { if err == nil { return nil } message := profile.RedactText(err.Error()) if active != nil { for _, raw := range []string{active.SingleURL, active.HTTPURL, active.HTTPSURL, active.AllURL} { if raw == "" { continue } message = strings.ReplaceAll(message, raw, profile.ObscureURL(raw)) if parsed, parseErr := url.Parse(raw); parseErr == nil && parsed.User != nil { if password, ok := parsed.User.Password(); ok && password != "" { message = strings.ReplaceAll(message, password, "REDACTED") } } } } var class error for _, safe := range []error{os.ErrPermission, fs.ErrNotExist, fs.ErrExist, context.Canceled, context.DeadlineExceeded} { if errors.Is(err, safe) { class = safe break } } return &redactedError{message: message, class: class} } // Paths expose configured effects for diagnostics and hermetic tests. func (a *Adapter) DaemonConfigPath() string { return filepath.Clean(a.configuration.DaemonConfigPath) } func (a *Adapter) RecoveryPath() string { return filepath.Clean(a.configuration.RecoveryPath) }