看文字内容头疼的朋友，可以直接跳转至文章末尾的操作视频（视频是我今年 5 月份专门录制的）

1. 前言

之前在少数派发过《【Rethinking IT】如何应用数据图表了解家里的 Unifi 网络状况？》，给一些爱折腾的玩家朋友提供了一些关于 Unifi 设备的其他玩法。这次写这篇文章主要是之前也有朋友遇到了问题来请教我，那么我就做了个视频，同时把相关的文档发布在少数派。

这个问题是什么呢？是这样，去年底的的时候 linuxserver.io 在 Unifi Controller 的项目下更新了一句说明 "This image is deprecated. We will not offer support for this image and it will not be updated."。在今年年初，Unifi Controller 8.0.24 版本后，彻底弃用这个镜像，转而使用不带数据库的 Unifi Network Application 镜像。

那么这个改变带来的 问题 是什么呢？

1. Unifi 设备一直在迭代更新，不更新控制器软件，U7 等后续无线 AP 可能会无法被控制器接管；
2. 部署难度增加，前后端分离，需要部署 Mongo 数据库和 Unifi Network Application 应用。对于有运维或者开发经验的朋友来说，这肯定没什么难度的，但是对于普通朋友来说，哪怕 NAS 普及、Docker 普及的现在，多容器编排部署依然是有一定门槛。

那么，解决方法 有哪些呢？

1. 钞能力党：直接选择带控制器的 Unifi 路由器 或者购买硬件的 Unifi Cloud Key Gen 2 Plus，无需手动管理，软件和固件都自动升级推送，最为简单；
2. 虚拟机党：虚拟机部署也是直接升级软件即可，因为本身就是数据库和应用分类部署，也不受影响；
3. 容器党：本文就旨在帮助各位 Docker 控制器用户进行平滑的迁移升级。

2. 部署流程

首先，先保证你的 Unifi Controller 控制器版本已经是 8.0.24 版本，若不是，建议先升级至该版本。以我多年实施各种软件的迁移来说，最佳实践都是升级到旧版中 最新的小版本，进行 同版本迁移，最为保险。比如以前实施 Windows 版本的 VMware vCenter 到 Linux 版本的 VCSA 的迁移亦是如此。迁移完成后，再进行控制器的升级。

2.1. 硬件需求

这边基于 i3-N305 小主机下 Proxmox VE 虚拟化的 Debian LXC 进行部署，硬件需求如下：（如果资源不够，可适当缩减）

1. CPU：2-4 vCPU
2. 内存：2G
3. 硬盘：20G

2.2. 部署 Docker 和 Docker Compose

部署好 Docker 和 Docker Compose，本文不再赘述这部分内容，我之前的文章《【Rethinking IT】如何应用数据图表了解家里的 Unifi 网络状况？》有详细步骤，可以参考之前的文章

2.3. 创建 Mongo 初始化脚本

创建 Mongo 数据库目录，我这边选择在 /opt 下创建，您也可以使用 /data 等其他目录，只需确保有写入权限即可。

mkdir -p /opt/docker/unifi-mongo && cd /opt/docker/unifi-mongo

创建 Mongo 数据库初始化脚本 init-mongo.js。

vim init-mongo.js

db.getSiblingDB("unifi").createUser({user: "unifi", pwd: "unifi", roles: [{role: "dbOwner", db: "unifi"}]});
db.getSiblingDB("unifi_stat").createUser({user: "unifi", pwd: "unifi", roles: [{role: "dbOwner", db: "unifi_stat"}]});

2.4. 创建 Compose 编排文件

创建 Unifi 项目（可省略，直接在当前目录创建也可以，我个人习惯根据项目区分文件夹）

mkdir ~/unifi && cd ~/unifi

创建 docker-compose.yml 编排文件。

vim docker-compose.yml

version: "3"
services:

  unifi-mongo:
    image: mongo:4.4.28
    container_name: unifi-mongo
    hostname: unifi-mongo
    volumes:
      - /opt/docker/unifi-mongo/configdb:/data/configdb
      - /opt/docker/unifi-mongo/db:/data/db
      - /opt/docker/unifi-mongo/init-mongo.js:/docker-entrypoint-initdb.d/init-mongo.js:ro
    environment:
      - 'TZ=Asia/Shanghai'
    restart: always
    
  unifi-network-application:
    image: linuxserver/unifi-network-application:8.0.24
    container_name: unifi-network-application
    hostname: unifi-network-application
    depends_on:
      - unifi-mongo
    networks:
      - unifi
    ports:
      - 8443:8443 # Unifi web admin port
      - 3478:3478/udp # Unifi STUN port
      - 10001:10001/udp # Required for AP discovery
      - 8080:8080 # Required for device communication
      - 1900:1900/udp # Required for Make controller discoverable on L2 network option
      - 8843:8843 # Unifi guest portal HTTPS redirect port
      - 8880:8880 # Unifi guest portal HTTP redirect port
      - 6789:6789 # For mobile throughput test
      - 5514:5514/udp # Remote syslog port
    volumes:
      - /opt/docker/unifi-network-application/config:/config
    environment:
      - 'TZ=Asia/Shanghai'
      - 'MONGO_USER=unifi'
      - 'MONGO_PASS=unifi'
      - 'MONGO_HOST=unifi-mongo'
      - 'MONGO_PORT=27017'
      - 'MONGO_DBNAME=unifi'
      - 'MEM_LIMIT=1024'
      - 'MEM_STARTUP=1024'
      # - MONGO_TLS= #optional
      # - MONGO_AUTHSOURCE= #optional
    restart: always

2.5. 拉起 Compose 编排

使用以下命令拉起容器编排。

docker-compose up -d

3. 视频教程

后续的 Unifi 设备的 迁移流程，麻烦大家跟随视频进行操作即可，有更多关于 Unifi 设备的技术问题，也欢迎大家留言评论，我有空都会进行回复。

也欢迎大家给我视频一键三连，谢谢！

4. 参考链接

1. linuxserver/unifi-controller - Docker Image | Docker Hub
2. linuxserver/unifi-network-application - Docker Image | Docker Hub