limosek/itop

iTop Docker镜像

镜像概述和主要用途

该Docker镜像用于iTop的自动部署，需配合mariadb容器提供数据库服务。镜像已预装IPAM（IP地址管理）模块，可快速搭建IT服务管理（ITSM）平台，简化iTop的安装和配置流程。

核心功能和特性

• 自动部署：简化iTop的安装过程，无需手动配置
• 预装IPAM模块：集成TeemIP IP地址管理模块，扩展iTop功能
• 持久化存储：支持关键目录（配置、数据等）的持久化卷挂载
• 环境变量配置：通过环境变量灵活配置数据库连接、管理员账户等参数
• 状态自动检测：自动判断iTop是否已安装，支持安装和升级流程

使用场景和适用范围

适用于需要快速部署IT服务管理平台的场景，如企业IT部门、数据中心管理等，特别适合需要IP地址管理功能的用户，可作为IT基础设施管理的核心工具。

使用方法和配置说明

使用docker-compose部署

推荐使用docker-compose.yml进行部署，示例配置如下：

yaml
version: "3.9"
services:
  db:
    image: mariadb:10.11
    restart: unless-stopped
    environment:
      MARIADB_ROOT_PASSWORD: "___rootpw___"  # 替换为实际数据库root密码
      MYSQL_DATABASE: "itop"
      MYSQL_USER: "itop"
      MYSQL_PASSWORD: "___itoppw___"  # 替换为itop数据库用户密码
    volumes:
      - db:/var/lib/mysql  # 数据库数据持久化卷

  itop:
    image: limosek/itop:latest
    depends_on:
      - db  # 依赖db服务
    environment:
      DBUSER: itop  # 数据库用户名
      DBPASSWORD: "___itoppw___"  # 数据库用户密码（需与db服务中的MYSQL_PASSWORD一致）
      DBNAME: itop  # 数据库名
      DBHOST: db  # 数据库主机名（docker-compose服务名）
      DBADMINUSER: root  # 数据库管理员用户名
      DBADMINPASSWORD: "___rootpw___"  # 数据库管理员密码（需与db服务中的MARIADB_ROOT_PASSWORD一致）
      ITOPURL: https://itop.some.where/  # 替换为实际iTop访问URL
    volumes:
      - data:/var/www/html/data  # 数据持久化卷
      - conf:/var/www/html/conf  # 配置持久化卷
      - production:/var/www/html/env-production  # 生产环境配置卷
    ports:
      - 800:80  # 端口映射（主机端口:容器端口）

networks:
  default:

volumes:
  db:  # 数据库卷
  conf:  # 配置卷
  data:  # 数据卷
  production:  # 生产环境配置卷

环境变量配置

可通过以下环境变量自定义iTop配置：

# iTop版本配置
ENV ITOP_VERSION=3.2.1          # iTop主版本号
ENV ITOP_SUBVERSION=1           # iTop子版本号
ENV ITOP_REVISION=16749         # iTop修订版本号

# 数据库连接配置
ENV DBHOST=db                   # 数据库主机名
ENV DBUSER=itop                 # 数据库用户名
ENV DBPASSWORD=itop             # 数据库用户密码
ENV DBNAME=itop                 # 数据库名称

# iTop管理员账户配置
ENV ITOPADMIN=admin             # 默认管理员用户名
ENV ITOPPASSWORD=admin          # 默认管理员密码
ENV ITOPLANG="EN US"            # 默认语言（英文）

# iTop访问URL配置（必须与浏览器访问URL一致）
ENV ITOPURL=http://itop/        
ENV DBADMIN=root                # 数据库管理员用户名

# 数据库自动配置参数
ENV DBADMINPASSWORD=admin       # 数据库管理员密码

# 部署模式配置（默认安装，已安装则自动忽略）
ENV ITOPMODE=install            # 模式：install（安装）或upgrade（升级）

# IPAM模块下载地址
ENV TEEMIP_URL="https://sourceforge.net/projects/teemip/files/teemip%20-%20an%20iTop%20module/3.2.1/teemip-core-ip-mgmt-3.2.1-813.zip/download"  # TeemIP模块下载链接

工作原理

容器启动时执行以下流程：

1. 持久化卷检查：验证是否挂载了持久化卷（conf、data、extensions、env-production），若已挂载则将默认数据复制到卷中。

2. iTop状态检测：

   • 若未安装（/var/www/html/conf/installed.stamp文件不存在），执行安装流程；
   • 若安装失败，自动尝试升级流程；
   • 安装或升级成功后，创建/var/www/html/conf/installed.stamp标记文件。

3. 权限设置：将/var/www/html目录权限恢复为www-data用户，确保服务正常运行。

4. 服务启动：若iTop已安装，直接启动Apache服务，提供iTop访问。