mc303/phpipam-agent

phpipam-agent

phpIPAM是一个开源Web IP地址管理应用，旨在提供轻量且简单的IP地址管理解决方案。该项目由Miha Petkovsek开发维护，采用GPL v3许可协议，项目源码托管于https://github.com/phpipam/phpipam-agent%EF%BC%8C%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E5%8F%AF%E8%AE%BF%E9%97%AEphpIPAM%E5%AE%98%E7%BD%91%E3%80%82%E6%9C%AC%E5%AE%B9%E5%99%A8%E5%8F%AF%E7%94%A8%E4%BD%9CphpIPAM%E7%9A%84%E5%8F%91%E7%8E%B0%E6%89%AB%E6%8F%8F%E4%BB%A3%E7%90%86%EF%BC%8C%E6%89%A7%E8%A1%8C%E7%BD%91%E7%BB%9C%E4%B8%BB%E6%9C%BA%E5%8F%91%E7%8E%B0%E4%B8%8E%E5%8F%AF%E7%94%A8%E6%80%A7%E6%A3%80%E6%9F%A5%E3%80%82

核心功能与特性

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

使用场景

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

使用方法

前提条件

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

配置phpIPAM

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

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

计划扫描配置

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

bash
# 每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文件，配置如下：

yaml
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"  # 端口映射（根据实际需求调整，如无需对外暴露可删除）

启动容器：

bash
docker-compose up -d

配置参数说明

日志管理

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

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

致谢

本镜像基于https://github.com/pierrecdn/phpipam-agent%E5%BC%80%E5%8F%91%EF%BC%8C%E9%95%9C%E5%83%8F%E5%8F%91%E5%B8%83%E4%BA%8Ehttps://hub.docker.com/r/pierrecdn/phpipam-agent%E3%80%82