deltabg/icingaweb2

Delta Cloud 生产就绪型Icinga Web 2 Docker镜像

Delta Cloud自2009年起为企业客户提供定制化IT服务，团队由经验丰富的网络工程师、DevOps工程师和系统管理员组成，专注于设计易维护、低成本且可扩展的解决方案。

关于Icinga Web 2

Icinga Web 2是基于PHP的Icinga 2系统监控工具的强大Web界面，具有快速、响应式、易扩展等特点，可通过模块增强功能。更多信息请访问官方文档。

镜像特点

• 基于ubuntu:focal构建
• 开箱即用的Icinga Web 2核心功能
• 包含icingacli工具
• 预装模块：Graphite、Director、Incubator
• 支持SSL加密
• 无SSH服务，建议使用docker exec进行容器内操作

依赖要求

该镜像无法独立运行，需配合以下容器：

1. mariadb:focal（数据库服务）
2. deltabg/icinga2（监控核心）
3. graphiteapp/graphite-statsd（可选，用于Graphite模块）

使用场景

适用于企业或个人搭建系统监控平台，支持对服务器、网络设备等基础设施的状态监控，可通过模块扩展实现更复杂的监控需求。

配置与部署

手动部署

1. 克隆项目：

   bash
   git clone https://github.com/DeltaBG/docker-icingaweb2.git && cd docker-icingaweb2
   

2. 编辑example.env文件配置环境变量
3. 创建网络：

   bash
   docker network create icinga
   

4. 启动MariaDB容器：

   bash
   docker run -d \
     --network icinga \
     --name icinga_mariadb \
     --restart unless-stopped \
     --env-file ./example.env \
     -h icinga-mariadb \
     -v /data/var/lib/mysql:/var/lib/mysql \  
     --health-cmd "mysqladmin ping -h localhost -p$MYSQL_ROOT_PASSWORD" \
     --health-interval docker.xuanyuan.run/30s \
     --health-timeout docker.xuanyuan.run/30s \
     --health-retries 3 \
     --health-start-period 5s \
     mariadb:focal
   

5. 启动Icinga2容器：

   bash
   docker run -d \
     --privileged \
     --network icinga \
     --name icinga_icinga2 \
     --restart unless-stopped \
     --env-file ./example.env \
     -h icinga-icinga2 \
     -p 5665:5665 \
     -v /data/etc/icinga2:/etc/icinga2 \
     -v /data/var/lib/icinga2:/var/lib/icinga2 \
     -v /data/var/log/icinga2:/var/log/icinga2 \
     docker.xuanyuan.run/deltabg/icinga2
   

6. 启动Icinga Web2容器：

   bash
   docker run -d \
     --network icinga \
     --name icinga_icingaweb2 \
     --restart unless-stopped \
     --env-file ./example.env \
     -h icinga-icingaweb2 \
     -p 80:80 \
     -p 443:443 \
     -v /data/etc/icingaweb2:/etc/icingaweb2 \
     -v /data/var/log/icingaweb2:/var/log/icingaweb2 \
     -v /data/var/log/apache2:/var/log/apache2 \
     docker.xuanyuan.run/deltabg/icingaweb2
   

Docker Compose部署

1. 克隆项目并配置example.env
2. 执行部署：

   bash
   docker-compose up -d
   

Ansible Playbook部署

1. 克隆项目并配置example.env
2. 执行部署：

   bash
   ansible-playbook ansible-playbook.yml
   

高级配置

SSL支持

• 设置ICINGAWEB2_SSL=true启用SSL
• 自动获取Let's Encrypt证书：设置ICINGAWEB2_SSL_LETSENCRYPT=true，并配置ICINGAWEB2_APACHE_SERVER_NAME和ICINGAWEB2_APACHE_SERVER_ADMIN
• 自定义证书：挂载/etc/apache2/ssl卷，包含cert.pem（证书）、privkey.pem（私钥）、chain.pem（证书链）

Director模块

• 设置ICINGAWEB2_MODULE_DIRECTOR=true启用模块
• 默认自动初始化（可通过ICINGAWEB2_MODULE_DIRECTOR_KICKSTART=false禁用）

Graphite模块

• 设置ICINGAWEB2_MODULE_GRAPHITE=true启用模块
• 需配合外部Graphite容器（如graphiteapp/graphite-statsd），并配置ICINGAWEB2_MODULE_GRAPHITE_HOST

环境变量

卷挂载

作者

• Nedelin Petkov（https://github.com/mlg1）
• Valentin Dzhorov（https://github.com/vdzhorov/）

许可证

基于https://github.com/DeltaBG/docker-icingaweb2/blob/main/LICENSE。

关注我们

*** | *** | LinkedIn