dachack/fritzpcap

FritzPCAP-docker

镜像概述

FritzPCAP-docker是一个自托管的家庭网络流量监控解决方案，通过整合ntopng和Fritz!Box设备，实现家庭网络流量的捕获、存储与分析。该镜像基于Davide Quaranta的网络监控思路和脚本构建，提供容器化部署方式，简化家庭网络流量监控的搭建流程。

核心功能与特性

• 自托管部署：本地部署，数据隐私可控
• Fritz!Box集成：与Fritz!Box路由器无缝对接，捕获网络流量
• 流量分析：配合ntopng实现网络流量可视化分析
• 数据持久化：支持流量数据本地存储，便于历史分析
• 容器化架构：通过Docker容器化部署，简化配置与维护

使用场景与适用范围

• 家庭网络流量监控与分析
• 网络带宽使用情况追踪
• 家庭设备网络连接监控
• 网络异常流量检测

使用方法与配置说明

镜像获取

• Docker Hub：https://hub.docker.com/r/dachack/fritzpcap
• GitHub源码：https://github.com/DaCHack/fritzpcap-docker

Docker Compose部署示例

推荐使用docker-compose同时部署fritzpcap和ntopng服务：

yaml
services:
  ntopng:
    container_name: ntopng
    image: ntop/ntopng:stable
    volumes:
      - /opt/appdata/ntopng/data:/var/lib/ntopng  # ntopng数据存储
      - /opt/appdata/ntopng/pcap:/pcap            # 流量捕获文件存储
      - /opt/appdata/ntopng/ntopng.conf:/ntopng.conf:ro  # 配置文件
      - /etc/timezone:/etc/timezone:ro            # 时区配置
      - /etc/localtime:/etc/localtime:ro          # 本地时间配置
    environment:
      - TZ=Europe/Berlin  # 设置时区
    command:
      - "/ntopng.conf"    # 指定配置文件
    ports:
      - 3000              # ntopng Web界面端口
    restart: unless-stopped
    depends_on:
      - fritzpcap         # 依赖fritzpcap服务

  fritzpcap:
    build: ./fritzpcap    # 构建fritzpcap镜像（或直接使用dachack/fritzpcap）
    environment:
      - FRITZIP=http://fritz.box  # Fritz!Box地址
      - FRITZUSER={{ fritz.username }}  # Fritz!Box用户名
      - FRITZPWD={{ fritz.password }}  # Fritz!Box密码
    volumes:
      - /opt/appdata/ntopng/pcap:/pcap  # 共享流量捕获目录
    restart: unless-stopped

配置说明

fritzpcap环境变量

ntopng配置文件（/ntopng.conf）

创建/opt/appdata/ntopng/ntopng.conf文件，配置如下：

-i=/pcap/ath0        # 指定无线流量捕获文件
-i=/pcap/lan         # 指定有线流量捕获文件
--local-networks="192.168.1.0/24"  # 本地网络CIDR（根据实际网络调整）
--community          # 启用社区版功能

运行说明

1. 配置Fritz!Box登录凭据（FRITZUSER和FRITZPWD）
2. 调整本地网络CIDR（--local-networks参数）以匹配实际网络
3. 通过docker-compose up -d启动服务
4. 访问http://<主机IP>:3000打开ntopng Web界面查看流量分析结果