UniFi OS Server 是自建 UniFi 的新标准，取代了传统的 UniFi Network Server。虽然 Network Server 提供了基础的托管功能，但它不支持诸如 Organizations、IdP 集成或 Site Magic SD-WAN 等关键 UniFi OS 功能。通过统一的操作系统，UniFi OS Server 现已提供与 UniFi 原生平台（包括 CloudKeys、Cloud Gateways 和 官方 UniFi Hosting）相同的管理体验，并且可与 Site Manager 完全兼容，实现中心化的多站点管理。
如果你想安装传统的 UniFi Network Server，请根据你的操作系统参考以下对应的安装指南：
-
要求在设置自建 UniFi Network Server 之前，请确保你满足以下要求：
-
操作系统要求：
-
Linux：Ubuntu 24.04 或更高版本；Debian 13 或更高版本；或任何满足以下要求的现代 Linux 发行版：
- systemd
- libc 2.31+
- podman 4.9.3+（使用 pasta 网络）
- slirp4netns 1.2+（通常随 Podman 一同安装，但部分系统可能需要单独安装）
-
Windows：Windows 10 或更高版本，Windows Server 2022
- 在设置过程中会自动安装 WSL（Windows Subsystem for Linux）版本 2。
- 注意，目前不支持在 Hyper-V 的虚拟机中安装。
- macOS：Catalina 13.1.0 或更高版本
-
Linux：Ubuntu 24.04 或更高版本；Debian 13 或更高版本；或任何满足以下要求的现代 Linux 发行版：
-
硬件规格：
- CPU：x86-64 处理器
- 内存：至少 2 GB
- 网络：100 Mbps 有线以太网
- 存储：至少剩余 10 GB
-
其他要求：
- 请确保所需端口（例如 TCP 8080、UDP 3478）已开放。
-
操作系统要求：
安装 UniFi OS Server
- 下载安装程序：获取最新的 UniFi OS Server，可以在 Releases 或下载页面右键点击 下载 并选择 复制链接地址，链接地址大致如下： https://fw-download.ubnt.com/data/unifi-os-server/8b93-linux-x64-4.2.23-158fa00b-6b2c-4cd8-94ea-e92bc4a81369.23-x6
- 安装应用程序：启动安装程序并按照屏幕上的设置指引完成安装。
- （可选）启用远程管理：安装完成后，创建 UI 账号 （或使用已有账号登录），以便通过 Site Manager 启用远程管理功能。
- 采纳设备：参阅 UniFi 设备采纳 指南，获取将 AP 和交换机等 UniFi 设备添加进部署的详细步骤。
-
持续运行 UniFi：如果需要持续查看和管理采纳后的设备，UniFi OS Server 必须始终保持运行。如果 UniFi OS Server 下线，设备将会按照最后一次可用的配置继续运行。
- 如果你无法让 UniFi OS Server 持续运行，建议通过 CloudKey 或官方 UniFi 托管服务 作为其它托管方式。
注意：如果你正在从 UniFi Network Server 迁移至 UniFi OS Server，务必先关闭 Network Server 再安装 UniFi OS Server。
注意：除高可用或故障转移场景外，请不要克隆虚拟机。被克隆的虚拟机会共用 Site Manager 与 Fabrics 的远程访问令牌，导致不可预期行为。建议每次均创建全新安装实例。
-
刷新软件包列表并安装必需软件包：
sudo apt-get update && sudo apt-get install podman slirp4netns - 获取 UniFi OS Server 下载链接：在 Releases 或 下载页面 右键点击下载并选择复制链接地址，链接地址大致如下：https://fw-download.ubnt.com/data/unifi-os-server/8b93-linux-x64-4.2.23-158fa00b-6b2c-4cd8-94ea-e92bc4a81369.23-x6
-
使用 curl 或 wget 下载适用于你架构的安装程序，例如：
- curl：
curl -O <uos_server_download_link> - wget：
wget <uos_server_download_link>
- curl：
-
赋予安装程序执行权限：
chmod +x <local_path_to_uos_server_download>
-
运行安装程序：
sudo <local_path_to_uos_server_download>
- （可选）启用远程管理：安装完成后，创建 UI 账号 （或使用已有账号登录），以便通过 Site Manager 启用远程管理功能。
- 采纳设备：参阅 UniFi 设备采纳 指南，获取将 AP 和交换机等 UniFi 设备添加进部署的详细步骤。
注意：如果你正在从 UniFi Network Server 迁移至 UniFi OS Server，务必先关闭 Network Server 再安装 UniFi OS Server。
注意：除高可用或故障转移场景外，请不要克隆虚拟机。被克隆的虚拟机会共用 Site Manager 与 Fabrics 的远程访问令牌，导致不可预期行为。建议每次均创建全新安装实例。
其他常用命令
- 停止 UniFi OS Server：
sudo systemctl stop uosserver - 启动 UniFi OS Server：
sudo systemctl start uosserver - 禁用开机自启：
sudo systemctl disable uosserver - 启用开机自启：
sudo systemctl enable uosserver
目前 UniFi OS Server 不支持作为 Windows 服务运行。如需持续运作，请继续使用 UniFi Network Server，并[按照相关指引操作](/articles/205144550)。
更新 UniFi OS Server
你的 UniFi OS Server 及相关 UniFi 应用，可以通过 Site Manager 的更新管理器，或直接在本地 Control Plan 设置中更新。更多信息请参阅 UniFi 更新相关内容。
从 Network Server 迁移到 UniFi OS Server
- 请根据此处的指引，从 UniFi Network Server 获取备份数据。
- 在安装 UniFi OS Server 前，务必关闭 Network Server。
- 请按照前述“根据你的操作系统安装 UniFi OS Server”部分的说明操作。
- 在 macOS 和 Windows 上，安装程序会自动检测（如果 Network Server 安装在默认路径），并主动提供迁移现有 Network Server 设置的选项。
- 在 Linux 上，或未自动迁移时，可通过安装 UniFi OS Server 并使用 Site Export 工具手动迁移。更多信息请参阅 UniFi 备份与迁移文档。
注意：强制门户页面（Captive portal）现在使用 8444 端口（之前 Network Server 使用 8843 端口）。此端口会使用 UniFi OS 控制台设置中配置的证书；如未配置 TLS，将由 UniFi Network 直接提供服务。
常见问题解答（FAQ）
-
UniFi OS Server 多少钱？不收取任何费用。对所有 UniFi 用户完全免费、无授权限制。
-
UniFi OS Server 与官方 UniFi Hosting 有什么不同？功能上二者一致。主要区别在于 UniFi OS Server 完全由你自主管理（负责安装、维护与可用性），而官方 UniFi Hosting 由我们在云端托管、维护。
想了解官方 UniFi Hosting 的快速入门，请参阅相关内容。 -
UniFi OS Server 可以与 CloudKey 搭配使用吗？CloudKey 无法与 UniFi OS Server 一起管理 UniFi Network 设备，因为两者都包含 UniFi Network 应用，每台设备只能被单一主机管理。
不过，CloudKey 可以运行 UniFi OS Server 未支持的其他 UniFi 应用，作为补充：
- UniFi Protect（摄像头）
- UniFi Access（门禁系统）
- UniFi Talk（VoIP 电话）
- UniFi Connect（数字标牌、照明等）
-
UniFi OS Server 可以和 Cloud Gateway（UDM、UCG 或 Fortress Gateway）搭配吗？不能。Cloud Gateway 已自带 UniFi Network 应用作为其控制平面的一部分，不能被外部 UniFi OS Server 管理。
如果需要将网关与 UniFi OS Server 管理的网站配合使用，请选择我们的独立网关（UXG 系列），这些产品无内置控制器，可完全兼容外部 UniFi OS 部署。 -
会提供独立 Docker/Podman 容器形式吗？不会。本方案需在主机上运行必要的服务以实现设备发现、采纳及系统自动更新。
-
UniFi Network 应用已启动，但未发现附近的 UniFi 设备。
-
通过浏览器访问时提示“你的连接不是私密连接”。可忽略此警告。你也可以通过 设置 > 控制台 > 证书 上传自有 TLS 证书。
-
能否管理已被其他 UniFi Network 应用采纳的设备？不能。在 Windows/macOS/Linux 上安装的 UniFi Network 应用不支持查看其他 UniFi 主机上的 UniFi Network 应用部署。
-
能否自行托管 Protect 或其他 UniFi 应用？不能。UniFi OS Server 仅支持自托管 UniFi Network 应用，以及组织管理、IdP 集成和 Site Magic SD-WAN 等关键 UniFi OS 功能。其他所有 UniFi 应用需部署于兼容的 UniFi 控制台上。
