Debian 13 教程 / 使用rootless Podman验证容器、用户映射与持久卷

在 Debian 13 中,您可以以普通用户身份运行 Podman 并创建 rootless(无根)容器。为了在替换后仍保留必要的文件,您需要将容器的临时可写层与单独的卷分离,并使用相同的用户和相同的卷重新运行它。本教程通过摘要锁定官方 httpd 镜像,并在回环端口上验证响应和数据保留。

分离镜像、容器和命名卷

镜像是一个分发单元,包含程序和执行所需的文件,而容器是由镜像创建的运行实例。写入容器可写层的文件(不包括单独挂载的存储)在容器被删除时会丢失。命名卷是使用独立名称管理的存储空间,使容器与保存数据的生命周期彼此独立。

Rootless 意味着以主机的普通用户权限运行。容器内的用户标识符(UID,User ID)0 与主机上的 root 不被视为相同。无 root 容器仍然可以使用该主机用户可用的资源,并共享主机内核。其隔离性不等同于单独的虚拟机。基本执行结构可参考 Podman 5.4.2 文档 。

目标 练习名称 更换时的处理
镜像 docker.io/library/httpd 的摘要 记录内容摘要(digest),以便使用相同镜像内容重新运行。
容器 lf-web27 停止并删除,然后创建一个新的。
命名卷 lf-web27-data 在容器更换时保留,并连接到新容器。
外部端口 127.0.0.1:8080 仅在 Debian 虚拟机内可访问,运行后请再次检查。

检查软件包和普通用户会话

需要一个具有 sudo 权限且可访问镜像注册表网络的独立 Debian 13 虚拟机。仅使用 sudo 执行安装,之后所有 podman 命令均以登录的普通用户身份运行。请勿切换到 sudo podman,因为这将访问 root 的独立镜像和容器存储,因此排查问题时也不要混用这两个存储环境。

sudo apt update
sudo apt install podman uidmap passt fuse-overlayfs curl
podman --version
id
printf '%s\n' "$XDG_RUNTIME_DIR"
grep "^$(id -un):" /etc/subuid /etc/subgid
systemctl --user is-system-running
podman info --format json

在练习中,我们使用了 Podman 5.4.2,一个 UID 和组标识符(GID,Group ID) 为 1000 的普通用户,以及执行路径 /run/user/1000。/etc/subuid 和 /etc/subgid 中各包含 lfstudent:100000:65536,并且用户管理器正在运行。这个范围在映射额外的容器用户 ID 时使用。不要从其他账户复制范围来分配重复项。

podman info 显示 host.security.rootless 为 true,cgroupVersion 为 v2,cgroupManager 为 systemd,并且存储在用户主目录下使用 overlay。如果存在环境变量或用户管理器连接错误,请从普通用户的真实 SSH 或控制台登录会话中再次检查。不要用任何路径伪造 XDG_RUNTIME_DIR,也不要混合使用 sudo 环境来让其看起来正常。

如果任何实验室名称或端口 8080 已被使用,计划更改实验名称和端口而不删除现有资源。为该实验使用一个专用的 Bash 会话。准备模块启用错误停止;如果意外故障结束 shell,请在新的普通用户会话中检查剩余资源,然后再继续。

set -euo pipefail
if podman container exists lf-web27; then
    echo "A container with this name already exists." >&2
    exit 1
fi
if podman volume exists lf-web27-data; then
    echo "A volume with this name already exists." >&2
    exit 1
fi
if test -e "$HOME/lf-course27-image.txt"; then
    echo "The image record file already exists." >&2
    exit 1
fi
ss -ltn

选择官方镜像并记录其摘要

不要使用简短的 httpd 名称,而应使用包含注册表和命名空间的地址。httpd Docker 官方镜像指南 用于检查和选择标签、Dockerfile 和网站根路径。这是 Apache HTTP 服务器的官方 Docker 镜像,并在容器内运行的程序不同于主机上的 Nginx。

