安装并配置 Podman

Mon, 16 Jun 2025 11:06:21 +0800

Podman 完整安装与配置指南

一、安装 Podman

各平台安装方法：

Linux 系统：

1
2
3
4
5
6
7
8


# Ubuntu/Debian
sudo apt update && sudo apt install -y podman

# RHEL/CentOS
sudo yum install -y podman

# Fedora
sudo dnf install -y podman

macOS 系统：

1
2
3
4
5
6


# 使用 Homebrew 安装
brew install podman

# 初始化虚拟机
podman machine init
podman machine start

Windows 系统：

1
2
3
4
5
6


# 使用 Winget 安装
winget install RedHat.Podman

# 初始化 WSL 环境
podman machine init
podman machine start

官方安装文档：https://podman.io/docs/installation

二、配置镜像加速

完整配置步骤：

进入 Podman 虚拟机环境：
1

podman machine ssh

编辑镜像源配置文件：

`1`	`sudo vim /etc/containers/registries.conf`

使用以下优化配置（支持多镜像源自动切换）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29


# 默认搜索源
unqualified-search-registries = ["docker.io"]

# 主仓库配置
[[registry]]
prefix = "docker.io"
location = "docker.mirrors.ustc.edu.cn" # 推荐首选源
insecure = true # 允许非 HTTPS 连接

# 镜像源列表（按顺序尝试）
[[registry.mirror]]
location = "docker.mirrors.ustc.edu.cn" # 中科大镜像源
insecure = true

[[registry.mirror]]
location = "hub-mirror.c.163.com" # 网易镜像源
insecure = true

[[registry.mirror]]
location = "mirror.baidubce.com" # 百度云镜像源
insecure = true

[[registry.mirror]]
location = "docker.nju.edu.cn" # 南京大学源
insecure = true

[[registry.mirror]]
location = "registry-1.docker.io" # Docker 官方源（备用）
insecure = false

保存配置并退出编辑器

验证配置生效：

1
2
3
4
5


# 检查配置是否加载
podman info --format '{{ .Registries }}'

# 测试镜像拉取速度
time podman pull nginx:alpine

三、高级配置选项

1. 配置存储驱动（解决磁盘空间问题）

1
2
3
4
5
6
7
8


# 编辑存储配置文件
sudo vim /etc/containers/storage.conf

# 修改以下参数
[storage]
driver = "overlay"
graphroot = "/var/lib/containers/storage"
runroot = "/run/containers/storage"

2. 设置 Rootless 模式（推荐）

1
2
3
4
5
6


# 启用用户命名空间
sudo usermod --add-subuids 100000-165535 $USER
sudo usermod --add-subgids 100000-165535 $USER

# 验证无根模式
podman run --rm hello-world

3. 配置网络（自定义网桥）

1
2
3
4
5


# 创建自定义网络
podman network create mynet --subnet 10.10.0.0/24

# 使用自定义网络运行容器
podman run -d --network mynet --name web nginx

四、常用操作示例

1. Docker 命令对比

Docker 命令	Podman 等效命令
`docker run`	`podman run`
`docker ps`	`podman ps`
`docker build`	`podman build`
`docker-compose up`	`podman-compose up`

2. 实际使用示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 运行交互式容器
podman run -it --rm alpine sh

# 构建自定义镜像
echo "FROM alpine" > Dockerfile
echo 'CMD echo "Hello Podman!"' >> Dockerfile
podman build -t hello-podman .

# 运行自定义镜像
podman run --rm hello-podman

# 查看容器资源使用
podman stats

# 生成 systemd 服务文件
podman generate systemd --name web > /etc/systemd/system/web.service

五、故障排除

常见问题解决方案：

镜像拉取失败：

1
2
3
4
5


# 检查当前使用的镜像源
podman info | grep -A 10 registries

# 临时使用特定镜像源
podman pull --registry=docker.mirrors.ustc.edu.cn/library/nginx

权限问题：

1
2
3
4
5


# 修复用户命名空间配置
podman system migrate

# 检查用户映射
grep $USER /etc/subuid

网络连接问题：

1
2
3
4
5
6
7
8


# 检查网络配置
podman network ls
podman inspect <container_id> | grep IPAddress

# 重置网络
podman machine stop
podman machine rm -f
podman machine init

存储空间不足：

1
2
3
4
5


# 清理无用资源
podman system prune -a -f

# 查看存储使用
podman system df

性能优化提示：定期更新镜像源列表，国内用户推荐使用中科大(docker.mirrors.ustc.edu.cn)或南京大学(docker.nju.edu.cn)镜像源

日志查看：

1
2
3
4
5


# 查看容器日志
podman logs <container_id>

# 查看服务日志（macOS/Windows）
podman machine logs

参考资源：Podman 官方文档

Kubernetes Kubelet 与容器运行时交互流程

Wed, 11 Jun 2025 11:28:18 +0800

kubelet cri containerd cni runc 之间的业务交互流程

1. kubelet 与底层交互的过程演变：

2. 1.1版本后的组件角色说明、以及细节抛析

组件	核心作用	子模块/依赖
Kubelet	节点代理，监听 APIServer，管理 Pod 生命周期（创建/销毁/监控）	Volume Manager、CSI 插件、Probe 机制
CRI (gRPC)	Kubernetes 与容器运行时的标准接口，解耦 Kubelet 和具体实现	containerd/CRI-O 的 CRI 插件
Containerd	容器运行时，管理容器镜像、存储和运行（默认通过 runc 实现 OCI 标准）	containerd-shim、runc、CNI
CNI 插件	配置 Pod 网络（IP 分配、网卡、路由规则）	Calico/Flannel/Weave 等具体实现
runc	底层 OCI 运行时，负责创建/启动容器进程（调用 Linux 内核的 Namespace 和 Cgroups）	libcontainer（内核交互层）

Container on DK Blog

安装并配置 Podman

Podman 完整安装与配置指南

一、安装 Podman

各平台安装方法：

二、配置镜像加速

完整配置步骤：

验证配置生效：

三、高级配置选项

1. 配置存储驱动（解决磁盘空间问题）

2. 设置 Rootless 模式（推荐）

3. 配置网络（自定义网桥）

四、常用操作示例

1. Docker 命令对比

2. 实际使用示例

五、故障排除

常见问题解决方案：

日志查看：

Kubernetes Kubelet 与容器运行时交互流程

kubelet cri containerd cni runc 之间的业务交互流程

1. kubelet 与底层交互的过程演变：

2. 1.1版本后的组件角色说明、以及细节抛析