镜像概览

完整引用
docker.io/linuxserver/unifi-controller
Registry
docker.io
命名空间
linuxserver
仓库
unifi-controller
已缓存 Tag 数
1715
最近同步
07/06/2026, 08:29 AM

简介

LinuxServer UniFi Network Controller 镜像,集中管理 Ubiquiti AP/交换机/网关,适合中小网络私有化网管部署。

详细介绍

linuxserver/unifi-controller 运行 UniFi Network Application,管理 adoption、固件与 VLAN 策略。定位为网络管理 Web 平台,需持久化 /config 与 UDP 3478/8080 等端口;K8s Deployment + LoadBalancer 暴露管理面。

快速启动

docker run -d --name unifi \
  -p 8443:8443 -p 3478:3478/udp \
  -v /data/unifi:/config \
  docker.io/linuxserver/unifi-controller:latest

推荐实践

docker run -d --name unifi \
  --restart unless-stopped \
  -p 8443:8443 -p 3478:3478/udp -p 10001:10001/udp \
  -e PUID=1000 -e PGID=1000 \
  -v /data/unifi:/config \
  docker.io/linuxserver/unifi-controller:8.6.0

核心参数说明

  • -p 8443:8443 — UniFi Web 管理 HTTPS
  • -p 3478:3478/udp — STUN 设备发现
  • -v .../config:... — 控制器数据持久化
  • 固定 tag — 控制器与设备固件 pin

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: unifi-controller
spec:
  replicas: 1
  selector:
    matchLabels:
      app: unifi
  template:
    metadata:
      labels:
        app: unifi
    spec:
      containers:
        - name: unifi
          image: docker.io/linuxserver/unifi-controller:8.6.0
          ports:
            - containerPort: 8443
          volumeMounts:
            - name: config
              mountPath: /config
      volumes:
        - name: config
          persistentVolumeClaim:
            claimName: unifi-config
---
apiVersion: v1
kind: Service
metadata:
  name: unifi
spec:
  type: LoadBalancer
  selector:
    app: unifi
  ports:
    - port: 8443
      targetPort: 8443

UDP 端口需额外 Service;备份 /config PVC。

最新 Tag(20 条)

查看全部 1715 个 Tag →
Tag架构推送时间大小Digest同步期望操作
docker.io/linuxserver/unifi-controller
:8.0.24
linux/amd64linux/arm64
2024/01/02 02:36335.0 MBsha256:fcd5d8b13a77
docker.io/linuxserver/unifi-controller
:version-8.0.24
linux/amd64linux/arm64
2024/01/02 02:36335.0 MBsha256:fcd5d8b13a77
docker.io/linuxserver/unifi-controller
:8.0.24-ls221
linux/amd64linux/arm64
2024/01/02 02:36335.0 MBsha256:fcd5d8b13a77
docker.io/linuxserver/unifi-controller
:latest
linux/amd64linux/arm64
2024/01/02 02:36335.0 MBsha256:fcd5d8b13a77
docker.io/linuxserver/unifi-controller
:arm64v8-8.0.24
linux/arm64
2024/01/02 02:36332.2 MBsha256:28fd12acf2dd
docker.io/linuxserver/unifi-controller
:amd64-8.0.24
linux/amd64
2024/01/02 02:36335.0 MBsha256:fcd5d8b13a77
docker.io/linuxserver/unifi-controller
:arm64v8-version-8.0.24
linux/arm64
2024/01/02 02:36332.2 MBsha256:28fd12acf2dd
docker.io/linuxserver/unifi-controller
:arm64v8-latest
linux/arm64
2024/01/02 02:36332.2 MBsha256:28fd12acf2dd
docker.io/linuxserver/unifi-controller
:arm64v8-8.0.24-ls221
linux/arm64
2024/01/02 02:36332.2 MBsha256:28fd12acf2dd
docker.io/linuxserver/unifi-controller
:amd64-latest
linux/amd64
2024/01/02 02:35335.0 MBsha256:fcd5d8b13a77
docker.io/linuxserver/unifi-controller
:amd64-version-8.0.24
linux/amd64
2024/01/02 02:35335.0 MBsha256:fcd5d8b13a77
docker.io/linuxserver/unifi-controller
:amd64-8.0.24-ls221
linux/amd64
2024/01/02 02:35335.0 MBsha256:fcd5d8b13a77
docker.io/linuxserver/unifi-controller
:8.0.24-mongoless
linux/amd64linux/arm64
2024/01/02 02:27271.1 MBsha256:36aaec2d263a
docker.io/linuxserver/unifi-controller
:mongoless-version-8.0.24
linux/amd64linux/arm64
2024/01/02 02:27271.1 MBsha256:36aaec2d263a
docker.io/linuxserver/unifi-controller
:mongoless-8.0.24-ls36
linux/amd64linux/arm64
2024/01/02 02:27271.1 MBsha256:36aaec2d263a
docker.io/linuxserver/unifi-controller
:mongoless
linux/amd64linux/arm64
2024/01/02 02:27271.1 MBsha256:36aaec2d263a
docker.io/linuxserver/unifi-controller
:arm64v8-8.0.24-mongoless
linux/arm64
2024/01/02 02:27272.3 MBsha256:99afeb9bb296
docker.io/linuxserver/unifi-controller
:amd64-8.0.24-mongoless
linux/amd64
2024/01/02 02:27271.1 MBsha256:36aaec2d263a
docker.io/linuxserver/unifi-controller
:arm64v8-mongoless-version-8.0.24
linux/arm64
2024/01/02 02:27272.3 MBsha256:99afeb9bb296
docker.io/linuxserver/unifi-controller
:arm64v8-mongoless
linux/arm64
2024/01/02 02:27272.3 MBsha256:99afeb9bb296