AlmaLinux 9：Quadlet 文件写法与调试

验证范围

在 AlmaLinux 9.8 特权容器（宿主内核 5.14.0-687.54.1.el9_8，podman 5.8.2）中实际执行：写 .container 文件、/usr/libexec/podman/quadlet -dryrun -v。日志：plans/content-expansion/evidence/logs/alma-quadlet-services.log。

容器无 systemd，服务启动与开机自启未验证；本页聚焦「文件怎么写、生成结果对不对」。

文件放哪

运行方式	目录
root	`/etc/containers/systemd/`
rootless	`~/.config/containers/systemd/`

文件名决定 unit 名：web.container → web.service。放错目录不会报错，但 unit 根本不存在——这是最常见的「写了没生效」。

一个完整的 .container

[Unit]
Description=web
After=network-online.target

[Container]
Image=docker.io/library/nginx:alpine
ContainerName=web
PublishPort=8080:80
Volume=webdata:/usr/share/nginx/html:Z
Environment=NGINX_ENTRYPOINT_QUIET_LOGS=1

[Service]
Restart=always

[Install]
WantedBy=multi-user.target

四段各管一件事：[Unit] 依赖与描述、[Container] 容器参数、[Service] 重启策略、[Install] 开机自启。

用 dryrun 验证翻译

sudo /usr/libexec/podman/quadlet -dryrun -v

[Unit]
Wants=network-online.target
After=network-online.target
Description=web
SourcePath=/etc/containers/systemd/web.container

[Service]
Restart=always
ExecStop=/usr/bin/podman rm -v -f -i web
Type=notify
ExecStart=/usr/bin/podman run --name web --replace --rm --cgroups=split \
  --sdnotify=conmon -d -v webdata:/usr/share/nginx/html:Z \
  --publish 8080:80 --env NGINX_ENTRYPOINT_QUIET_LOGS=1 \
  docker.io/library/nginx:alpine

看三处就能确认配置对不对：ExecStart 里的 --publish、-v、--env，以及 After=network-online.target 是否保留。

改动如何生效

sudo systemctl daemon-reload
sudo systemctl restart web.service
systemctl status web.service --no-pager

daemon-reload 触发 Quadlet 重新生成 unit；不 reload 只 restart，用的还是旧 unit。

常见坑

缺 [Install]：systemctl enable 报找不到 unit；
依赖没写：容器启动比网络快，监听端口时对端还没就绪；
rootless 目录写错：放 /etc 对普通用户不生效。

练习：写文件、看生成、改参数再验证

sudo mkdir -p /etc/containers/systemd
sudo tee /etc/containers/systemd/lab.container >/dev/null <<'EOF'
[Unit]
Description=lab
[Container]
Image=docker.io/library/nginx:alpine
PublishPort=8082:80
[Install]
WantedBy=multi-user.target
EOF
sudo /usr/libexec/podman/quadlet -dryrun -v | grep -E "ExecStart|PublishPort"