nico640/docker-unms

Docker UISP（前UNMS）

镜像概述和主要用途

这是Ubiquiti网络管理系统（UISP）的一体化Docker镜像，包含运行UISP所需的所有组件，使用https://github.com/just-containers/s6-overlay%E8%BF%9B%E8%A1%8C%E8%BF%9B%E7%A8%8B%E7%AE%A1%E7%90%86%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E5%8F%AF%E5%9C%A8%E5%A4%A7%E5%A4%9A%E6%95%B0%E6%94%AF%E6%8C%81Docker%E7%9A%84%E5%B9%B3%E5%8F%B0%E4%B8%8A%E8%BF%90%E8%A1%8C%EF%BC%8C%E5%8C%85%E6%8B%ACDocker 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容器：

shell
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设备上运行：

shell
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配置

yaml
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  # 本地配置目录路径