unifi-docker

Unifi Docker Docker Image

netpak
自动构建

这是Ubiquiti Network UniFi控制器的容器化版本,用于管理UniFi系列网络设备(如无线AP、交换机、安全网关等),支持灵活部署、设备adoption及自定义配置。

下载次数: 0状态:自动构建维护者:netpak仓库类型:镜像最近更新:

unifi-docker镜像说明

镜像概述

本镜像为Ubiquiti Network UniFi控制器的容器化实现,支持稳定版、旧稳定版及特定版本标签,可便捷部署以集中管理UniFi系列网络设备。镜像跟踪UniFi APT仓库版本,部分最新稳定版会提前推送。

核心功能

  1. 设备管理:支持UniFi无线AP、交换机、安全网关等设备的adoption与配置
  2. 灵活部署:兼容桥接网络、主机网络等多种模式,适配不同场景
  3. 自定义配置:可设置时区、JVM参数,支持挂载自定义SSL证书
  4. 数据持久化:通过卷挂载保存配置数据与日志,确保数据不丢失

使用场景

  • 家庭/企业网络中部署UniFi控制器,实现设备集中管理
  • 测试环境快速搭建UniFi控制平台,验证网络配置
  • 容器化运维场景,简化UniFi控制器的部署与升级流程

配置说明

支持标签

标签描述
latest/stable/unifi-5.5跟踪UniFi稳定版(截至2017-07-31为5.5.20)
oldstable/unifi-5.4跟踪UniFi旧稳定版(截至2017-07-31为5.4.19)
特定版本(如5.4.19)固定使用指定版本的UniFi控制器

环境变量

  • TZ:设置时区(例如Asia/Shanghai)
  • JVM_MAX_THREAD_STACK_SIZE:调整JVM最大线程栈大小(例如1280k)

卷挂载

  • /var/lib/unifi:保存控制器配置数据
  • /var/log/unifi:存储运行日志
  • /var/run/unifi:存放运行时临时信息
  • /var/cert/unifi:挂载自定义SSL证书(需包含cert.pem、privkey.pem、chain.pem)

暴露端口

  • 8080/tcp:设备命令与控制
  • 8443/tcp:Web界面与API访问
  • 8843/tcp:HTTPS门户
  • 8880/tcp:HTTP门户
  • 3478/udp:STUN服务
  • 6789/tcp:Speed Test(仅unifi5版本)
  • ***/udp:UBNT设备发现

部署示例

Docker Run快速启动

bash
mkdir -p unifi/data unifi/logs
docker run --rm --init \
  -p 8080:8080 -p 8443:8443 \
  -p 3478:3478/udp -p 10001:10001/udp \
  -e TZ='Asia/Shanghai' \
  -v ~/unifi/data:/var/lib/unifi \
  -v ~/unifi/logs:/var/log/unifi \
  --name unifi docker.xuanyuan.run/netpak/unifi-docker:latest

设备Adoption方法

Layer3 SSH Adoption

SSH到目标设备执行以下命令:

bash
mca-cli
set-inform http://<主机IP>:8080/inform

Layer2 Adoption

  • 主机网络模式:添加--net=host参数
  • 桥接网络模式:配置macvlan驱动(参考Docker官方文档)

Beta版本构建(可选)

如需构建Beta版本,使用以下命令:

bash
docker build -t unifi-beta \
  --build-arg PKGURL=[***] \
  "https://github.com/jacobalberty/unifi-docker.git#beta"

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 unifi-docker 镜像标签

docker pull docker.xuanyuan.run/netpak/unifi-docker:<标签>

DockerHub 原生拉取命令

docker pull netpak/unifi-docker:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告