phpipam/phpipam-cron

phpIPAM Cron容器

镜像概述和主要用途

phpIPAM cron容器是开源Web IP地址管理应用（IPAM）的配套定时任务容器，专为执行计划网络发现作业等定时任务设计。该容器简化了phpIPAM环境的维护，适合对LAMP栈经验有限的网络管理员使用，需注意仅支持单实例部署以避免任务冲突。

核心功能和特性

• 定时任务执行：负责phpIPAM的计划网络发现作业及其他定时任务。
• 单实例部署：仅允许部署单个运行实例，防止定时任务重复执行。
• 权限要求：需NET_ADMIN和NET_RAW容器能力以支持ping和SNMP功能；不支持rootless docker；Kubernetes环境需设置allowPrivilegeEscalation=true。
• 灵活配置：支持通过环境变量配置数据库连接、时区、扫描间隔等参数，敏感信息可从文件加载。

使用场景和适用范围

适用于网络管理员部署phpIPAM进行IP地址管理时，需要自动执行定时网络发现、定期数据同步等维护任务的场景。尤其适合需简化phpIPAM环境搭建和维护的中小型网络环境。

详细使用方法和配置说明

容器镜像信息

phpIPAM Docker镜像包含两个主要组件：

• phpipam-www：前端Apache/PHP容器，支持多实例部署和负载均衡。
• phpipam-cron：定时任务容器，仅支持单实例部署。

源代码与问题反馈

• Dockerfile构建源码：https://github.com/phpipam-docker/phpipam-docker
• phpipam-docker问题和PR：https://github.com/phpipam-docker/phpipam-docker
• phpIPAM应用问题和PR：https://github.com/phpipam/phpipam

支持的标签

• latest：跟踪最新稳定版本及Alpine Linux安全更新。
• 1.7x：跟踪1.7 git维护分支及Alpine Linux安全更新。
• 1.6x/1.5x/1.4x：分别跟踪对应git维护分支（已过时）。
• nightly：夜间开发快照（非生产环境）。
• v1.7.x/v1.6.y/v1.5.y：静态快照，无Alpine安全更新。

Docker部署示例

完整栈部署（Docker Compose）

创建docker-compose.yml并运行docker-compose -p phpIPAM up -d：

yaml
# 警告：替换示例密码为安全密钥
version: '3'

services:
  phpipam-web:
    image: phpipam/phpipam-www:latest
    ports:
      - "80:80"
    environment:
      - TZ=Asia/Shanghai
      - IPAM_DATABASE_HOST=phpipam-mariadb
      - IPAM_DATABASE_PASS=my_secret_phpipam_pass
      - IPAM_DATABASE_WEBHOST=%
    restart: unless-stopped
    volumes:
      - phpipam-logo:/phpipam/css/images/logo
      - phpipam-ca:/usr/local/share/ca-certificates:ro
    depends_on:
      - phpipam-mariadb

  phpipam-cron:
    image: phpipam/phpipam-cron:latest
    environment:
      - TZ=Asia/Shanghai
      - IPAM_DATABASE_HOST=phpipam-mariadb
      - IPAM_DATABASE_PASS=my_secret_phpipam_pass
      - SCAN_INTERVAL=1h
    restart: unless-stopped
    volumes:
      - phpipam-ca:/usr/local/share/ca-certificates:ro
    depends_on:
      - phpipam-mariadb

  phpipam-mariadb:
    image: mariadb:latest
    environment:
      - MYSQL_ROOT_PASSWORD=my_secret_mysql_root_pass
    restart: unless-stopped
    volumes:
      - phpipam-db-data:/var/lib/mysql

volumes:
  phpipam-db-data:
  phpipam-logo:
  phpipam-ca:

外部MySQL服务器部署（Docker Compose）

适用于使用现有MySQL服务器的场景，创建docker-compose.yml并部署：

yaml
version: '3'

services:
  phpipam-web:
    image: phpipam/phpipam-www:latest
    ports:
      - "80:80"
    environment:
      - TZ=Asia/Shanghai
      - IPAM_DATABASE_HOST=my.database.server
      - IPAM_DATABASE_USER=existing_username
      - IPAM_DATABASE_PASS=existing_password
      - IPAM_DATABASE_NAME=existing_db_name
    restart: unless-stopped
    volumes:
      - phpipam-logo:/phpipam/css/images/logo
      - phpipam-ca:/usr/local/share/ca-certificates:ro

  phpipam-cron:
    image: phpipam/phpipam-cron:latest
    environment:
        - TZ=Asia/Shanghai
        - IPAM_DATABASE_HOST=my.database.server
        - IPAM_DATABASE_USER=existing_username
        - IPAM_DATABASE_PASS=existing_password
        - IPAM_DATABASE_NAME=existing_db_name
        - SCAN_INTERVAL=1h
    restart: unless-stopped
    volumes:
      - phpipam-ca:/usr/local/share/ca-certificates:ro

volumes:
  phpipam-logo:
  phpipam-ca:

配置说明

环境变量配置

支持通过环境变量配置容器，标记📂的变量可添加_FILE后缀从文件加载值（如Docker secrets），示例：

bash
docker ... -e IPAM_DATABASE_PASS_FILE=/run/secrets/ipam_database_password

容器内配置文件（v1.5.0+）

通过IPAM_CONFIG_FILE环境变量加载自定义config.php（需挂载至持久卷），此时仅以下变量有效：

负载均衡多实例时，需在config.php中设置$session_storage = "database";以保证会话一致性。

可信CA证书

容器启动时会执行update-ca-certificates，/usr/local/share/ca-certificates目录下的PEM格式证书将被自动信任。可挂载持久卷至该目录添加自定义CA：

bash
/usr/local/share/ca-certificates # ls
ACME_ROOT.crt ACME_INTERMEDIATE.crt

HAProxy SSL反向代理示例

部署HAProxy容器

bash
docker run -d -p 443:443 -p 80:80 --name HAProxy --restart always -v haproxy_ssl:/etc/ssl/certs -v haproxy_cfg:/usr/local/etc/haproxy haproxy:latest

配置haproxy.cfg

在容器内创建/usr/local/etc/haproxy/haproxy.cfg：

text
global
  daemon
  maxconn 256

resolvers mydns
  nameserver ns1 192.168.1.53:53  # 替换为内部DNS服务器
  nameserver ns2 192.168.2.53:53
  accepted_payload_size 8192

defaults
  mode http
  timeout connect 5000ms
  timeout client  5000ms
  timeout server 60000ms
  option forwardfor

frontend phpipam-rp
  bind *:80
  bind *:443 ssl crt /etc/ssl/certs
  http-request redirect scheme https code 301 unless { ssl_fc }
  default_backend phpipam-web
  http-request del-header X-Forwarded-For

backend phpipam-web
  server s1 phpipam.local:80 check resolvers mydns init-addr none  # 替换为phpipam容器DNS
  http-request set-header X-Forwarded-Uri %[url]
  http-request set-header X-Forwarded-Port %[dst_port]
  http-request add-header X-Forwarded-Proto https if { ssl_fc }

部署证书并重启

将证书和密钥挂载至/etc/ssl/certs，重启容器并检查日志：

bash
docker restart HAProxy
docker container logs HAProxy

许可证

GNU General Public License v3.0

维护者

Gary Allan <***>