thost96/omada

docker-omada 镜像文档

镜像概述

docker-omada是TP-Link Omada控制器的Docker容器化版本，用于集中管理EAP系列无线接入点。该镜像将Omada控制器软件封装为容器，支持便捷部署、数据持久化存储及环境配置，适用于需要集中管理无线网络的场景。

核心功能与特性

• 容器化部署：将Omada控制器软件打包为Docker容器，简化安装与维护流程
• 数据持久化：通过卷挂载实现控制器数据、工作目录及日志的持久化存储
• 时区配置：支持通过环境变量设置时区，确保日志时间等信息准确
• 自动重启：支持容器自动重启策略，提高服务稳定性
• 多版本支持：提供基于不同基础镜像（如Alpine、Ubuntu LTS）的版本选择

使用场景

• 企业、家庭或小型办公室网络中需要集中管理多个EAP无线接入点
• 希望通过容器化方式简化Omada控制器部署与升级的场景
• 需要确保控制器配置和日志数据持久化保存的环境

使用方法

Docker Run 部署

通过以下命令直接运行容器：

bash
docker run \
  --name omada-controller \
  --hostname omada \
  --restart always \      
  -e 'TZ=Europe/Berlin' \
  --volume 'omada-data:/opt/tplink/EAPController/data' \
  --volume 'omada-work:/opt/tplink/EAPController/work' \
  --volume 'omada-logs:/opt/tplink/EAPController/logs' \
  thost96/omada:latest

参数说明：

• --name omada-controller：指定容器名称
• --hostname omada：设置容器主机名
• --restart always：容器退出时自动重启
• -e 'TZ=Europe/Berlin'：设置时区（可替换为其他时区，如Asia/Shanghai）
• --volume：挂载卷以持久化存储数据（omada-data存储控制器数据，omada-work为工作目录，omada-logs为日志目录）

Docker Compose 部署

创建docker-compose.yml文件，内容如下：

yaml
version: '2'
services:
    omada-controller:
        container_name: omada-controller
        hostname: omada        
        restart: always
        environment:
            - TZ=Europe/Berlin
        volumes:
            - 'omada-data:/opt/tplink/EAPController/data'
            - 'omada-work:/opt/tplink/EAPController/work'
            - 'omada-logs:/opt/tplink/EAPController/logs'
        image: 'thost96/omada:latest'

通过以下命令启动服务：

bash
docker-compose up -d

更新日志

• 2.2：添加GitHub Actions自动构建功能，支持所有版本和操作系统
• 2.1：优化Dockerfile
• 2.0：添加Alpine作为替代基础镜像
• 1.9：从最新镜像中移除curl，以修复安全漏洞
• 1.8：优化Dockerfile，修复因static.tp-link.com证书变更导致的构建失败问题
• 1.7：将Omada控制器软件更新至3.2.10，同时添加3.2.10-lts-18版本以支持Ubuntu 18.04
• 1.6：主分支切换至Ubuntu 20.04 LTS，将3.2.9版本拆分为3.2.9-lts-18（Ubuntu 18.04）和3.2.9-lts-20（Ubuntu 20.04）
• 1.5：在README中添加docker run和docker compose命令
• 1.4：将Omada控制器软件更新至3.2.9
• 1.3：修复healthcheck.sh的权限错误
• 1.2：将Omada控制器软件更新至3.2.6
• 1.1：添加时区和区域设置，迁移至docker模板
• 1.0：初始版本发布