11notes/uosserver

!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/banner/README.png

UOSSERVER

!size!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png!pulls!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png%5B](https://github.com/11notes/docker-uosserver/issues)!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png!swiss_made

将Unifi OS服务器作为容器运行

概述 📢

自托管软件包，可从单一安装提供UniFi Network及未来UniFi生态系统中的其他应用。

注意事项 ⚠️

为安全运行此镜像，由于其需要访问主机的某些资源，若未使用无root运行时，请通过sysbox运行时而非默认Docker运行时运行！此镜像处于积极开发中，其处理卷、数据等的方式可能会有重大变更！

功能说明 📖

我能用它做什么？ 此镜像将为您提供一个稳定的Unifi OS服务器镜像。该镜像（目前）打破了所有容器理念，通过在镜像内部运行由Unifi OS Server管理的多个容器。这意味着镜像内应用的更新由Unifi OS Server处理，而非镜像本身。只有Unifi OS Server镜像本身由此镜像管理。考虑为此使用虚拟机而非容器。

核心优势 💶

为什么我应该运行此镜像而不是其他已存在的镜像？ 好问题！因为...

• ...此镜像通过CI/CD自动更新至最新版本
• ...此镜像具有健康检查
• ...此镜像通过安全且固定的CI/CD流程创建

如果您重视安全性、简洁性和极致优化，那么此镜像可能适合您。

卷配置 📁

• /sys/fs/cgroup - 主机上访问cgroups的目录
• /persistent - 包管理器目录
• /data - 所有应用程序数据目录
• /srv - 服务特定数据目录
• /var/lib/unifi - UniFi Network Controller数据目录
• /var/lib/mongodb - MongoDB数据目录
• /etc/rabbitmq/ssl - RabbitMQ自签名SSL证书目录

COMPOSE配置 ✂️

yaml
name: "unifi"
services:
  os-server:
    runtime: sysbox-runc
    cpus: "8.0"
    mem_reservation: "4G"
    mem_limit: "8G"
    image: "11notes/uosserver:5.1.15"
    cap_add:
      - NET_RAW
      - NET_ADMIN
    cgroup: host
    environment:
      TZ: "Europe/Zurich"
      UOS_SYSTEM_IP: "${IP}"
    volumes:
      - "/sys/fs/cgroup:/sys/fs/cgroup:rw"
      - "os-server.var:/persistent"
      - "os-server.log:/var/log"
      - "os-server.data:/data"
      - "os-server.srv:/srv"
      - "os-server.lib:/var/lib/unifi"
      - "os-server.db:/var/lib/mongodb"
      - "os-server.rabbitmq.ssl:/etc/rabbitmq/ssl"
    tmpfs:
      - "/run:exec"
      - "/run/lock"
      - "/tmp:exec"
      - "/var/lib/journal"
      - "/var/opt/unifi/tmp:size=64m"
    ports:
      - 443:443
      - 5005:5005
      - 5671:5671
      - 6789:6789
      - 8080:8080
      - 8443:8443
      - 8444:8444
      - 8880:8880
      - 8881:8881
      - 8882:8882
      - 9543:9543
      - 11084:11084
      - 3478:3478/udp
      - 5514:5514/udp
      - 10003:10003/udp
    networks:
      frontend:
    sysctls:
      net.ipv4.ip_unprivileged_port_start: 443
    restart: "always"

volumes:
  os-server.var:
  os-server.log:
  os-server.data:
  os-server.srv:
  os-server.lib:
  os-server.db:
  os-server.rabbitmq.ssl:

networks:
  frontend:

如需了解如何更改此容器镜像的默认UID/GID，请参考https://github.com/11notes/RTFM/blob/main/linux/container/image/11notes/how-to.changeUIDGID.md#change-uidgid-the-correct-way%E3%80%82

默认设置 🗃️

环境变量 📝

主要标签 🏷️

这些是镜像的主要标签。每个提交及其简写sha256值也有对应的标签。

• https://hub.docker.com/r/11notes/uosserver/tags?name=5.1.15

没有latest标签，我该如何更新？

我认为:latest标签是个坏习惯，完全不应使用。许多开发人员在新版本中引入破坏性变更，这会给使用:latest的用户带来麻烦。如果您不想将标签更改为最新的语义化版本，只需使用语义化版本的短版本。您可以使用:5或:5.1而非:5.1.15。由于这些标签会在每个新版本中更新为软件的最新版本，使用它们与使用:latest类似，但至少固定在主版本或次版本，理论上不会引入破坏性变更。

如果您仍坚持使用此应用的前沿版本，只需使用:rolling标签，但请注意！您将立即获得应用的最新版本，无论是否存在破坏性变更或安全问题。风险自负！

镜像仓库 ☁️

docker pull 11notes/uosserver:5.1.15
docker pull ghcr.io/11notes/uosserver:5.1.15
docker pull quay.io/11notes/uosserver:5.1.15

源代码 💾

• https://github.com/11notes/docker-uosserver

基础镜像 🏛️

• 11notes/uosserver:fw-5.0.6

构建工具 🧰

• uosserver
• https://github.com/11notes/docker-util

通用提示 📌

• 使用反向代理（如Traefik、Nginx、HAproxy）终止TLS并保护您的端点
• 使用Let’s Encrypt DNS-01挑战获取服务的有效SSL证书

ElevenNotes™️

此镜像由您自行承担风险使用。更新镜像至不同版本前请务必备份。查看https://github.com/11notes/docker-uosserver/releases%E4%BA%86%E8%A7%A3%E9%87%8D%E5%A4%A7%E5%8F%98%E6%9B%B4%E3%80%82%E8%8B%A5%E4%BD%BF%E7%94%A8%E6%AD%A4%E9%95%9C%E5%83%8F%E9%81%87%E5%88%B0%E9%97%AE%E9%A2%98%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4https://github.com/11notes/docker-uosserver/issues%EF%BC%8C%E8%B0%A2%E8%B0%A2%E3%80%82%E8%8B%A5%E6%9C%89%E9%97%AE%E9%A2%98%E6%88%96%E5%BB%BA%E8%AE%AE%EF%BC%8C%E8%AF%B7%E5%88%9B%E5%BB%BA%E6%96%B0%E7%9A%84https://github.com/11notes/docker-uosserver/discussions%E8%80%8C%E9%9D%9Eissue%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%9C%A8https://github.com/11notes?tab=repositories%E6%89%BE%E5%88%B0%E6%88%91%E6%89%80%E6%9C%89%E5%85%B6%E4%BB%96%E4%BB%93%E5%BA%93%E3%80%82

创建于 30.05.2026, 06:14:41 (CET)