IP地址管理：docker方式部署phpIPAMv1.7.3

最新推荐文章于 2025-10-28 17:07:58 发布

原创最新推荐文章于 2025-10-28 17:07:58 发布 · 1.4k 阅读

27 ·

CC 4.0 BY-SA版权

云游

文章标签：

#docker #运维 #IP #IPv4 #IPv6

系统运维专栏收录该内容

6 篇文章

订阅专栏

最近做一个项目，需要实现“以方格图的形式，展示指定范围内的IPv4地址或IPv4地址段使用情况，支持IPv4规划使用情况的列表展示，支持导出统计报表文件。支持设置IPv6规划数据的展示方式为树形或表格”。在网上找了一下，发现phpIPAM能满足需求。

一、概述

phpIPAM（PHP IP Address Management）是一款开源的、基于 Web 的 IP 地址管理系统，专为高效管理 IPv4 和 IPv6 地址空间而设计。它提供直观的图形界面，帮助网络管理员对 IP 地址、子网、VLAN、设备、网络扫描、权限控制等进行全面管理。

核心功能概览

功能类别	主要能力
IP 地址管理	IPv4/IPv6 地址分配、状态跟踪、搜索
子网管理	CIDR 划分、继承、可视化展示
VLAN / VRF 管理	支持 802.1Q VLAN 和 VRF（虚拟路由转发）
自动发现	网络扫描、Ping、SNMP、DHCP 日志分析
用户权限	多用户、角色控制、部门隔离
API 接口	RESTful API，支持自动化集成
高可用与审计	变更日志、邮件通知、LDAP/AD 集成

二、安装部署

2.1下载

docker pull mysql:8.4.5

docker pull phpipam/phpipam-cron:v1.7.3

docker pull phpipam/phpipam-www:v1.7.3

2.2编辑一个docker-compose.yml文件

services:
  phpipam-web:
    image: phpipam/phpipam-www:v1.7.3
    ports:
      - "8081:80"
    environment:
      - TZ=Asia/Shanghai
      - IPAM_DATABASE_HOST=192.168.1.204
      - IPAM_DATABASE_USER=root
      - IPAM_DATABASE_PASS=root@12345
      - IPAM_DATABASE_NAME=ipam_db
      - OFFLINE_MODE=true
      - IPAM_FOOTER_MESSAGE=北京科技有限公司技术支持
    restart: unless-stopped
    volumes:
      - phpipam-logo:/phpipam/css/images/logo
      - phpipam-ca:/usr/local/share/ca-certificates:ro

  phpipam-cron:
    image: phpipam/phpipam-cron:v1.7.3
    environment:
        - TZ=Asia/Shanghai
        - IPAM_DATABASE_HOST=192.168.1.204
        - IPAM_DATABASE_USER=root
        - IPAM_DATABASE_PASS=root@12345
        - IPAM_DATABASE_NAME=ipam_db
        - SCAN_INTERVAL=1h
    restart: unless-stopped
    volumes:
      - phpipam-ca:/usr/local/share/ca-certificates:ro

volumes:
  phpipam-logo:
  phpipam-ca:

2.3执行

docker-compose up -d

2.4.通过界面进行安装

http://127.0.0.1:8081/

2.5.系统效果

三、参数说明

ENV	Default	WWW/CRON Container
TZ	"UTC"	✅ ✅
IPAM_DISABLE_INSTALLER	"false"	✅ ❌
IPAM_DATABASE_HOST	"127.0.0.1"	✅ ✅
IPAM_DATABASE_USER	"phpipam"	✅ ✅
IPAM_DATABASE_PASS	"phpipamadmin"	✅ ✅
IPAM_DATABASE_NAME	"phpipam"	✅ ✅
IPAM_DATABASE_PORT	3306	✅ ✅
IPAM_DATABASE_WEBHOST	"localhost"	✅ ✅
IPAM_BASE	"/"	✅ ❌
IPAM_TRUST_X_FORWARDED	"false"	✅ ❌
PROXY_ENABLED	false	✅ ✅
PROXY_SERVER	"myproxy.something.com"	✅ ✅
PROXY_PORT	8080	✅ ✅
PROXY_USE_AUTH	false	✅ ✅
PROXY_USER	"USERNAME"	✅ ✅
PROXY_PASS	"PASSWORD"	✅ ✅
IPAM_DEBUG	false	✅ ✅
OFFLINE_MODE	false	✅ ❌
COOKIE_SAMESITE	"Lax"	✅ ❌
IPAM_FOOTER_MESSAGE	""	✅ ❌
IPAM_GMAPS_API_KEY	""	✅ ❌
SCAN_INTERVAL	"1h"	❌ ✅

1. TZ - 时区设置

默认值: "UTC"

可覆盖: ✅

描述: 设置容器运行的时区（如 "Asia/Shanghai", "Europe/London"）

2. IPAM_DISABLE_INSTALLER

默认值: "false"

可覆盖: ✅

描述: 是否禁用 Web 安装向导页面。

安全建议：安装完成后应设为 "true"，防止他人重新进入安装流程。

3. IPAM_DATABASE_HOST

默认值: "127.0.0.1"

可覆盖: ✅

描述: MySQL 数据库主机地址。

4. IPAM_DATABASE_USER

默认值: "phpipam"

可覆盖: ✅

描述: 连接 MySQL 的用户名。

✅ 可自定义，但需确保该用户已在 MySQL 中创建并授权。

5. IPAM_DATABASE_PASS

默认值: "phpipamadmin"

可覆盖: ✅

描述: 对应用户的密码。

✅ 建议修改为强密码。

6. IPAM_DATABASE_NAME

默认值: "phpipam"

可覆盖: ✅

描述: 要连接的数据库名称。

✅ 必须提前在 MySQL 中创建此数据库：

CREATE DATABASE phpipam CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

特性	utf8mb3	utf8mb4
✅ 支持最大字节数	3 字节	4 字节
✅ 支持 Unicode 范围	基本多文种平面（BMP）	全 Unicode（包括补充字符）
✅ 包含 emoji？	❌ 不支持	✅ 支持
✅ 包含特殊符号？	❌ 部分数学符号、表情符号不支持	✅ 支持
✅ MySQL 默认（v8.0+）	❌ 已弃用	✅ 是默认字符集
✅ 推荐使用	❌ 不推荐	✅ 强烈推荐