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环境运行，请使用python2.7分支。

安装步骤

Ubuntu 18.04

sudo apt-get install virtualenv python3-lxml
cd /opt
git clone [***]
cd fritzinfluxdb
virtualenv --system-site-packages -p python3 .venv
. .venv/bin/activate
pip3 install -r requirements.txt

RHEL/CentOS 7（带EPEL）

yum install git python36-virtualenv python36-lxml
cd /opt
git clone [***]
cd fritzinfluxdb
virtualenv-3 --system-site-packages .venv
. .venv/bin/activate
pip3 install -r requirements.txt

配置与测试

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

./fritzinfluxdb.py

安装为systemd服务

Ubuntu

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

RHEL/CentOS

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

启用并启动服务：

systemctl daemon-reload
systemctl start fritzinfluxdb
systemctl enable fritzinfluxdb

Docker部署

构建镜像

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

配置文件准备

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

运行容器

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

升级说明

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

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

Grafana集成

使用grafana_dashboard_fritzbox.json导入仪表板。该仪表板灵感来源于：[***]

!Grafana仪表板

配置更多属性

查看FHEM wiki获取更多可添加的属性概述。

许可证

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

本仓库额外变更

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