podman pull docker.io/library/httpd:2.4.71-trixie
image=$(podman image inspect docker.io/library/httpd:2.4.71-trixie --format '{{index .RepoDigests 0}}')
case "$image" in
    docker.io/library/httpd@sha256:*) ;;
    *) echo "Unexpected image reference." >&2; exit 1 ;;
esac
printf '%s\n' "$image" | tee "$HOME/lf-course27-image.txt"
podman image inspect "$image" --format '{{.Architecture}} {{.Os}} {{.Id}}'

验证过程中记录的参考如下。在实际执行中,使用上述检查中获得的值,如果标签发生变化,可能会出现新的摘要。架构为 amd64,操作系统为 linux。

docker.io/library/httpd@sha256:32e9403360ab2f1047523e72f256527fb9aee68b342abf6ad03f0d629157f3d9

标签可以移动到其他镜像,但摘要用于识别内容。记录摘要并不会自动确定谁创建了镜像或响应漏洞。固定镜像不会自动更新到最新的安全补丁,因此审查、测试和替换新版本的时间表需单独管理。如果拉取失败,需要区分注册表身份验证、请求限制、DNS、TLS 和网络错误,不要用相同名称随意运行镜像。

填充专用卷并发布回环端口

首先,创建一个命名卷,然后使用一次性容器记录 index.html。准备容器不需要网络,因此它以 none 运行,并在退出后使用 --rm 删除。卷本身会保留。这个卷用于新的练习目的,因此不会覆盖现有服务的 Web 根目录。

podman volume create lf-web27-data
podman run --rm --network none -v lf-web27-data:/data --entrypoint /bin/sh "$image" -c 'printf "LF PODMAN 27\n" > /data/index.html'
podman run -d --name lf-web27 -p 127.0.0.1:8080:80 -v lf-web27-data:/usr/local/apache2/htdocs:ro "$image"
podman ps
podman port lf-web27
curl --noproxy '*' -fsS http://127.0.0.1:8080/

-p 左侧是主机地址和端口,右侧的 80 是容器内部的端口。指定 127.0.0.1 使其仅在虚拟机内部可访问。-v 末尾的 :ro 将卷以只读方式挂载到此 Web 服务器。这不是一个全局设置,不会阻止其他容器或主机进程写入该卷,因此这一阶段与准备容器写入该卷的阶段有所区分。

实际的端口输出是 80/tcp → 127.0.0.1:8080,响应是 LF PODMAN 27。如果是在启动后立即操作,请稍等再请求一次。如果持续失败,请通过 podman logs lf-web27 和 podman inspect lf-web27 检查端口冲突。容器正在运行并不意味着 HTTP 服务已经成功。

更换容器并验证数据持久性

以下步骤涉及存储卷文件的哈希值并在容器的 /tmp 中创建一个比较文件。Inspect 用于读取卷路径,但不会直接修改 Podman 存储中的其他目录。在停止并删除容器后,验证卷中的文件是否保持不变。

point=$(podman volume inspect lf-web27-data --format '{{.Mountpoint}}')
hash_before=$(sha256sum "$point/index.html")
podman exec lf-web27 sh -c 'printf "ephemeral\n" > /tmp/lf-web27-marker'
podman stop lf-web27
podman rm lf-web27
test -f "$point/index.html"
test "$hash_before" = "$(sha256sum "$point/index.html")"
podman run -d --name lf-web27 -p 127.0.0.1:8080:80 -v lf-web27-data:/usr/local/apache2/htdocs:ro "$image"
curl --noproxy '*' -fsS http://127.0.0.1:8080/
podman exec lf-web27 test ! -e /tmp/lf-web27-marker

在验证中,新容器的 HTTP 响应相同,并且 index.html 的哈希值也相同。另一方面,之前容器中的 /tmp 文件在新容器中不存在。最后一次测试如果成功不会打印任何内容,并返回退出码 0。根据这些结果,您可以区分卷和容器可写层的生命周期差异。

