Commit Graph
4 Commits
Author SHA1 Message Date
Andrew Halaney 59cc4cc49d pkg/sys: Let more environments create user namespace as the initial user
By restoring the effective capabilities of the thread after setresuid()
we can both:

    1. Use the go runtime to setup the uid_map now that we have the
       capabilities to do so in the thread again
    2. Enable this on distro's which have restrictions around
       unprivileged user namespace creation and usage (since the thread
       is now privileged)

Let's do it. See [0] for more details on this topic. Unlike
unix::Setresuid()[1], which mimics the glibc implementation and acts on all
threads in the process, unix::Cap{s,g}et() are thread local[2] only as we
want, so we can use that directly.

[0]: https://github.com/containerd/containerd/pull/12317#discussion_r2686960671
[1]: https://github.com/golang/go/blob/e2fef50def98b87107ab963f657d43d7869b8463/src/syscall/syscall_linux.go#L1217
[2]: https://github.com/golang/sys/blob/6fb913b30f367555467f08da4d60f49996c9b17a/unix/zsyscall_linux.go#L524
Signed-off-by: Andrew Halaney <ahalaney@netflix.com>
2026-01-14 09:04:32 -06:00
Andrew Halaney 42ce92b222 pkg/sys: Create user namespace as the container's initial user namespace user
Right now containerd uses os.StartProcess() to create a dummy ptraced
process via a fork/exec in a new user namespace, with the uid_map/gid_map
setup.

This doesn't work so well with user limits[0] in the kernel, at least if
you expect the container user to have separate isolation from the host's
"normal users". The kernel's ucount mechanism forms a ucount tuple of (ns, kuid_t)
for each user limit. Say containerd runs as uid 0 in the initial user namespace,
and the container runs as uid 100000 from the inital user namespace point of view.

When the container tries to do things like inotify_add_watch(), the
kernel:

    1. First verifies that the ucount(container user namespace, 100000)
       doesn't exceed its "per user per user namespace limits" and
       increments the counter there. This limit is set by
       /proc/sys/user/max_inotify_watches when in the namespace
    2. Then walks up to the ucount who created this namespace,
       ucount(initial user namespace, 0) and increments their counter as
       well ensuring they don't exceed their limit. In our example this
       is the initial user namespace, this limit is set by
       /proc/sys/fs/inotify/max_user_watches as well as
       /proc/sys/user/max_inotify_watches in that case.

This is done so a user can't escape per user limits by creating a user
namespace and running as different users in that user namespace. The
accounting always rolls back up to the user who created the user
namespace to ensure this, checking limits at each layer.

This means if you have a rogue container they can consume all of
the containerd user's inotify limits. In practice this means global root
is in danger of being denied usage of resources due to the container,
while other less important users are still well within their budget!
In the inotify case for example systemd will fail to start many new
services due to this.

Let's instead create the user namespace *as the container's initial user
namespace user*. This means that all the attribution for these user
limits rolls up to this unimportant user, preventing one container from
exhausting global root's resources, and further isolating each container
from each other (since each pod in k8s runs as its own disjoint set of
users in the initial user namespace).

This is a bit annoying to do in golang. The best option seems to be what
we have here:

    1. Lock OS thread
    2. Manually setresuid() (seteuid implementation in golang mimics
       glibc's and sets the euid for all of the threads, which causes
       issues for other threads running at the same time)
    3. Create user namespace
    4. Undo the setresuid()
    5. Update the uid_map/gid_map as root now (can't do this anymore as
       part of (3) since to update the map you must have CAP_SETUID
       which the container user will not have)

With this in place you can verify the user namespace is owned by the
proper uid via ioctl(fd, NS_GET_OWNER_UID). Some distros block
unprivleged user namespace creation, for those we'll just continue to
create it as containerd's user.

[0]: https://docs.kernel.org/admin-guide/sysctl/user.html#documentation-for-proc-sys-user
Signed-off-by: Andrew Halaney <ahalaney@netflix.com>
2026-01-14 09:04:32 -06:00
Mike Baynton 347423a114 Request 'allow' setgroups when spawning new userns
Signed-off-by: Mike Baynton <mike@mbaynton.com>
2024-10-17 15:37:36 -05:00
Wei Fu 490e45a08a pkg/sys: Add UnshareAfterEnterUserns function
It allows to disassociate parts of its execution context within a user
namespace.

Signed-off-by: Wei Fu <fuweid89@gmail.com>
2024-09-11 07:21:39 +08:00