基于 Podman 的容器环境一键安装与管理脚本

支持一键安装 Podman 运行时，并开设基于本仓库编译镜像的各种 Linux 容器（提供 SSH 访问），支持 IPv6、端口映射、资源限制等。

• 使用各发行版官方软件包安装 Podman（无守护进程，daemonless 架构）
• 使用本仓库自编译的基础镜像，优先从 ghcr.io 拉取，无法获取时回退到 GitHub Releases 离线包
• 支持系统：Ubuntu 22.04、Debian 12、Alpine、AlmaLinux 9、RockyLinux 9、OpenEuler 22.03
• 支持架构：amd64、arm64

1. 以 root 用户登录目标机器。
2. 执行安装脚本：bash <(wget -qO- https://raw.githubusercontent.com/oneclickvirt/podman/main/podmaninstall.sh)。
3. 创建容器：./onepodman.sh ct1 1 512 MyPassword 25000 34975 35000 n debian 0。
4. 连接 SSH：ssh root@<服务器IP> -p 25000。
5. 查看记录：cat ctlog 或 podman ps -a。

flowchart LR
    A["podmaninstall.sh"] --> B["Install Podman + dependencies"]
    B --> C["Configure storage/network/kernel"]
    C --> D["podman-net / podman-ipv6"]
    E["create_podman.sh"] --> F["onepodman.sh"]
    F --> G["Pull ghcr.io image or load release tar"]
    G --> H["Run container"]
    H --> I["entrypoint + SSH init scripts"]
    I --> J["SSH access + ctlog record"]
    K["podmanuninstall.sh"] --> L["Clean containers/images/networks/state"]

bash <(wget -qO- https://raw.githubusercontent.com/oneclickvirt/podman/main/podmaninstall.sh)

无交互安装可使用：

export noninteractive=true
bash <(wget -qO- https://raw.githubusercontent.com/oneclickvirt/podman/main/podmaninstall.sh)

可选环境变量：

# 下载脚本
wget -q https://raw.githubusercontent.com/oneclickvirt/podman/main/scripts/onepodman.sh
chmod +x onepodman.sh

# 用法:
# ./onepodman.sh <name> <cpu> <memory_mb> <password> <sshport> <startport> <endport> [ipv6:y/n] [system] [disk_gb]
# 需要自动生成密码但仍传后续端口参数时，将 <password> 传为空字符串 ""

# 示例: 创建名为 ct1 的 Debian 容器，1核 512MB，SSH端口25000，额外端口34975-35000
./onepodman.sh ct1 1 512 MyPassword 25000 34975 35000 n debian 0

SSH 宿主机端口不能落在额外公网端口范围内，避免同一个宿主端口被重复映射。

当宿主机使用 btrfs 且 disk_gb 大于 0 时，脚本会先创建容器，再对容器 rootfs 的 btrfs qgroup 设置上限后启动容器。Podman 的 --storage-opt 是全局存储配置参数，不能作为 podman run 的容器级磁盘限制参数使用；因此本项目不会把 size=... 直接传给 podman run。

支持的 system 参数： ubuntu / debian / alpine / almalinux / rockylinux / openeuler

也支持带版本号或常见别名的写法，会自动规范化到本项目实际镜像 tag，例如： ubuntu22、ubuntu/22.04 -> ubuntu；debian12、debian/12 -> debian； alma9、almalinux/9 -> almalinux；rocky9、rockylinux/9 -> rockylinux； openeuler22.03、openeuler/22.03 -> openeuler。不存在的版本不会静默降级。

wget -q https://raw.githubusercontent.com/oneclickvirt/podman/main/scripts/create_podman.sh
chmod +x create_podman.sh
./create_podman.sh

交互式脚本，自动递增容器名（ct1, ct2, ...）、SSH 端口、公网端口，容器信息记录到 ctlog 文件。

无交互批量创建示例：

export noninteractive=true
export PODMAN_CREATE_COUNT=3
export PODMAN_MEMORY_MB=512
export PODMAN_CPU=1
export PODMAN_SYSTEM=debian
export PODMAN_IPV6=n
./create_podman.sh

批量创建时支持的环境变量：

其他环境变量：

单容器创建默认会把容器记录追加到 ctlog。批量创建会临时生成同名记录文件，追加到 ctlog 后立即删除，避免长期留下包含密码的散落文件。

Rootless 创建示例：

export PODMAN_ROOTLESS=true
./onepodman.sh ct1 1 512 "" 25000 34975 35000 n debian 0

Pod 网络示例：

export PODMAN_POD_NAME=ctpod1
./onepodman.sh ct1 1 512 "" 25000 34975 35000 n debian 0

批量创建时如果设置 PODMAN_POD_NAME 且未设置 PODMAN_POD_JOIN_EXISTING=true，脚本会按容器名自动派生 pod 名，避免多个 SSH 容器无意共享同一个网络命名空间。

podman ps -a                  # 查看所有容器
podman exec -it <name> bash   # 进入容器（bash 系统）
podman exec -it <name> sh     # 进入容器（alpine）
podman logs <name>            # 查看容器日志
podman rm -f <name>           # 删除单个容器
podman images                 # 查看所有镜像
podman rmi <image>            # 删除镜像

一键卸载 Podman 全套环境，包括所有容器、镜像、网络、辅助文件：

bash <(wget -qO- https://raw.githubusercontent.com/oneclickvirt/podman/main/podmanuninstall.sh)

脚本会在执行前要求输入 yes 确认，操作不可逆。无交互卸载可先执行 export noninteractive=true，也兼容 FORCE_UNINSTALL=true。

本仓库自编镜像通过 GitHub Actions 使用 Podman/Buildah 构建，发布到 Releases 及 ghcr.io：

同时推送至 ghcr.io，支持 multi-arch manifest：

• ghcr.io/oneclickvirt/podman:<os>-amd64
• ghcr.io/oneclickvirt/podman:<os>-arm64
• ghcr.io/oneclickvirt/podman:<os>（multi-arch manifest list）

创建容器时会优先拉取 PODMAN_GHCR_IMAGE:<os>-<arch>，拉取失败后再下载 PODMAN_RELEASE_BASE_URL/<os>/spiritlhl_<os>_<arch>.tar.gz 并加载为本地镜像。

• IPv4 网络名: podman-net，bridge: podman-br0，subnet: 172.20.0.0/16
• IPv6 双栈网络名: podman-ipv6，bridge: podman-br1，包含 172.21.0.0/16 + 公网 IPv6 /80 子网
• 与 containerd/docker 版本完全隔离，互不干扰