本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

steynovich/unifi

基于Linux的UniFi控制器镜像，用于集中管理UniFi网络设备（如路由器、交换机、无线接入点等），提供设备配置、监控、固件更新及网络分析功能。

0 次下载activesteynovich镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

UniFi Controller Docker镜像文档

镜像概述

本镜像为基于Linux系统的UniFi控制器（UniFi Controller），用于集中管理Ubiquiti Networks的UniFi系列网络设备，包括无线接入点（AP）、路由器、交换机、安全网关等。通过该镜像可快速部署UniFi控制器服务，实现网络设备的统一配置、监控与管理。

核心功能与特性

1. 设备集中管理

支持UniFi全系列网络设备的发现、配置与管理
提供设备状态实时监控（在线状态、连接客户端数、信号强度等）
支持批量设备配置与固件更新

2. 网络监控与分析

实时网络流量监控与统计
客户端连接历史记录与流量分析
网络异常事件告警（设备离线、连接中断等）

3. 配置管理

网络拓扑可视化展示
自定义网络配置（SSID、VLAN、QoS策略等）
配置备份与恢复功能

4. 多站点与用户管理

支持多站点网络独立管理
基于角色的用户权限控制（管理员、只读用户等）
跨站点设备迁移与配置同步

使用场景

企业网络管理：中小型企业网络设备集中管控，简化IT运维
家庭/小型办公网络：统一管理家庭或SOHO环境中的UniFi设备
多地点网络：连锁店、分支机构等多地点网络的远程统一管理
临时网络部署：展会、活动等临时场景的快速网络搭建与管理

使用方法与配置说明

1. 基本部署（docker run）

docker run -d \
  --name=unifi-controller \
  --restart=always \
  -p 8080:8080 \  # 设备通信端口（TCP）
  -p 8443:8443 \  # Web管理界面（HTTPS，TCP）
  -p 8843:8843 \  # HTTPS备用端口（TCP）
  -p 8880:8880 \  # HTTP备用端口（TCP）
  -p 3478:3478/udp \  # STUN服务端口（UDP）
  -v /path/to/unifi/data:/var/lib/unifi \  # 数据持久化目录
  -e TZ=Asia/Shanghai \  # 设置时区
  linuxserver/unifi-controller:latest  # 镜像名称（以实际为准）

2. Docker Compose配置

version: '3'
services:
  unifi-controller:
    image: linuxserver/unifi-controller:latest
    container_name: unifi-controller
    restart: always
    ports:
      - "8080:8080"    # 设备通信
      - "8443:8443"    # Web管理界面（HTTPS）
      - "8843:8843"    # HTTPS备用
      - "8880:8880"    # HTTP备用
      - "3478:3478/udp" # STUN
    volumes:
      - ./unifi-data:/var/lib/unifi  # 本地数据目录
    environment:
      - TZ=Asia/Shanghai  # 时区设置
      - PUID=1000         # 运行用户ID（可选）
      - PGID=1000         # 运行用户组ID（可选）

3. 关键配置说明

3.1 数据持久化

必须挂载数据卷：/var/lib/unifi 目录包含控制器配置、设备信息、日志等关键数据，需通过 -v 参数挂载至宿主机目录，避免容器重启后数据丢失。

3.2 端口映射

端口	协议	用途
8080	TCP	设备与控制器通信端口
8443	TCP	Web管理界面（HTTPS），推荐使用
8843	TCP	HTTPS备用端口（部分场景下使用）
8880	TCP	HTTP备用端口（不推荐生产环境使用）
3478	UDP	STUN服务端口（用于NAT穿透）
10001	UDP	设备发现（可选，部分旧设备需要）

3.3 环境变量

变量	说明	默认值
TZ	时区设置，如`Asia/Shanghai`	`UTC`
PUID	运行容器的用户ID	911
PGID	运行容器的用户组ID	911
MEM_LIMIT	内存限制，如`1024M`	自动调整

4. 访问与初始化

部署完成后，通过浏览器访问 [***] 进入Web管理界面
首次访问需完成初始化设置：创建管理员账户、设置站点名称、接受用户协议
初始化后，控制器将自动发现网络中的UniFi设备，按照向导完成设备 adoption（认领）与配置

5. 升级与维护

镜像更新：

docker pull linuxserver/unifi-controller:latest
docker stop unifi-controller
docker rm unifi-controller
# 重新执行docker run命令或docker-compose up -d

数据备份：定期备份挂载的 /var/lib/unifi 目录，可通过 tar -zcvf unifi-backup.tar.gz /path/to/unifi/data 实现

注意事项

生产环境中建议启用HTTPS（8443端口），禁用HTTP（8880端口）
确保宿主机时间与控制器时间同步，避免证书或日志时间异常
大规模部署（>50台设备）建议增加内存资源（至少2GB RAM）
跨网段设备管理需确保8080端口在网络层可达

查看更多 unifi 相关镜像 →

linuxserver/unifi

by linuxserver.io

LinuxServer.io提供的Unifi容器，用于运行Unifi控制器以管理Ubiquiti网络设备。

UniFi无线接入点控制器是一款用于集中管理多台无线接入点的网络管理工具，可实现AP部署配置、用户接入控制、网络状态实时监控、流量数据分析、安全策略制定实施及固件统一更新等功能，支持远程管理与无缝漫游，能有效优化网络性能，助力构建稳定、高效、安全的企业级无线网络环境。

运行UniFi Network Application的Docker容器，支持多种稳定版和测试版标签，提供Alpine、Debian、Ubuntu基础镜像选项，支持外部MongoDB集成、自定义SSL证书及环境变量配置，适用于网络设备集中管理与监控。

15510M+ pulls

上次更新：3 天前

常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

🔐

登录方式进行 Docker 镜像下载加速教程

通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤

🐧

Linux Docker 镜像下载加速教程

在 Linux 系统上配置轩辕镜像源，支持主流发行版

🖥️

Windows/Mac Docker 镜像下载加速教程

在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统

📦

Docker Compose 镜像下载加速教程

在 Docker Compose 中使用轩辕镜像加速，支持容器编排

📋

K8s containerd 镜像下载加速教程

在 k8s 中配置 containerd 使用轩辕镜像加速

🔧

宝塔面板 Docker 镜像下载加速教程

在宝塔面板中配置轩辕镜像加速，提升服务器管理效率

💾

群晖 NAS Docker 镜像下载加速教程

在 Synology 群晖NAS系统中配置轩辕镜像加速

🐂

飞牛fnOS Docker 镜像下载加速教程

在飞牛fnOS系统中配置轩辕镜像加速

📱

极空间 NAS Docker 镜像下载加速教程

在极空间NAS中配置轩辕镜像加速

⚡

爱快路由 ikuai Docker 镜像下载加速教程

在爱快ikuai系统中配置轩辕镜像加速

🔗

绿联 NAS Docker 镜像下载加速教程

在绿联NAS系统中配置轩辕镜像加速

🌐

威联通 NAS Docker 镜像下载加速教程

在威联通NAS系统中配置轩辕镜像加速

📦

Podman Docker 镜像下载加速教程

在 Podman 中配置轩辕镜像加速，支持多系统

📚

ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程

配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤

🚀

专属域名方式进行 Docker 镜像下载加速教程

无需登录即可使用轩辕镜像加速服务，更加便捷高效

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429

unifi Docker 镜像下载 - 轩辕镜像

unifi 镜像详细信息和使用指南

unifi 镜像标签列表和版本信息

unifi 镜像拉取命令和加速下载

unifi 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

unifi 镜像详细信息

unifi 镜像标签列表

unifi 镜像使用说明

unifi 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南