Podman
本目录分为 Podman 基础、Podman build 和 Podman Compose。
基本使用：启动第一个容器
Linux 安装完成后，可直接以普通用户运行 rootless 容器：
podman run --rm docker.io/library/hello-world
podman run -d --name wiki-demo -p 127.0.0.1:8080:80 docker.io/library/nginx:alpine
podman ps
podman logs --tail 50 wiki-demo
curl -I http://127.0.0.1:8080
podman stop wiki-demo
podman rm wiki-demo
使用完整镜像名可避免短名解析提示。普通用户与 root 用户管理的容器和存储相互独立，排查时不要混用 sudo podman 和 podman。
Windows 与 macOS
按 官方安装说明安装 Podman 或 Podman Desktop 后，需要 Linux 虚拟机运行 Linux 容器：
podman machine init
podman machine start
podman info
已有 machine 时不必重复 init。完成启动后可执行上面的容器示例，使用 podman machine stop 停止虚拟机。
介绍
Podman 是 Red Hat 主导的开源容器引擎，可作为 Docker 的无守护进程替代品，命令基本兼容。核心特点：
- 无守护进程（daemonless）、默认 rootless
- 原生支持 pod，贴近 Kubernetes
- 支持 systemd / Quadlet 集成
与 Docker 的区别
| 维度 | Docker | Podman |
|---|---|---|
| 架构 | 客户端-守护进程（dockerd） | 无守护进程，fork/exec |
| 运行权限 | 默认 root（或加入 docker 组） | 默认 rootless |
| 编排模型 | Docker Swarm / compose | pod + Kubernetes 亲和 |
| systemd 集成 | 需额外配置 | 原生生成 unit / Quadlet |
| CLI 兼容 | 事实标准 | 兼容 Docker CLI / compose |
安装
sudo dnf -y install podman
sudo apt-get update
sudo apt-get -y install podman
安装后验证：
podman --version
podman info
常用命令
Podman 与 Docker 命令高度一致，可直接对照：
| 操作 | Docker | Podman |
|---|---|---|
| 拉取镜像 | docker pull | podman pull |
| 运行容器 | docker run | podman run |
| 列出容器 | docker ps | podman ps |
| 列出镜像 | docker images | podman images |
| 查看日志 | docker logs | podman logs |
| 进入容器 | docker exec | podman exec |
| 停止 / 启动 | docker stop/start | podman stop/start |
| 删除容器 | docker rm | podman rm |
| 删除镜像 | docker rmi | podman rmi |
| 查看详情 | docker inspect | podman inspect |
| 构建镜像 | docker build | podman build |
| 网络 / 存储卷 | docker network/volume | podman network/volume |
Fedora / RHEL 也可安装 podman-docker，它提供 /usr/bin/docker 的兼容 shim：
sudo dnf -y install podman-docker
pod（Pod 概念）
Pod 是 Podman 相比 Docker 的差异化能力，可将多个容器放进同一个 pod，共享网络命名空间与端口：
# 创建 pod 并暴露端口
podman pod create --name mypod -p 8080:80
# 将容器加入 pod
podman run --pod mypod nginx
# 查看 / 管理 pod
podman pod ps
podman pod stop mypod
podman pod rm mypod
镜像仓库配置 registries.conf
正确文件名是 registries.conf，不是 register.conf。系统配置位于 /etc/containers/registries.conf；当前用户若有 ~/.config/containers/registries.conf，它会取代系统主配置，而非与其自动合并。Windows / macOS 的容器在 Podman machine 虚拟机内运行，需先用 podman machine ssh 进入虚拟机再编辑对应文件。
示例使用占位镜像仓库，只有镜像服务确实提供 Docker Hub 的同路径镜像时才能替换成真实地址：
unqualified-search-registries = ["docker.io"]
[[registry]]
prefix = "docker.io"
location = "docker.io"
[[registry.mirror]]
location = "mirror.example.com"
unqualified-search-registries 只影响 podman pull nginx 之类的短名解析；使用 docker.io/library/nginx:alpine 可消除来源歧义。拉取 docker.io 镜像时，[[registry.mirror]] 按顺序尝试，随后才回退到原仓库；它不改变推送目标，也不保证第三方镜像服务可用或与原站 tag 内容一致。修改后执行 podman --log-level=debug pull docker.io/library/nginx:alpine，核对实际访问的仓库；生产环境优先固定 digest。
代理
临时变量
HTTP_PROXY=http://127.0.0.1:8888 HTTPS_PROXY=http://127.0.0.1:8888 NO_PROXY=127.0.0.1,192.168.0.0/16 podman pull docker.io/nginx
环境变量配置
# ssh 转发, 配合 vps 上 tinyproxy
# ssh -N -L 127.0.0.1:8888:127.0.0.1:8888 user@domain
export http_proxy="http://127.0.0.1:8888"
export https_proxy="http://127.0.0.1:8888"
export HTTP_PROXY="http://127.0.0.1:8888"
export HTTPS_PROXY="http://127.0.0.1:8888"
测试代理链路
curl -x http://127.0.0.1:8888 https://ifconfig.me
rootless 与端口
rootless 模式下，非 root 用户默认无法绑定 1024 以下的特权端口（如 80 / 443），会遇到：
Error: rootlessport cannot expose privileged port 80, you can add 'net.ipv4.ip_unprivileged_port_start=80' to /etc/sysctl.conf ...
解决方式二选一：
# 方式一：放开非 root 绑定低端口（家庭服务器可直接用）
echo 'net.ipv4.ip_unprivileged_port_start=80' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
# 方式二：改用 1024 以上的端口，再通过 caddy / nginx 反向代理
参考资料
官方资源
相关文章
其他参考链接
-
原笔记镜像候选 docker.1ms.run #todo
-
Podman 官网 #todo
-
Podman 官方文档 #todo
-
Podman 安装指南 #todo
-
podman-run 手册页 #todo
-
原笔记链接 #todo
-
原笔记链接 #todo
-
podman compose 手册 #todo