企业版私有化安装教程
本篇面向需要把平台运行在自己或客户服务器上的用户。免费基础版 edge 与按需授权的行业应用均通过 urops 部署；希望基于社区源码自行搭建或开发，请看开源版安装教程。
SaaS 在线体验（无需安装）
无需准备服务器，可以先在联犀 SaaS 平台选择以下方式体验：
- 查看共享演示：使用账号
yanshi123、密码yanshi123登录，浏览已有设备与数据。请以浏览为主，不修改共享配置或控制真实设备；设备可能暂时离线。 - 免费注册使用：在登录页注册自己的账号、创建企业，再创建产品并接入自己的设备。新账号不会复制演示数据；托管资源按 SaaS 套餐说明提供。
演示与注册的详细说明见SaaS 版体验指南。SaaS 托管资源规则与下方私有部署范围分别适用。
企业版与基础版私有部署（urops）
适用场景
基础物联网平台支持永久免费私有部署，可用于实际商业项目，不提供源码。 使用 urops 按菜单完成环境准备、选择基础版及检查运行状态；行业应用与人工服务按需购买。 这里的私有部署与云端 SaaS 免费套餐不同，托管配额不作为私有部署限制。
系统要求
- 操作系统：Linux（推荐 Ubuntu 22.04+，主机或虚拟机均可，支持 KVM/VMware 等）
- Docker 20.10+、Docker Compose 2.0+
- 内存：最低 4GB，推荐 8GB 以上
- 存储：最低 50GB（数据库 + 镜像约 10GB），推荐 100GB 以上
- 网络：可访问镜像仓库
docker.unitedrhino.com（节点联网部署时需可达云端saas.unitedrhino.com，见常见问题）
容量规划指引
以上是「仅部署平台」的基础要求。设备上报量、属性存储与保留周期会显著增加 CPU、内存与磁盘需求：
- 单机 all-in-one 部署下，8C8G + NVMe 的稳定上限约 150,000 msg/min（2500 msg/s）；日常 120,000 msg/min 建议按 12 核 / 12GB 预留余量。
- 磁盘需按「入库消息量 × 800B × 保留天数」估算，并预留系统、镜像、基础日志与备份空间。
- 音视频（录像/直播/转码）与 AI（模型推理、向量库）需要在此基础上额外增加磁盘、CPU、内存与算力。
按在线设备数、上报频率与保留时长估算最低/推荐配置：服务器配置与容量评估。
第一步：安装 urops 运维工具
免登录一键安装（自动查 Harbor 最新版本 + sha256 校验）：
curl -fsSL https://doc.unitedrhino.com/urops/install.sh | sudo bash安装完成后，所有操作都在交互式菜单（TUI）中完成——终端直接输入 urops 回车即可进入：
固定版本安装见 urops 指南。
urops update --check仅检查更新；确认后使用sudo urops update --yes更新工具。 首次使用建议先「环境准备 → 安装全部」自动装好 Docker/Compose 等环境（幂等）。
第二步：一键部署（TUI）
进入 TUI 后，「部署」→ 选择部署版本 → 选对象存储，全程菜单选择、自动拉镜像、自动初始化数据库：
免费基础版请选择 基础版 edge；需要能耗管理时再选择 能源中心 energy。其他版本按业务需要选择，不同版本的应用与授权范围不要混用。 选完版本后按提示选择对象存储（rustfs 默认即可），TUI 会展示拉取镜像、启动容器、等待健康的实时进度： 部署完成后访问 http://<服务器IP>:7777/app/edge-self/（边缘自服务页）。
命令行方式（等价）
sudo urops up --type edge --oss-type rustfs第三步：检查运行状态，按所选应用处理许可
先打开「运维 → 运行状态」确认服务健康并查看访问入口。基础版软件使用永久免费，不代表所有行业应用免费。
需要激活行业应用时，在「运维 → 激活许可」粘贴对应授权码。能耗中心提供 1 个月免费试用，¥3,000／节点授权，不限使用时间；许可步骤按实际版本提示完成：
申请授权前先看机器码：「运维 → 许可状态」（或浏览器打开 http://<服务器IP>:7777/app/edge-self/ 激活页）。 License Key、机器码、有效期、配额在「运行状态」一站式查看。
日常运维（TUI）
运行状态：容器 + 云端连通性 + license 一站式检查（执行页实时展示）：
一键升级 / 回退镜像 / 备份数据库 / 恢复备份 / 卸载部署：均在「运维」菜单内菜单化执行，升级前自动备份数据库；
更新 urops：工具自身升级；远程运维：tailscale 组网（安装/连接/状态/设备列表/自检）：
也有等价命令行（脚本/AI 场景）：
urops status、urops upgrade、urops update、urops backup等。
常见问题
- 部署/升级时提示「云端不可达 HTTP 522」：云端域名直连被网关拦截时，节点可在 compose 应用服务配置
HTTPS_PROXY（同时配NO_PROXY含内部服务名）走代理；urops 探测/心跳复用容器代理（v1.1.1+）。 - 升级备份失败「the database system is in recovery mode」：数据库恢复中属正常，urops 会自动等待 数据库就绪后重试（v1.1.3+）；也可
urops upgrade --no-backup跳过备份。 - 激活失败/授权文件校验失败：授权码为单机绑定，确认与机器码一致；旧镜像公钥可能不匹配， 请
urops update升至最新后重试。 - 前端页面 404：确认部署类型镜像包含对应应用（
urops status查看镜像版本），或联系联犀获取。 - VNC/控制台界面乱码：字符控制台（
TERM=linux）或非 UTF-8 locale 下 urops 自动切换英文（v1.1.18+）；
需要中文可安装中文字体（如fonts-unifont）并确保 locale 为 UTF-8，或urops lang zh强制中文。
技术细节
- 升级/回退只重建应用服务，数据库等数据容器不动；升级前自动备份数据库（保留最近 10 份，
urops backup手动备份）。 - 需要许可的行业应用按对应授权范围与有效期使用；基础版永久免费不等于全部应用免费，离线条件以所选版本为准。
- 详细命令与配置见 urops 工具使用指南。
更新日志
2026/10/19 14:50
查看所有更新日志
61e09-于9d62c-于54945-于355b6-于66140-于c1424-于37dfa-于af804-于bddea-于054ea-于09eb8-于0aef7-于cf613-于51ff0-于d4fa0-于12463-于f4a75-于c12e0-于cc869-于6449d-于a7823-于6b3f8-于80a75-于2a8b3-于9ed31-于f4017-于79a65-于d999f-于90f49-于aef02-于27289-于cf61b-于6055d-于df9b4-于