unifi-docker

Unifi Docker Docker Image

jasherai

这是Ubiquiti Network UniFi Controller的Docker容器化版本,支持非root用户运行、多版本标签选择、自定义SSL证书及外部MongoDB,可集中管理UniFi系列网络设备(如AP、交换机等)。

下载次数: 0状态:社区镜像维护者:jasherai仓库类型:镜像最近更新:

unifi-docker镜像说明

镜像概述

本镜像为Ubiquiti Network UniFi Controller的容器化实现,用于集中管理UniFi系列网络设备(无线AP、交换机、安全网关等)。支持多版本标签、非root运行、数据持久化及自定义配置,适配企业/家庭网络管理场景。

核心功能

  1. 多版本支持:提供稳定版(latest/stable)、LTS版、RC版等标签,满足不同部署需求。
  2. 安全运行:通过RUNAS_UID0=false切换为999/999的unifi用户运行,降低权限风险。
  3. 数据持久化:绑定/unifi卷保存配置(data)、日志(log)及证书(cert)。
  4. 外部MongoDB:通过环境变量配置外部MongoDB服务,实现数据分离。
  5. 自定义证书:映射/unifi/cert卷并设置相关变量,支持自定义SSL证书。
  6. 时区配置:通过TZ变量指定时区(如Asia/Shanghai)。

使用场景

  • 企业/家庭UniFi网络设备的集中配置与监控。
  • 跨平台部署(Linux/macOS优先,Windows需注意Mongo卷限制)。
  • 高安全性要求的非root容器运行场景。
  • 需外部MongoDB实现数据独立存储的部署需求。

配置说明

关键环境变量

变量名默认值说明
RUNAS_UID0true是否以root运行(建议设为false)
TZ-时区设置(如Asia/Shanghai)
UNIFI_HTTPS_PORT8443Web界面HTTPS端口
DB_URI-外部MongoDB URI(需配合STATDB_URI/DB_NAME)

卷映射

  • /unifi:主卷,包含data(配置)、log(日志)、cert(证书)子目录。
  • /unifi/data:替代原/var/lib/unifi,保存核心配置。

暴露端口

  • 8080/tcp:设备命令控制 | 8443/tcp:Web界面+API | 3478/udp:STUN服务 | ***/udp:UBNT发现

部署示例

Docker Run(Linux/macOS)

bash
mkdir -p unifi/data unifi/log
docker run --rm --init \
  -p 8080:8080 -p 8443:8443 -p 3478:3478/udp -p 10001:10001/udp \
  -e TZ='Asia/Shanghai' -e RUNAS_UID0=false \
  -v ~/unifi:/unifi --name unifi \
  docker.xuanyuan.run/jasherai/unifi-docker:stable

Docker Compose(含MongoDB)

yaml
version: '2.2'
services:
  unifi:
    image: docker.xuanyuan.run/jasherai/unifi-docker:stable
    init: true
    environment:
      TZ: 'Asia/Shanghai'
      RUNAS_UID0: 'false'
      DB_URI: 'mongodb://mongo:27017/unifi'
      STATDB_URI: 'mongodb://mongo:27017/unifi_stat'
      DB_NAME: 'unifi'
    ports:
      - 8080:8080
      - 8443:8443
      - 3478:3478/udp
      - 10001:10001/udp
    volumes:
      - ./unifi:/unifi
    depends_on:
      - mongo
  mongo:
    image: docker.xuanyuan.run/mongo:4.4
    volumes:
      - mongo_data:/data/db
volumes:
  mongo_data:

设备Adoption

  • Layer3:Web界面设置控制器IP并重启;或SSH到设备执行set-inform http://<主机IP>:8080/inform。
  • Layer2:使用--net=host参数运行,或配置macvlan网络。

镜像拉取方式

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

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

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

DockerHub 原生拉取命令

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