Docker UISP（前UNMS）

镜像概述和主要用途

这是Ubiquiti网络管理系统（UISP）的一体化Docker镜像，包含运行UISP所需的所有组件，使用s6-overlay进行进程管理。该镜像可在大多数支持Docker的平台上运行，包括Docker for Mac、Docker for Windows、Synology DSM和树莓派等开发板。

核心功能和特性

• 一体化容器：单个容器集成运行UISP所需的全部组件，无需额外依赖
• 多架构支持：兼容x86_64和ARMv7/8架构，可在树莓派等ARM设备上运行
• 进程管理：采用s6-overlay实现可靠的进程管理
• 持久化存储：通过卷挂载实现配置、数据库、证书和日志的持久化存储
• 跨平台兼容：支持Mac、Windows、Linux及NAS设备等多种Docker环境

使用场景和适用范围

适用于需要在Docker环境中快速部署UISP的用户，包括：

• 家庭网络或小型企业网络管理员
• 需在树莓派等低功耗ARM设备上运行UISP的场景
• 希望通过容器化简化UISP部署和版本管理的用户

使用方法

基本使用

通过以下命令启动UISP容器：

docker run \
  -p 80:80 \
  -p 443:443 \
  -p 2055:2055/udp \
  -e TZ=<时区> \
  -v </本地配置路径>:/config \
  nico640/docker-unms:latest

树莓派/ARM设备

该镜像支持在树莓派或其他Docker-enabled ARMv7/8设备上运行：

docker run -d --name unms -p 80:80 -p 443:443 -p 2055:2055/udp -v </本地配置路径>:/config nico640/docker-unms:latest

参数说明

参数格式为“主机侧:容器侧”，具体说明如下：

必选参数

• -v </本地配置路径>:/config：持久化数据存储目录，包含数据库、证书和日志
• -p 80:80：HTTP Web服务器端口映射
• -p 443:443：HTTPS和WSS Web服务器端口映射
• -p 2055:2055/udp：Netflow端口映射（UDP协议）
• -e TZ：时区设置，例如-e TZ=Asia/Shanghai（参考时区列表）

可选参数

• -e DEMO=false：启用UISP演示模式
• -e PUBLIC_HTTPS_PORT=443：Docker主机暴露的HTTPS端口（需与映射端口一致）
• -e PUBLIC_WS_PORT=443：Docker主机暴露的WebSocket端口（需与HTTPS端口一致）
• -e HTTPS_PORT=443：容器内Web服务器监听的HTTPS端口
• -e HTTP_PORT=80：容器内Web服务器监听的HTTP端口
• -e SSL_CERT=：/config/usercert/目录下自定义SSL证书文件名
• -e SSL_CERT_KEY=：/config/usercert/目录下自定义SSL密钥文件名
• -e PUID=911：容器运行用户的UID
• -e PGID=911：容器运行用户组的GID

限制说明

• 该镜像不由Ubiquiti Networks维护或附属，运行时不应期望获得Ubiquiti官方支持
• 应用内升级功能不可用，需通过拉取最新版本镜像进行UISP升级

Docker Compose配置

version: '2'
services:
  unms:
    image: nico640/docker-unms:latest
    restart: always
    ports:
      - 80:80
      - 443:443
      - 2055:2055/udp
    environment:
      - TZ=Asia/Shanghai  # 替换为实际时区
    volumes:
      - ./volumes/unms:/config  # 本地配置目录路径