braindoctor/netdata-minimal

netdata-minimal

默认禁用所有插件的最小化Netdata安装镜像，旨在作为运行自定义插件的微服务基础镜像，支持后端或流功能（默认禁用）。注意：此处的“最小化”指插件数量最少，而非镜像体积最小。该镜像每周构建并推送至Docker Hub。

注意：Netdata的Web UI和健康检查默认禁用。即使启用（见环境变量），也不会显示任何图表，仅能看到页脚和菜单，除非显式激活插件。

快速开始

1. 在Dockerfile中声明FROM braindoctor/netdata-minimal
2. 覆盖配置（见下文）
3. 启用Web服务用于调试

包含内容

• Alpine edge系统
• 完整Netdata安装（最新Git克隆编译），但默认通过/etc/netdata/netdata.conf配置禁用所有插件
• Python及相关包：py-mysqldb、py-psycopg2、netcat-openbsd
• Nodejs（不含npm）
• Crudini（简易ini编辑工具）
• jq（简易json编辑工具）
• merge-yaml-cli（简易yaml编辑工具）
• bash（仅增加1MB体积，但简化脚本编写）

环境变量

部分基础设置可通过环境变量配置，无需修改文件：

覆盖Netdata配置

覆盖配置相对简单，可通过以下方式：

• 替换/etc/netdata/overrides/netdata.ini为自定义文件，确保netdata用户可读取
• 从外部挂载/etc/netdata/overrides（注意权限）
• 在RUN指令中通过echo追加配置段和键值对，例如：

dockerfile
FROM braindoctor/netdata-minimal
RUN \
    echo "[plugins]" >> /etc/netdata/overrides/netdata.ini && \
    echo "python.d = yes" >> /etc/netdata/overrides/netdata.ini

注意：ini文件中不要有前导空格，否则解析和合并会失败！

安装/启用自定义插件

在Dockerfile中按常规方式安装：

1. 确保安装依赖包
2. 安装Netdata配置文件
3. 设置正确权限，确保netdata用户可读取和执行插件及配置文件
4. 构建并测试

安装自定义脚本

将以.sh结尾的shell脚本放入/etc/netdata/pre-start.d或/etc/netdata/post-start.d：

• 预启动脚本在合并/覆盖/etc/netdata/overrides文件前按字母顺序执行
• 后启动脚本在合并后、Netdata启动前执行，脚本将通过bash调用

标签

所有标签基于多架构Alpine：

• latest：等同于amd64
• armhf
• i386
• aarch64

Netdata用户

官方firehol/netdata基础镜像设计为netdata用户运行Netdata。容器初始以root启动，随后切换为netdata用户。