Podman 镜像文档

1. 镜像概述和主要用途

本镜像为Nosana移植的Podman容器引擎，Podman是一款无守护进程（daemonless）的容器引擎，用于开发、管理和运行符合OCI（Open Container Initiative）标准的容器。其核心价值在于无需后台守护进程即可直接操作容器运行时，简化部署流程并提升系统安全性。本移植版特别集成了自定义仓库配置，优化镜像拉取体验，适用于需要高效容器管理的场景。

2. 核心功能和特性

无守护进程架构：无需运行后台守护进程，通过命令行工具直接与容器运行时交互，减少系统资源占用并降低***面。
预设镜像仓库：内置registries.conf配置文件，定义默认镜像搜索仓库（如docker.io、mirror.gcr.io等），无需在命令中显式指定仓库URL。
OCI标准兼容：完全支持OCI容器规范，可运行所有符合OCI标准的容器镜像。
简化镜像拉取：自动按预设仓库顺序搜索镜像，提升镜像获取效率。

3. 使用场景和适用范围

Nosana生态协同：作为nosana-node软件的配套容器引擎，支持Nosana节点的容器化运行。
轻量级容器管理：适用于边缘计算、嵌入式设备等资源受限环境，或对后台进程数量敏感的场景。
开发与CI/CD流程：用于本地开发、测试及CI/CD流水线中的容器创建、运行和管理任务。

4. 详细使用方法和配置说明

4.1 基本运行命令（`docker run`）

4.1.1 验证镜像版本

bash
docker run -it --rm --privileged nosana/podman:latest podman --version

说明：--privileged选项用于授予容器访问主机容器运行时资源的权限；--rm表示容器退出后自动删除。

4.1.2 运行OCI容器（利用默认仓库）

无需指定仓库URL，直接拉取并运行镜像：

bash
docker run -it --rm --privileged nosana/podman:latest podman run nginx:alpine

原理：Podman会按registries.conf预设的仓库顺序（docker.io→mirror.gcr.io→quay.io）自动搜索并拉取nginx:alpine镜像。

4.2 Docker Compose配置示例

创建docker-compose.yml文件，定义持久化存储和自定义配置：

yaml
version: '3'
services:
  podman:
    image: nosana/podman:latest
    privileged: true
    volumes:
      - ./podman-data:/var/lib/containers  # 持久化容器数据（镜像、容器状态等）
      - ./custom-registries.conf:/etc/containers/registries.conf  # 挂载自定义仓库配置（可选）
    command: podman run -d nginx:alpine  # 启动后后台运行nginx容器

启动服务：

bash
docker-compose up -d

4.3 配置文件说明（`registries.conf`）

4.3.1 默认配置

镜像内置的/etc/containers/registries.conf内容如下：

ini
[registries.search]
registries = ['docker.io', 'mirror.gcr.io', 'quay.io']

[registries.search]：定义镜像搜索策略的配置段。
registries：仓库URL列表，Podman拉取镜像时会按列表顺序依次搜索，直至找到目标镜像。

4.3.2 自定义仓库配置

如需修改默认仓库（如添加私有仓库），可通过挂载自定义registries.conf实现：

创建自定义配置文件（如custom-registries.conf）：

ini
[registries.search]
registries = ['docker.io', 'my-private-registry.com', 'quay.io']  # 添加私有仓库

运行时挂载该文件：

bash
docker run -it --rm --privileged -v $(pwd)/custom-registries.conf:/etc/containers/registries.conf nosana/podman:latest

5. 配置参数说明

配置项	作用范围	说明	默认值
`[registries.search]`	镜像搜索策略	定义镜像搜索仓库的配置段	-
`registries`	`[registries.search]`子项	镜像仓库URL列表，按顺序优先级搜索	`['docker.io', 'mirror.gcr.io', 'quay.io']`

6. 注意事项

权限控制：生产环境中应谨慎使用--privileged，可通过--cap-add精细授予必要权限（如--cap-add=SYS_ADMIN）。
数据持久化：通过挂载/var/lib/containers目录持久化镜像和容器数据，避免容器重启后数据丢失。
仓库优先级：registries列表中靠前的仓库优先被搜索，建议将常用仓库放在前面以提升效率。

nosana/llm_benchmark-lmdeploy