didierc/docker-darkstat

Darkstat Docker镜像

镜像概述和主要用途

Darkstat Docker镜像是一个基于最新Debian stable slim系统构建的网络流量分析工具容器化解决方案。该镜像支持amd64、armv6、armv7和arm64多种架构，集成了darkstat工具（来自git仓库master分支），可用于实时监控和分析网络流量。

核心功能和特性

• 多架构支持：兼容amd64、armv6、armv7和arm64架构，适用于不同硬件平台
• 轻量级基础：基于Debian stable slim，镜像体积小，资源占用低
• 持久化存储：通过卷挂载实现日志和数据库文件的持久化保存
• 灵活配置：支持通过环境变量自定义darkstat运行参数
• 用户权限控制：可指定运行用户的UID和GID，增强安全性
• 时间同步：支持挂载主机本地时间文件，确保日志时间准确性

使用场景和适用范围

• 家庭网络或小型企业网络流量监控
• 服务器带宽使用情况分析
• 网络异常流量检测
• 多架构设备（如树莓派、x86服务器）的统一流量监控部署

使用方法和配置说明

拉取镜像

bash
docker pull didierc/docker-darkstat

运行容器

bash
docker run -d --net="host" --name=<容器名称> \
  -v <本地数据路径>:/darkstat/config \
  -v /etc/localtime:/etc/localtime:ro \
  -e OPTIONS=<darkstat选项> \
  -e DS_UID=<用户UID> \
  -e DS_GID=<用户GID> \
  didierc/docker-darkstat

环境变量说明

• OPTIONS：darkstat运行参数，具体可参考darkstat官方文档或通过man darkstat查询
• DS_UID：运行darkstat的用户UID，默认值为1000
• DS_GID：运行darkstat的用户GID，默认值为1000

Web-UI访问

容器启动后，通过以下地址访问darkstat Web界面：

http://<主机IP>:[端口]

端口由darkstat配置参数指定，默认为667

使用示例

bash
docker run -d --net="host" --name=darkstat \
  -v /mydata/darkstat:/darkstat/config \
  -v /etc/localtime:/etc/localtime:ro \
  -e OPTIONS="-i eth0 --daylog darkstat.log --verbose --import darkstat.db --export darkstat.db" \
  didierc/docker-darkstat

此示例配置监控eth0接口，启用日志记录、详细输出及数据库导入/导出功能

数据库导出

按以下步骤手动导出darkstat数据库：

1. 获取容器内darkstat进程PID：

   bash
   docker top <容器ID>
   

2. 向进程发送SIGUSR1或SIGUSR2信号触发导出：

   bash
   kill -10 <进程PID>
   

详细说明请参考darkstat官方文档中关于数据库导出的部分

多架构镜像构建

镜像源码托管于Gitlab，使用Docker Buildx构建多架构镜像。

构建步骤

1. 创建Buildx构建器：

   bash
   docker buildx create --platform linux/amd64,linux/arm64,linux/arm/v7,linux/arm/v6 --use
   

2. 构建并推送镜像：

   bash
   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7,linux/arm/v6 --push -t didierc/docker-darkstat:latest .
   

未来改进方向

• 实现通过SIGUSR1信号自动导出数据库的入口点脚本
• 移除run.sh，使用入口点直接作为PID 1进程启动darkstat