linuxserver/unifi-network-application

Unifi Network Application 软件是一款功能强大的企业级无线软件引擎，非常适合需要低延迟和高 uptime 性能的高密度客户端部署场景。

支持的架构

该镜像支持以下架构，通过 Docker manifest 实现多平台识别：

应用设置

设置完成后，Web UI 可通过 [***] 访问。可使用首次运行向导配置应用程序或恢复备份。

此容器需要外部 MongoDB 数据库实例。

设置外部数据库

Unifi Network Application 8.1 版本开始支持 MongoDB 3.6 至 7.0。从 9.0 版本开始，还支持 MongoDB 8.0。

请确保固定数据库镜像版本，不要使用 latest 标签，因为 MongoDB 不支持主要版本之间的自动升级。

如果使用 官方 MongoDB 容器，可通过 init-mongo.sh 文件创建用户：

#!/bin/bash

if which mongosh > /dev/null 2>&1; then
  mongo_init_bin='mongosh'
else
  mongo_init_bin='mongo'
fi
"${mongo_init_bin}" <<EOF
use ${MONGO_AUTHSOURCE}
db.auth("${MONGO_INITDB_ROOT_USERNAME}", "${MONGO_INITDB_ROOT_PASSWORD}")
db.createUser({
  user: "${MONGO_USER}",
  pwd: "${MONGO_PASS}",
  roles: [
    { db: "${MONGO_DBNAME}", role: "dbOwner" },
    { db: "${MONGO_DBNAME}_stat", role: "dbOwner" },
    { db: "${MONGO_DBNAME}_audit", role: "dbOwner" }
  ]
})
EOF

MongoDB 容器示例配置：

unifi-db:
  image: docker.io/mongo:<version tag>
  container_name: unifi-db
  environment:
    - MONGO_INITDB_ROOT_USERNAME=root
    - MONGO_INITDB_ROOT_PASSWORD=
    - MONGO_USER=unifi
    - MONGO_PASS=
    - MONGO_DBNAME=unifi
    - MONGO_AUTHSOURCE=admin
  volumes:
    - /path/to/data:/data/db
    - /path/to/init-mongo.sh:/docker-entrypoint-initdb.d/init-mongo.sh:ro
  restart: unless-stopped

设备 adoption

要让 Unifi 采用其他设备（如接入点），需更改 inform IP 地址。进入设置 > 系统 > 高级，将 Inform 主机设置为设备可访问的主机名或 IP 地址，并勾选 "Override" 复选框。

手动 adoption 设备步骤：

ssh ubnt@$AP-IP
set-inform [***]

默认设备密码为 ubnt。$address 是运行此容器的主机 IP 地址，$AP-IP 是接入点 IP 地址。

从 Unifi-Controller 迁移

如果使用 Unifi Controller 容器的 mongoless 标签，可以直接切换到 Unifi Network Application 容器，无需执行任何迁移步骤。

不能从现有 Unifi-Controller 容器进行就地升级，必须先备份然后恢复。

最简单的迁移方法是从 Unifi-Controller Web UI 进行完整备份（包括历史记录），然后关闭旧容器。启动新容器并挂载干净的 /config，使用设置向导执行恢复。

Docker 部署方案示例

docker-compose

---
services:
  unifi-network-application:
    image: lscr.io/linuxserver/unifi-network-application:latest
    container_name: unifi-network-application
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - MONGO_USER=unifi
      - MONGO_PASS=
      - MONGO_HOST=unifi-db
      - MONGO_PORT=27017
      - MONGO_DBNAME=unifi
      - MONGO_AUTHSOURCE=admin
      - MEM_LIMIT=1024 #可选
      - MEM_STARTUP=1024 #可选
      - MONGO_TLS= #可选
    volumes:
      - /path/to/unifi-network-application/data:/config
    ports:
      - 8443:8443
      - 3478:3478/udp
      - 10001:10001/udp
      - 8080:8080
      - 1900:1900/udp #可选
      - 8843:8843 #可选
      - 8880:8880 #可选
      - 6789:6789 #可选
      - 5514:5514/udp #可选
    restart: unless-stopped

docker cli

docker run -d \
  --name=unifi-network-application \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e MONGO_USER=unifi \
  -e MONGO_PASS= \
  -e MONGO_HOST=unifi-db \
  -e MONGO_PORT=27017 \
  -e MONGO_DBNAME=unifi \
  -e MONGO_AUTHSOURCE=admin \
  -e MEM_LIMIT=1024 `#optional` \
  -e MEM_STARTUP=1024 `#optional` \
  -e MONGO_TLS= `#optional` \
  -p 8443:8443 \
  -p 3478:3478/udp \
  -p 10001:10001/udp \
  -p 8080:8080 \
  -p 1900:1900/udp `#optional` \
  -p 8843:8843 `#optional` \
  -p 8880:8880 `#optional` \
  -p 6789:6789 `#optional` \
  -p 5514:5514/udp `#optional` \
  -v /path/to/unifi-network-application/data:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/unifi-network-application:latest

参数说明

用户/组标识符

使用卷（-v 标志）时，可通过指定用户 PUID 和组 PGID 避免主机 OS 与容器之间的权限问题。确保主机上的任何卷目录都归您指定的相同用户所有。

使用 id your_user 命令可查看您的 PUID 和 PGID：

id your_user

更新说明

通过 Docker Compose 更新

# 更新镜像
docker-compose pull unifi-network-application

# 更新容器
docker-compose up -d unifi-network-application

# 移除旧镜像
docker image prune

通过 Docker Run 更新

# 更新镜像
docker pull lscr.io/linuxserver/unifi-network-application:latest

# 停止运行中的容器
docker stop unifi-network-application

# 删除容器
docker rm unifi-network-application

# 使用相同参数重新创建容器（按上述 docker run 命令）

支持信息

• 容器运行时的 Shell 访问：

docker exec -it unifi-network-application /bin/bash

* 实时监控容器日志：
  ```bash
docker logs -f unifi-network-application

• 容器版本号：

docker inspect -f '{{ index .Config.Labels "build_version" }}' unifi-network-application

* 镜像版本号：
  ```bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/unifi-network-application:latest