pectojin/zfswatcher

zfswatcher 镜像文档

镜像概述

zfswatcher是一个用于监控Zettabyte文件系统(ZFS)的Docker容器。该镜像基于https://github.com/crazymanjinn/docker-zfswatcher%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%87%87%E7%94%A8https://github.com/rouben/zfswatcher%EF%BC%88%E5%9B%A0https://github.com/damicon/zfswatcher%E8%87%AA2013%E5%B9%B4%E8%B5%B7%E6%9C%AA%E6%9B%B4%E6%96%B0%EF%BC%89%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84ZFS%E7%9B%91%E6%8E%A7%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82

核心功能与特性

• 实时监控ZFS文件系统状态
• 提供Web管理界面，默认通过8990端口访问
• 支持配置持久化存储
• 包含日志记录功能
• 直接访问ZFS设备以获取准确状态信息

使用场景

适用于需要监控ZFS存储池、文件系统状态的环境，包括但不限于：

• 数据中心存储服务器
• 个人或企业级NAS系统
• 运行ZFS的Linux服务器
• 需要实时跟踪ZFS健康状态的生产环境

使用方法与配置说明

Docker Run 部署

基本运行命令：

bash
docker run -d \
  -v zfswatcher_config:/zfswatcher_config \
  -p 8990:8990 \
  --device /dev/zfs:/dev/zfs:rw \
  pectojin/zfswatcher

参数说明：

• -d: 后台运行容器
• -v zfswatcher_config:/zfswatcher_config: 挂载配置卷，持久化存储配置文件
• -p 8990:8990: 映射Web界面端口（主机端口:容器端口）
• --device /dev/zfs:/dev/zfs:rw: 授予容器对ZFS设备的读写权限，确保能获取ZFS状态

Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: '2'
services:
  zfswatcher:
    image: pectojin/zfswatcher:latest
    volumes:
      - /etc/zfswatcher:/zfswatcher_config:rw  # 主机配置目录挂载
      - /var/log/zfswatcher/zfswatcher.log:/var/log/zfswatcher/zfswatcher.log:rw  # 日志文件挂载
      - /dev/log:/dev/log:rw  # 系统日志设备挂载
    ports:
      - 8990:8990  # Web界面端口映射
    devices:
      - /dev/zfs:/dev/zfs:rw  # ZFS设备访问权限
    restart: always  # 容器退出时自动重启

启动命令：

bash
docker-compose up -d

访问与配置

容器启动后，通过http://<主机IP>:8990访问Web管理界面。配置文件位于挂载的zfswatcher_config卷中，可根据需求修改监控参数和告警设置。日志信息可通过挂载的日志文件或容器日志命令查看：

bash
docker logs <容器ID或名称>