无root模式下Podman+Docker Compose配合systemd启动端口占用故障

1. 定位端口占用根源 #

开机失败后立即执行以下命令，确认哪个进程抢占了8080端口：

ss -tulpn | grep :8080

• 如果是Podman残留进程：说明systemd单元的启动时机或清理逻辑有问题
• 如果是其他系统服务：要么修改该服务的监听端口，要么调整Compose配置里的端口映射

2. 修正systemd单元的依赖与启动顺序 #

编辑你的用户级systemd单元文件（通常路径为~/.config/systemd/user/docker-compose.service），确保服务在Podman完全就绪后启动：

[Unit]
Description=Docker Compose Podman Service
Requires=podman.socket
After=podman.socket network.target podman.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/path/to/your/compose/project
ExecStart=/usr/bin/docker-compose up -d
ExecStop=/usr/bin/docker-compose down
ExecReload=/usr/bin/docker-compose up -d --force-recreate

[Install]
WantedBy=default.target

修改后执行以下命令生效：

systemctl --user daemon-reload
systemctl --user enable docker-compose.service

3. 修复重启后服务显示运行中但无端口监听的问题 #

这是因为Type=oneshot配合RemainAfterExit=yes时，systemd仅判断启动命令执行成功，不校验容器实际运行状态，可通过两种方式解决：

方案A：改用Type=notify（需docker-compose支持） #

修改单元文件的[Service]段：

[Service]
Type=notify
WorkingDirectory=/path/to/your/compose/project
ExecStart=/usr/bin/docker-compose up
ExecStop=/usr/bin/docker-compose down
ExecReload=/usr/bin/docker-compose up -d --force-recreate
NotifyAccess=all

方案B：用启动脚本确保容器就绪 #

在Compose项目目录创建compose-start.sh脚本：

#!/bin/bash
cd /path/to/your/compose/project
# 清理残留容器与进程
docker-compose down --remove-orphans
# 启动容器
docker-compose up -d
# 重试检查端口监听，最多3次
for i in {1..3}; do
  if ss -tulpn | grep :8080; then
    exit 0
  fi
  sleep 5
done
# 仍未监听则强制重启容器
docker-compose restart
exit 0

给脚本添加执行权限：

chmod +x compose-start.sh

然后修改单元文件的ExecStart：

ExecStart=/path/to/your/compose/project/compose-start.sh

4. 验证rootless Podman网络配置 #

确保无root模式下Podman网络正常：

• 检查默认网络存在：podman network ls
• 确认~/.config/containers/containers.conf中network_backend配置为slirp4netns（Ubuntu 22.04默认值）

5. 测试开机自启 #

重启系统后执行以下命令验证：

# 查看服务状态
systemctl --user status docker-compose.service
# 检查端口监听
ss -tulpn | grep :8080
# 查看容器运行状态
docker-compose ps

内容的提问来源于stack exchange，提问作者haxney