strandaster/fritzinfluxdb

Fritz InfluxDb

镜像概述和主要用途

Fritz InfluxDb是一个用Python编写的小型守护进程，用于从Fritz Box路由器获取数据并写入InfluxDB。其功能与fritzcollectd相当，支持直接将路由器数据写入InfluxDB，便于数据监控和分析。

核心功能和特性

• 从Fritz Box路由器采集数据并直接写入InfluxDB
• 兼容Python 3.6及以上版本
• 支持作为systemd服务运行，实现开机自启动
• 提供Docker容器化部署方案
• 可与Grafana集成，构建路由器监控仪表板
• 适配QNAP Container Station，配置文件可通过GUI管理

使用场景和适用范围

适用于需要监控Fritz Box路由器性能数据（如网络流量、连接状态等）的场景，特别适合希望通过InfluxDB存储数据并结合Grafana进行可视化分析的用户。支持Ubuntu、RHEL/CentOS等Linux发行版及Docker环境部署。

详细的使用方法和配置说明

环境要求

• Python 3.6或更高版本
• InfluxDB数据库
• fritzconnection >= 1.3.3

Python 2.7支持

如需在Python 2环境运行，请使用https://github.com/yunity/fritzinfluxdb/tree/python2.7%E3%80%82

安装步骤

Ubuntu 18.04

bash
sudo apt-get install virtualenv python3-lxml
cd /opt
git clone https://github.com/yunity/fritzinfluxdb.git
cd fritzinfluxdb
virtualenv --system-site-packages -p python3 .venv
. .venv/bin/activate
pip3 install -r requirements.txt

RHEL/CentOS 7（带EPEL）

bash
yum install git python36-virtualenv python36-lxml
cd /opt
git clone https://github.com/yunity/fritzinfluxdb.git
cd fritzinfluxdb
virtualenv-3 --system-site-packages .venv
. .venv/bin/activate
pip3 install -r requirements.txt

配置与测试

修改配置文件并测试运行：

bash
./fritzinfluxdb.py

安装为systemd服务

Ubuntu

bash
cp /opt/fritzinfluxdb/fritzinfluxdb.service /etc/systemd/system

RHEL/CentOS

bash
sed -e 's/nogroup/nobody/g' /opt/fritzinfluxdb/fritzinfluxdb.service > /etc/systemd/system/fritzinfluxdb.service

启用并启动服务：

bash
systemctl daemon-reload
systemctl start fritzinfluxdb
systemctl enable fritzinfluxdb

Docker部署

构建镜像

bash
git clone <此仓库URL>
cd fritzinfluxdb
docker build -t fritzinfluxdb .

配置文件准备

从示例配置复制配置文件到config/fritzinfluxdb.ini并编辑设置。

运行容器

bash
docker run -d -v /PATH/TO/CONFIG_DIRECTORY:/app/config/ --name docker.xuanyuan.run/fritzinfluxdb fritzinfluxdb

升级说明

从版本<0.3升级时，需执行以下步骤：

• 更新虚拟环境：pip3 install -r requirements.txt
• 使用更新后的配置文件，并迁移旧配置中的凭据和地址信息

Grafana集成

使用grafana_dashboard_fritzbox.json导入仪表板。该仪表板灵感来源于：https://grafana.com/dashboards/713

!Grafana仪表板

配置更多属性

查看https://wiki.fhem.de/w/index.php?title=FRITZBOX%E8%8E%B7%E5%8F%96%E6%9B%B4%E5%A4%9A%E5%8F%AF%E6%B7%BB%E5%8A%A0%E7%9A%84%E5%B1%9E%E6%80%A7%E6%A6%82%E8%BF%B0%E3%80%82

许可证

完整许可证见LICENSE.txt。本项目采用MIT许可证。

本仓库额外变更

为适配QNAP Container Station，配置文件已移至config目录，可通过Container Station的GUI替换。Python脚本已相应调整。