raabf/ona

OpenNetAdmin (ONA) Docker镜像

概述

OpenNetAdmin (ONA) 是一款开源的IP地址管理(IPAM)工具，提供数据库管理的IP网络清单。通过集中式AJAX Web界面和完整CLI接口，可跟踪子网、主机和IP地址，减少管理错误，支持批量操作和脚本任务。适用于替代电子表格进行网络管理，提供DNS和DHCP配置管理、子网审计、插件扩展等功能。

核心功能和特性

• 双界面支持：提供AJAX Web界面和完整CLI接口，满足图形化操作和脚本自动化需求
• 网络清单管理：集中跟踪子网、主机和IP地址信息，减少管理错误
• 插件系统：支持功能扩展，可根据需求定制功能
• 自动化能力：支持批量操作和脚本任务，适合大规模网络管理
• 配置管理：可管理DNS和DHCP服务器配置，存档主机配置
• 安全更新：镜像每月自动重建，整合最新PHP版本和ONA代码更新

支持的标签

注：静态构建版本基于特定ONA和PHP版本，不可变更，适合需要可重现性的场景；自动重建版本定期更新，包含最新PHP补丁版本，适合需要安全更新的场景。

安装和使用方法

获取镜像

从Dockerhub拉取

bash
docker pull raabf/ona:latest

可将latest替换为支持的标签（如develop、v19.0.2等）。

手动构建

克隆仓库并运行构建脚本：

bash
git clone https://gitlab.com/raabf/ona-docker.git
cd ona-docker
ENGINE=docker ONA_VERSION="v19.0.1" PHP_VERSION="8.2" IMAGE_NAME="ona" IMAGE_TAG="mytag" DOCKERFILE_PATH='ona/Dockerfile' ona/scripts/build.sh

构建参数说明：

• PHP_VERSION：PHP版本，如8.1、8.2（可选）
• ONA_VERSION：ONA版本，可指定git分支、标签或提交哈希（必填）
• ENGINE：容器引擎，如docker或podman（可选，默认docker）
• IMAGE_NAME：镜像名称（可选，默认ona）
• IMAGE_TAG：镜像标签（必填）
• DOCKERFILE_PATH：Dockerfile路径（可选，默认ona/Dockerfile）

创建容器

使用docker run

bash
docker run --detach --name ona --publish 0.0.0.0:8666:80 \
  -v /etc/ona/local/:/opt/ona/www/local \
  -v /etc/ona/etc/:/opt/ona/etc \
  -v /etc/timezone:/etc/timezone:ro \
  -v /etc/localtime:/etc/localtime:ro \
  raabf/ona:latest

参数说明：

• --publish 0.0.0.0:8666:80：将容器80端口映射到主机8666端口
• -v /etc/ona/local/:/opt/ona/www/local：持久化ONA配置目录
• -v /etc/ona/etc/:/opt/ona/etc：插件和客户端脚本配置目录
• -v /etc/timezone:/etc/timezone:ro、-v /etc/localtime:/etc/localtime:ro：挂载主机时区信息

使用docker-compose

创建docker-compose.yml文件：

yaml
---
services:
  ona:
    image: raabf/ona:latest
    container_name: ona
    volumes:
      - /etc/ona/local/:/opt/ona/www/local
      - /etc/ona/etc/:/opt/ona/etc
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - 8666:80
    restart: unless-stopped

  sql:
    image: mariadb:10.4
    container_name: ona-sql
    environment:
      - MYSQL_ROOT_PASSWORD=YourRootSecretPassword
    volumes:
      - db:/var/lib/mysql
    restart: unless-stopped

volumes:
  db:

启动服务：

bash
docker compose up -d

设置ONA

1. 初始化配置：

bash
docker exec --interactive --tty ona ./init_conf.sh
docker restart ona

2. 访问Web安装界面： 打开浏览器访问 http://localhost:8666/ona，按照向导完成安装。

3. 或使用CLI安装：

bash
docker exec --interactive --tty ona php /opt/ona/install/installcli.php

4. 修复数据库连接权限：

ONA安装后需调整数据库用户主机限制：

bash
# 进入数据库容器执行SQL命令
docker exec -it ona-sql mysql --user root --password -e 'RENAME USER "ona_sys"@"sql" TO "ona_sys"@"%";'
# 重启数据库容器
docker restart ona-sql

升级

升级到新版本时，需执行数据库迁移：

1. 拉取新版本镜像并重启容器
2. 访问 http://localhost:8666/ona/?runinstaller=y 完成迁移
3. 或执行CLI命令：docker exec -it ona php /opt/ona/install/installcli.php

HTTP代理

有关HTTP代理配置的详细信息，请参考扩展文档。

适用场景

• 企业网络IP地址管理
• 数据中心子网和主机跟踪
• 网络设备配置存档与审计
• DNS和DHCP服务器配置管理
• 批量网络操作自动化脚本

贡献

如发现问题或有改进建议，请通过GitLab仓库提交issue或合并请求。