silug/unifi

unifi-docker 镜像文档

镜像概述

unifi-docker是一个用于在Docker容器中运行Ubiquiti Networks UniFi Controller的镜像。UniFi Controller是一款集中管理Ubiquiti网络设备（如路由器、交换机、无线接入点等）的软件。该镜像提供了便捷的容器化部署方式，简化了UniFi Controller的安装和管理流程。更多信息可访问https://hub.docker.com/r/silug/unifi/%E3%80%82

核心功能与特性

• 容器化运行：将UniFi Controller封装在Docker容器中，隔离运行环境，避免与主机系统依赖冲突
• 持久化存储：支持通过卷挂载实现配置、日志和运行数据的持久化保存
• 端口映射：预设必要的网络端口映射，确保UniFi Controller与网络设备正常通信
• 灵活部署：支持手动运行和系统服务自动启动两种部署方式

使用场景

• 家庭网络中部署UniFi Controller，管理家用UniFi设备
• 小型企业网络环境下集中管理多台UniFi网络设备
• 测试环境中快速部署和重置UniFi Controller配置

使用方法

准备工作

首先创建用于持久化存储的目录：

bash
mkdir -pv /srv/docker/unifi-store/{run,log,lib}

拉取镜像

bash
docker pull silug/unifi

运行容器

使用以下命令启动UniFi Controller容器：

bash
docker run -p 8080:8080 -p 8443:8443 -p 8880:8880 -p 8843:8843 -p 3478:3478/udp \
  --name=unifi --rm \
  -v /srv/docker/unifi-store/run:/var/run/unifi \
  -v /srv/docker/unifi-store/log:/var/log/unifi \
  -v /srv/docker/unifi-store/lib:/var/lib/unifi \
  silug/unifi

注意：如果需要指定绑定的本地IP地址，可以在端口映射前添加IP，例如：-p localip:8080:8080

配置systemd自动启动

为实现系统启动时自动运行容器，可创建如下systemd服务文件（例如/etc/systemd/system/unifi.service）：

ini
[Unit]
Description=Unifi controller
Requires=docker.service
After=docker.service

[Service]
User=root
Restart=on-failure
RestartSec=10
ExecStartPre=-/usr/bin/docker kill unifi
ExecStartPre=-/usr/bin/docker rm unifi
ExecStartPre=-/bin/rm -f /srv/docker/unifi-store/run/unifi.pid
ExecStart=/usr/bin/docker run -p 8080:8080 -p 8443:8443 -p 8880:8880 -p 8843:8843 -p 3478:3478/udp --name=unifi --rm -v /srv/docker/unifi-store/run:/var/run/unifi -v /srv/docker/unifi-store/log:/var/log/unifi -v /srv/docker/unifi-store/lib:/var/lib/unifi silug/unifi
ExecStop=-/usr/bin/docker stop unifi

[Install]
WantedBy=multi-user.target

启用并启动服务：

bash
systemctl daemon-reload
systemctl enable --now unifi