stuckj/znapzend-proxmox

znapzend-docker-proxmox

镜像概述和主要用途

本镜像基于Proxmox VE构建，用于运行znapzend（一款ZFS快照管理工具）。其核心目的是确保容器内使用的ZFS工具版本与Proxmox主机系统中安装的ZFS模块版本完全匹配，避免因版本不兼容导致的快照管理问题。

核心功能和特性

• 版本匹配：基于Proxmox VE构建，确保容器内ZFS工具版本与Proxmox主机ZFS模块版本一致
• 多版本支持：提供多个镜像版本，对应不同Proxmox VE版本和ZFS工具版本，可根据主机环境选择
• 灵活配置：支持自定义命令参数，满足个性化快照管理需求
• 日志集成：可通过指定--logto=/dev/stdout将日志输出到Docker日志系统

使用场景和适用范围

适用于在Proxmox VE环境中需要通过容器化方式运行znapzend的场景，特别适合需要确保ZFS工具版本与主机系统严格匹配的用户。当Proxmox主机更新ZFS内核模块或工具时，应同步更新本镜像版本以保持兼容性。

使用方法和配置说明

前提条件

• Proxmox VE主机环境
• Docker或Docker Compose已安装
• 主机需启用ZFS并确保/dev/zfs设备存在

Docker Compose配置示例

yaml
version: '3'

services:
  znapzend:
    image: docker.xuanyuan.run/stuckj/znapzend-proxmox:pve-8.x-zfs-latest  # 根据Proxmox版本选择合适的镜像标签
    privileged: true  # 需特权模式以访问ZFS设备
    devices:
      - /dev/zfs:/dev/zfs  # 映射ZFS设备
    restart: unless-stopped  # 确保服务持续运行
    volumes:
      - /root/.ssh:/root/.ssh  # 挂载SSH密钥（如需远程快照）
    command: [ "znapzend --logto=/dev/stdout --autoCreation" ]  # 自定义命令参数

Docker CLI运行示例

bash
docker run -it \
  --privileged \
  --device /dev/zfs:/dev/zfs \
  -v /root/.ssh:/root/.ssh \
  --restart unless-stopped \
  docker.xuanyuan.run/stuckj/znapzend-proxmox:pve-8.x-zfs-latest \
  "znapzend --logto=/dev/stdout --autoCreation"

重要配置说明

• 命令覆盖：如需自定义znapzend命令，必须将选项和命令作为单个字符串传递（因入口点为bash shell）
• 日志输出：必须包含--logto=/dev/stdout参数，才能在docker logs中查看容器日志
• 版本选择：根据Proxmox VE版本和ZFS工具版本选择合适的镜像标签，例如pve-8.x-zfs-latest对应Proxmox 8.x和最新ZFS工具

参考文档

有关znapzend的详细使用方法，请参考其官方GitHub文档：https://github.com/oetiker/znapzend