phpipam-agent

phpIPAM是一个开源Web IP地址管理应用，旨在提供轻量且简单的IP地址管理解决方案。该项目由Miha Petkovsek开发维护，采用GPL v3许可协议，项目源码托管于此处，更多信息可访问phpIPAM官网。本容器可用作phpIPAM的发现扫描代理，执行网络主机发现与可用性检查。

核心功能与特性

• 作为phpIPAM的远程扫描代理，支持主机可用性检测
• 执行网络自动发现，更新网络设备状态
• 集成计划任务（cron），支持自定义扫描频率
• 轻量部署，通过环境变量灵活配置
• 日志输出到stdout/stderr，便于容器日志管理

使用场景

适用于基于phpIPAM进行IP地址管理的网络环境，需对子网内主机进行自动发现、可用性监控及状态更新的场景，如企业内网IP管理、数据中心网络设备监控等。

使用方法

前提条件

已部署phpIPAM应用，并具备管理员权限配置扫描代理。

配置phpIPAM

1. 配置远程代理
   登录phpIPAM后台，进入 管理 > 扫描代理，添加远程代理并获取密钥（用于容器认证）。
   !config_agent

2. 配置子网扫描
   对需监控的子网，启用扫描功能并关联上述配置的远程代理（选择对应远程代理）。
   !config_subnet

计划扫描配置

容器内置cron任务用于定期执行扫描，默认配置如下（可通过CRON_SCHEDULE自定义）：

# 每15分钟执行主机状态更新和网络发现
1/15 * * * * /usr/local/bin/php /opt/phpipam-agent/index.php update
1/15 * * * * /usr/local/bin/php /opt/phpipam-agent/index.php discover

容器部署

Docker Compose部署（推荐）

创建docker-compose.yml文件，配置如下：

version: '2'
services:
    phpipam-agent:
        container_name: phpipam-agent
        restart: unless-stopped  # 除非手动停止，否则自动重启
        image: mc303/phpipam-agent:latest  # 使用最新版镜像
        environment:
          - MYSQL_ENV_MYSQL_HOST=198.51.100.1  # MySQL数据库主机地址（phpIPAM数据库）
          - MYSQL_ENV_MYSQL_DATABASE=phpipam  # 数据库名称
          - MYSQL_ENV_MYSQL_USER=phpipam_user    # 数据库用户名
          - MYSQL_ENV_MYSQL_PASSWORD=secure_password  # 数据库密码
          - MYSQL_ENV_MYSQL_PORT=3306  # MySQL端口（默认3306）
          - PHPIPAM_AGENT_KEY=your_agent_key_here  # 从phpIPAM获取的远程代理密钥
          - CRON_SCHEDULE=1/15 * * * *  # 扫描频率（cron表达式，默认每15分钟）
          - TZ=Asia/Shanghai  # 时区（如Asia/Shanghai）
        ports:
          - "3306:3306"  # 端口映射（根据实际需求调整，如无需对外暴露可删除）

启动容器：

docker-compose up -d

配置参数说明

日志管理

容器日志输出到stdout/stderr，可通过以下命令查看：

docker logs phpipam-agent  # 查看实时日志
docker logs -f phpipam-agent  # 持续跟踪日志

致谢

本镜像基于pierrecdn/phpipam-agent开发，镜像发布于Docker Hub。