如果新容器启动缓慢且 curl 失败,请检查实际状态和日志并重试请求。在会在错误时停止的 shell 中,不要假设随后已经进行了清理;请使用 podman ps -a 和 podman volume ls 检查剩余资源。保留卷不同于备份。丢失用户主目录或主机磁盘也可能导致丢失相同的本地卷。

检查运行中容器的实际 AppArmor 状态

即使主机上启用了 AppArmor,也不应假设所有无根容器都受强制配置文件的限制。在替换的容器现在正在运行时,使用以下命令比较检查信息与实际进程状态。

podman info --format json
podman inspect lf-web27 --format '{{.AppArmorProfile}}'
podman exec lf-web27 cat /proc/self/attr/current

在本教程中,我们在第一个容器运行时进行了检查。主机的 AppArmor 模块为 Y,但无根信息的 apparmorEnabled 为 false,容器的 AppArmorProfile 为空,进程输出为 crun (unconfined)。不要将这些结果解读为强制模式的 AppArmor 配置文件已应用到该容器。我们没有禁用 AppArmor 或 seccomp,也没有添加 --privileged 来避免错误。

比较主机和容器的 UID 映射

检查无根容器的数字 ID 映射,而不是用户名。在本练习的默认命名空间中,容器 UID 0 对应主机 1000,而 UID 1 到 65536 对应主机从 100000 开始。组的结构相同。使用不同账户或 --userns 选项时可能会有所不同。

podman unshare cat /proc/self/uid_map /proc/self/gid_map
stat -c '%u:%g' "$point/index.html"
podman unshare stat -c '%u:%g' "$point/index.html"

index.html 在主机上显示为 1000:1000,而在 podman unshare 内显示为 0:0。Unshare 是一个用于从 Podman 用户命名空间中不同 ID 的角度查看同一文件的工具,它并不是一个使您对整个主机拥有 root 权限的命令。podman unshare 手册 描述了这个命名空间的作用范围。

为了进行额外比较,在停止服务器后,在相同的练习卷中创建一个文件,并将其设置为容器 UID/GID 33。这个数字是用于观察映射的,并不意味着所有镜像都使用相同的服务账户。

podman stop lf-web27
podman rm lf-web27
podman run --rm --network none -v lf-web27-data:/data --entrypoint /bin/sh "$image" -c 'printf "mapped\n" > /data/mapped.txt; chown 33:33 /data/mapped.txt'
stat -c '%u:%g' "$point/mapped.txt"
podman unshare stat -c '%u:%g' "$point/mapped.txt"

实际结果是主机 100032:100032,命名空间 33:33。这与在主机上将文件所有者更改为 33 并不相同。为了解决权限问题,我们不会对整个用户主目录应用 chown。:U 选项可以在主机端递归更改所有权,而 :z 和 :Z 与 SELinux 标签有关,因此它不会被作为 AppArmor 问题的一般解决方案附加使用。卷选项的确切效果可以在 Podman 运行的卷和安全选项 中检查。

只删除实验室卷并保留镜像记录

如果完整执行了上面的映射比较,lf-web27 已经停止并删除。在删除其卷之前,请在 podman ps -a 中确认这一点。如果您跳过了该比较且实验室容器仍然存在,请使用 podman stop lf-web27 停止它,并使用 podman rm lf-web27 删除它。不要强制删除正在使用的卷。

在本练习中删除剩余的专用卷也会删除其中的数据。首先,确定是否有需要保留的文件,然后仅删除特定名称。已命名卷的创建和管理范围可以在 Podman volume create 文档 中检查。

podman ps -a
podman volume inspect lf-web27-data
podman volume rm lf-web27-data
podman volume ls
ss -ltn

在实际清理中,仅删除了 lf-web27 容器和 lf-web27-data 卷。接收到的镜像和 lf-course27-image.txt 的摘要记录被保留,而 prune(批量删除其他镜像和卷)未被使用。通过分别决定是否保留持久数据和镜像重现信息,可以避免将练习清理与操作数据删除混淆。