package rootlessnetns import ( "errors" "fmt" "io/fs" "os" "path/filepath" "strconv" "strings" "syscall" "github.com/containernetworking/plugins/pkg/ns" "github.com/containers/common/libnetwork/resolvconf" "github.com/containers/common/libnetwork/slirp4netns" "github.com/containers/common/pkg/config" "github.com/containers/common/pkg/netns" "github.com/containers/common/pkg/systemd" "github.com/containers/storage/pkg/homedir" "github.com/containers/storage/pkg/lockfile" "github.com/hashicorp/go-multierror" "github.com/opencontainers/runtime-spec/specs-go" "github.com/opencontainers/selinux/go-selinux/label" "github.com/sirupsen/logrus" "golang.org/x/sys/unix" ) type NetworkBackend int const ( Netavark NetworkBackend = iota CNI ) const ( // rootlessNetnsDir is the directory name rootlessNetnsDir = "rootless-netns" // refCountFile file name for the ref count file refCountFile = "ref-count" // rootlessNetNsSilrp4netnsPidFile is the name of the rootless netns slirp4netns pid file rootlessNetNsSilrp4netnsPidFile = "rootless-netns-slirp4netns.pid" // persistentCNIDir is the directory where the CNI files are stored persistentCNIDir = "/var/lib/cni" tmpfs = "tmpfs" none = "none" resolvConfName = "resolv.conf" ) type Netns struct { // dir used for the rootless netns dir string // backend used for the network setup/teardown backend NetworkBackend // config contains containers.conf options. config *config.Config } type rootlessNetnsError struct { msg string err error } func (e *rootlessNetnsError) Error() string { msg := e.msg + ": " return fmt.Sprintf("rootless netns: %s%v", msg, e.err) } func (e *rootlessNetnsError) Unwrap() error { return e.err } // wrapError wraps the error with extra context // It will always include "rootless netns:" so the msg should not mention it again, // msg can be empty to just include the rootless netns part. // err must be non nil. func wrapError(msg string, err error) *rootlessNetnsError { return &rootlessNetnsError{ msg: msg, err: err, } } func New(dir string, backend NetworkBackend, conf *config.Config) (*Netns, error) { netnsDir := filepath.Join(dir, rootlessNetnsDir) if err := os.MkdirAll(netnsDir, 0o700); err != nil { return nil, wrapError("", err) } conf, err := config.Default() if err != nil { return nil, err } return &Netns{ dir: netnsDir, backend: backend, config: conf, }, nil } // getPath is a small wrapper around filepath.Join() to have a bit less code func (n *Netns) getPath(path string) string { return filepath.Join(n.dir, path) } func (n *Netns) getOrCreateNetns() (ns.NetNS, error) { nsPath := n.getPath(rootlessNetnsDir) nsRef, err := ns.GetNS(nsPath) if err == nil { // TODO check if slirp4netns is alive return nsRef, nil } logrus.Debugf("Creating rootless network namespace at %q", nsPath) netns, err := netns.NewNSAtPath(nsPath) if err != nil { return nil, err } err = n.setupSlirp4netns(nsPath) return netns, err } func (n *Netns) cleanup() error { if _, err := os.Stat(n.dir); err != nil { if errors.Is(err, fs.ErrNotExist) { // dir does not exists no need for cleanup return nil } return err } logrus.Debug("Cleaning up rootless network namespace") nsPath := n.getPath(rootlessNetnsDir) var multiErr *multierror.Error if err := netns.UnmountNS(nsPath); err != nil { multiErr = multierror.Append(multiErr, err) } if err := n.cleanupSlirp4netns(); err != nil { multiErr = multierror.Append(multiErr, wrapError("kill slirp4netns", err)) } if err := os.RemoveAll(n.dir); err != nil { multiErr = multierror.Append(multiErr, wrapError("remove rootless netns dir", err)) } return multiErr.ErrorOrNil() } func (n *Netns) setupSlirp4netns(nsPath string) error { res, err := slirp4netns.Setup(&slirp4netns.SetupOptions{ Config: n.config, ContainerID: "rootless-netns", Netns: nsPath, }) if err != nil { return wrapError("start slirp4netns", err) } // create pid file for the slirp4netns process // this is need to kill the process in the cleanup pid := strconv.Itoa(res.Pid) err = os.WriteFile(n.getPath(rootlessNetNsSilrp4netnsPidFile), []byte(pid), 0o600) if err != nil { return wrapError("write slirp4netns pid file", err) } if systemd.RunsOnSystemd() { // move to systemd scope to prevent systemd from killing it err = systemd.MoveRootlessNetnsSlirpProcessToUserSlice(res.Pid) if err != nil { // only log this, it is not fatal but can lead to issues when running podman inside systemd units logrus.Errorf("failed to move the rootless netns slirp4netns process to the systemd user.slice: %v", err) } } // build a new resolv.conf file which uses the slirp4netns dns server address resolveIP, err := slirp4netns.GetDNS(res.Subnet) if err != nil { return wrapError("determine default slirp4netns DNS address", err) } if err := resolvconf.New(&resolvconf.Params{ Path: n.getPath(resolvConfName), // fake the netns since we want to filter localhost Namespaces: []specs.LinuxNamespace{ {Type: specs.NetworkNamespace}, }, IPv6Enabled: res.IPv6, KeepHostServers: true, Nameservers: []string{resolveIP.String()}, }); err != nil { return wrapError("create resolv.conf", err) } return nil } func (n *Netns) cleanupSlirp4netns() error { pidFile := n.getPath(rootlessNetNsSilrp4netnsPidFile) b, err := os.ReadFile(pidFile) if err == nil { var i int i, err = strconv.Atoi(string(b)) if err == nil { // kill the slirp process so we do not leak it err = syscall.Kill(i, syscall.SIGTERM) } } return err } // mountAndMkdirDest convenience wrapper for mount and mkdir func mountAndMkdirDest(source string, target string, fstype string, flags uintptr) error { if err := os.MkdirAll(target, 0o700); err != nil { return wrapError("create mount point", err) } if err := unix.Mount(source, target, fstype, flags, ""); err != nil { return wrapError(fmt.Sprintf("mount %q to %q", source, target), err) } return nil } func (n *Netns) setupMounts() error { // Before we can run the given function, // we have to set up all mounts correctly. // The order of the mounts is IMPORTANT. // The idea of the extra mount ns is to make /run and /var/lib/cni writeable // for the cni plugins but not affecting the podman user namespace. // Because the plugins also need access to XDG_RUNTIME_DIR/netns some special setup is needed. // The following bind mounts are needed // 1. XDG_RUNTIME_DIR -> XDG_RUNTIME_DIR/rootless-netns/XDG_RUNTIME_DIR // 2. /run/systemd -> XDG_RUNTIME_DIR/rootless-netns/run/systemd (only if it exists) // 3. XDG_RUNTIME_DIR/rootless-netns/resolv.conf -> /etc/resolv.conf or XDG_RUNTIME_DIR/rootless-netns/run/symlink/target // 4. XDG_RUNTIME_DIR/rootless-netns/var/lib/cni -> /var/lib/cni (if /var/lib/cni does not exist, use the parent dir) // 5. XDG_RUNTIME_DIR/rootless-netns/run -> /run // Create a new mount namespace, // this must happen inside the netns thread. err := unix.Unshare(unix.CLONE_NEWNS) if err != nil { return wrapError("create new mount namespace", err) } xdgRuntimeDir, err := homedir.GetRuntimeDir() if err != nil { return fmt.Errorf("could not get runtime directory: %w", err) } newXDGRuntimeDir := n.getPath(xdgRuntimeDir) // 1. Mount the netns into the new run to keep them accessible. // Otherwise cni setup will fail because it cannot access the netns files. err = mountAndMkdirDest(xdgRuntimeDir, newXDGRuntimeDir, none, unix.MS_BIND|unix.MS_SHARED|unix.MS_REC) if err != nil { return err } // 2. Also keep /run/systemd if it exists. // Many files are symlinked into this dir, for example /dev/log. runSystemd := "/run/systemd" _, err = os.Stat(runSystemd) if err == nil { newRunSystemd := n.getPath(runSystemd) err = mountAndMkdirDest(runSystemd, newRunSystemd, none, unix.MS_BIND|unix.MS_REC) if err != nil { return err } } // 3. On some distros /etc/resolv.conf is symlinked to somewhere under /run. // Because the kernel will follow the symlink before mounting, it is not // possible to mount a file at /etc/resolv.conf. We have to ensure that // the link target will be available in the mount ns. // see: https://github.com/containers/podman/issues/10855 resolvePath := resolvconf.DefaultResolvConf linkCount := 0 for i := 1; i < len(resolvePath); i++ { // Do not use filepath.EvalSymlinks, we only want the first symlink under /run. // If /etc/resolv.conf has more than one symlink under /run, e.g. // -> /run/systemd/resolve/stub-resolv.conf -> /run/systemd/resolve/resolv.conf // we would put the netns resolv.conf file to the last path. However this will // break dns because the second link does not exist in the mount ns. // see https://github.com/containers/podman/issues/11222 // // We also need to resolve all path components not just the last file. // see https://github.com/containers/podman/issues/12461 if resolvePath[i] != '/' { // if we are at the last char we need to inc i by one because there is no final slash if i == len(resolvePath)-1 { i++ } else { // not the end of path, keep going continue } } path := resolvePath[:i] fi, err := os.Lstat(path) if err != nil { return fmt.Errorf("failed to stat resolv.conf path: %w", err) } // no link, just continue if fi.Mode()&os.ModeSymlink == 0 { continue } link, err := os.Readlink(path) if err != nil { return fmt.Errorf("failed to read resolv.conf symlink: %w", err) } linkCount++ if filepath.IsAbs(link) { // link is as an absolute path resolvePath = filepath.Join(link, resolvePath[i:]) } else { // link is as a relative, join it with the previous path base := filepath.Dir(path) resolvePath = filepath.Join(base, link, resolvePath[i:]) } // set i back to zero since we now have a new base path i = 0 // we have to stop at the first path under /run because we will have an empty /run and will create the path anyway // if we would continue we would need to recreate all links under /run if strings.HasPrefix(resolvePath, "/run/") { break } // make sure wo do not loop forever if linkCount == 255 { return errors.New("too many symlinks while resolving /etc/resolv.conf") } } logrus.Debugf("The path of /etc/resolv.conf in the mount ns is %q", resolvePath) // When /etc/resolv.conf on the host is a symlink to /run/systemd/resolve/stub-resolv.conf, // we have to mount an empty filesystem on /run/systemd/resolve in the child namespace, // so as to isolate the directory from the host mount namespace. // // Otherwise our bind-mount for /run/systemd/resolve/stub-resolv.conf is unmounted // when systemd-resolved unlinks and recreates /run/systemd/resolve/stub-resolv.conf on the host. // see: https://github.com/containers/podman/issues/10929 if strings.HasPrefix(resolvePath, "/run/systemd/resolve/") { rsr := n.getPath("/run/systemd/resolve") err = mountAndMkdirDest("", rsr, tmpfs, unix.MS_NOEXEC|unix.MS_NOSUID|unix.MS_NODEV) if err != nil { return err } } if strings.HasPrefix(resolvePath, "/run/") { resolvePath = n.getPath(resolvePath) err = os.MkdirAll(filepath.Dir(resolvePath), 0o700) if err != nil { return wrapError("create resolv.conf directory", err) } // we want to bind mount on this file so we have to create the file first _, err = os.OpenFile(resolvePath, os.O_CREATE|os.O_RDONLY, 0o600) if err != nil { return wrapError("create resolv.conf file: %w", err) } } // mount resolv.conf to make use of the host dns err = unix.Mount(n.getPath(resolvConfName), resolvePath, none, unix.MS_BIND, "") if err != nil { return wrapError(fmt.Sprintf("mount resolv.conf to %q", resolvePath), err) } // 4. CNI plugins need access to /var/lib/cni if n.backend == CNI { if err := n.mountCNIVarDir(); err != nil { return err } } // 5. Mount the new prepared run dir to /run, it has to be recursive to keep the other bind mounts. runDir := n.getPath("run") // relabel the new run directory to the iptables /run label // this is important, otherwise the iptables command will fail err = label.Relabel(runDir, "system_u:object_r:iptables_var_run_t:s0", false) if err != nil { if !errors.Is(err, unix.ENOTSUP) { return wrapError("relabel iptables_var_run_t", err) } logrus.Debugf("Labeling not supported on %q", runDir) } err = mountAndMkdirDest(runDir, "/run", none, unix.MS_BIND|unix.MS_REC) if err != nil { return err } return nil } func (n *Netns) mountCNIVarDir() error { varDir := "" varTarget := persistentCNIDir // we can only mount to a target dir which exists, check /var/lib/cni recursively // while we could always use /var there are cases where a user might store the cni // configs under /var/custom and this would break for { if _, err := os.Stat(varTarget); err == nil { varDir = n.getPath(varTarget) break } varTarget = filepath.Dir(varTarget) if varTarget == "/" { break } } if varDir == "" { return errors.New("failed to stat /var directory") } if err := os.MkdirAll(varDir, 0o700); err != nil { return wrapError("create var dir", err) } // make sure to mount var first err := unix.Mount(varDir, varTarget, none, unix.MS_BIND, "") if err != nil { return wrapError(fmt.Sprintf("mount %q to %q", varDir, varTarget), err) } return nil } func (n *Netns) runInner(toRun func() error) error { nsRef, err := n.getOrCreateNetns() if err != nil { return err } defer nsRef.Close() return nsRef.Do(func(_ ns.NetNS) error { if err := n.setupMounts(); err != nil { return err } return toRun() }) } func (n *Netns) Setup(nets int, toRun func() error) error { err := n.runInner(toRun) if err != nil { return err } _, err = refCount(n.dir, nets) return err } func (n *Netns) Teardown(nets int, toRun func() error) error { var multiErr *multierror.Error count, countErr := refCount(n.dir, -nets) if countErr != nil { multiErr = multierror.Append(multiErr, countErr) } err := n.runInner(toRun) if err != nil { multiErr = multierror.Append(multiErr, err) } // only cleanup if the ref count did not throw an error if count == 0 && countErr == nil { err = n.cleanup() if err != nil { multiErr = multierror.Append(multiErr, wrapError("cleanup", err)) } } return multiErr.ErrorOrNil() } // Run any long running function in the userns. // We need to ensure that during setup/cleanup we are locked to avoid races. // However because the given function could be running a long time we must // unlock in between, i.e. this is used by podman unshare --rootless-nets // and we do not want to keep it locked for the lifetime of the given command. func (n *Netns) Run(lock *lockfile.LockFile, toRun func() error) error { lock.Lock() defer lock.Unlock() _, err := refCount(n.dir, 1) if err != nil { return err } inner := func() error { lock.Unlock() err = toRun() lock.Lock() return err } inErr := n.runInner(inner) // make sure to always reset the ref counter afterwards count, err := refCount(n.dir, -1) if err != nil { if inErr == nil { return err } logrus.Errorf("Failed to decrement ref count: %v", err) return inErr } if count == 0 { err = n.cleanup() if err != nil { err = wrapError("cleanup", err) if inErr == nil { return err } logrus.Errorf("Failed to cleanup rootless netns: %v", err) return inErr } } return inErr } func refCount(dir string, inc int) (int, error) { file := filepath.Join(dir, refCountFile) content, err := os.ReadFile(file) if err != nil && !errors.Is(err, fs.ErrNotExist) { return -1, wrapError("read ref counter", err) } currentCount := 0 if len(content) > 0 { currentCount, err = strconv.Atoi(string(content)) if err != nil { return -1, wrapError("parse ref counter", err) } } currentCount += inc if currentCount < 0 { logrus.Errorf("rootless netns ref counter out of sync, counter is at %d, resetting it back to 0", currentCount) currentCount = 0 } newNum := strconv.Itoa(currentCount) if err = os.WriteFile(file, []byte(newNum), 0o600); err != nil { return -1, wrapError("write ref counter", err) } return currentCount, nil }