pierrecdn/phpipam

docker-phpipam

phpIPAM是一款开源的Web IP地址管理应用，其目标是提供轻量且简单的IP地址管理解决方案。该项目由Miha Petkovsek开发并维护，基于GPL v3许可发布，项目源码可在https://github.com/phpipam/phpipam%E8%8E%B7%E5%8F%96%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E8%AE%BF%E9%97%AEphpIPAM%E5%AE%98%E7%BD%91%E3%80%82

!phpIPAM logo

如何使用此Docker镜像

MySQL数据库

运行一个专用于phpipam的MySQL数据库容器：

bash
$ docker run --name phpipam-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -v /my_dir/phpipam:/var/lib/mysql -d mysql:5.6

在此命令中，数据存储在主机系统的/my_dir/phpipam目录下，并使用指定的root密码。

Phpipam容器

bash
$ docker run -ti -d -p 80:80 -e MYSQL_ENV_MYSQL_ROOT_PASSWORD=my-secret-pw --name ipam --link phpipam-mysql:mysql pierrecdn/phpipam

此命令将两个容器链接起来，并暴露HTTP端口。

首次安装步骤

• 访问 http://<ip>[:<特定端口>]/install/
• 步骤1：选择"Automatic database installation"（自动数据库安装）

!step1

• 步骤2：重新输入连接信息

!step2

• 注意：这两个步骤的顺序可以通过修补phpipam来交换（参见https://github.com/phpipam/phpipam/issues/25%EF%BC%89
• 步骤3：配置管理员用户密码

!step3

• 完成安装！

!done

Docker Compose配置

您也可以使用Docker Compose创建一体化的YAML部署描述文件，如下所示：

yaml
version: '2'

services:
  mysql:
    image: mysql:5.6
    environment:
      - MYSQL_ROOT_PASSWORD=my-secret-pw
    restart: always
    volumes:
      - db_data:/var/lib/mysql
  ipam:
    depends_on:
      - mysql
    image: pierrecdn/phpipam
    environment:
      - MYSQL_ENV_MYSQL_USER=root
      - MYSQL_ENV_MYSQL_ROOT_PASSWORD=my-secret-pw
      - MYSQL_ENV_MYSQL_HOST=mysql
    ports:
      - "80:80"
volumes:
  db_data:

然后运行：

bash
$ docker-compose up -d

您还可以将MYSQL_ENV_PASSWORD_FILE环境变量指向一个文件，此时该文件的内容将被用作密码。这使得可以使用Docker Secrets等功能：

yaml
version: '3'

services:
  ipam:
    environment:
      - MYSQL_ENV_MYSQL_PASSWORD_FILE=/run/secrets/phpipam_mysql_root_password
    secrets:
      - phpipam_mysql_root_password

可以通过运行echo my-secret-pw | docker secret create phpipam_mysql_root_password -来创建密钥。

高级配置

以下是phpipam容器中可用的环境变量列表，可使用-e参数传递给docker。运行容器并不实际需要这些变量，它们仅用于调整行为。

特定集成（HTTPS、多主机容器等）

根据您的需求和Docker设置，需要暴露相应资源。

对于HTTPS，在phpipam容器前运行反向代理并链接到它。

对于多主机容器，暴露端口，运行etcd或consul以实现服务发现等。

注意事项

phpIPAM由Miha团队积极开发中。要升级版本，只需将PHPIPAM_VERSION环境变量设置为目标版本（参见https://github.com/phpipam/phpipam/releases%EF%BC%89%E3%80%82