安装部署

系统要求

镜像变体怎么选

AI 检测的硬件加速分 4 个变体，对应不同硬件。装错变体只会让检测变慢或不工作，其它功能（录像、回放、对讲）不受影响。一键部署脚本会自动探测硬件帮你选对——下面这张表只是给想手动选的人参考。

按硬件选档（详细参考）

买新机或评估现有机器时，按 CPU 算力分 5 档对照下表。给出推荐镜像、能稳定带的摄像头数、以及能流畅跑哪些 AI 检测功能（启用与否需自己在网页后台手动开）。

各档位能流畅跑的检测功能

档位越高能稳定开的功能越多。低档位机器开太多功能会让推理跟不上摄像头帧率，导致漏检事件。下表是每档推荐打开的检测能力——✅ 表示推荐打开、❌ 表示不建议在该硬件上开。新装默认只开物体检测，其余都需要在 网页后台 → 设置 → 检测 里按需手动启用。

一键部署（推荐）

运行一行命令，脚本会自动检测硬件、选最合适的镜像变体、拉镜像、起容器，全程 5–15 分钟（看网络）。

curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash

脚本做了什么：

• 检查系统是 Linux x86_64 + Docker 已装
• 检查 23406 / 23880 / 24214 / 23515 等端口空闲
• 探测硬件：NVIDIA 显卡（含显存）/ Intel 集显 / Intel NPU
• 自动选 cpu / openvino / cuda / trt 中最合适的镜像变体
• 拉镜像（默认从阿里云）+ 写 docker-compose 文件 + 自动生成强随机密钥
• 启动容器并等健康检查通过（约 60 秒）
• 输出浏览器访问地址（如 http://192.168.1.10:23406/）

常用参数

# 只看推荐什么变体，不部署
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- --detect-only

# 强制用 trt 变体并跳过交互
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- --variant trt -y

# 离线部署（先把镜像 tar.gz scp 到机器上）
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh -o install.sh
bash install.sh --offline /path/to/skyview-image.tar.gz

按平台部署（选你的设备）

一键脚本对通用 Linux + Docker 环境最方便，但 NAS、HA OS、PVE 等平台都有自己的容器管理 UI、网络模式、iGPU 透传方式和已知坑。下面针对常见目标平台给单独教程，包含每个平台特定的 compose 文件、UI 部署路径、防火墙配置和常见问题：

• 群晖 Synology DSM 7.2+ — Container Manager + Intel 核显机型（DS920+ / DS423+ / DS224+ 等）
• Unraid 6.12+ — Compose Manager + Intel GPU TOP / NVIDIA Driver plugin
• 飞牛 fnOS — Debian 12 base + N100/N305 内置 iGPU
• 绿联 UGOS Pro — x86 机型（DXP2800/DXP4800/DXP6800 等）
• TrueNAS Scale 24.10+ — Custom App YAML + ZFS dataset 持久化
• Ubuntu / Debian — apt + docker compose v2，最干净的部署路径
• Fedora 39+ — dnf docker-ce + SELinux 卷标签 + firewalld 放行
• Proxmox VE LXC — privileged LXC + Intel iGPU 透传（家用 N100 / N305 PVE 用户首选）
• Home Assistant OS 加载项 — 加云瞰仓库一键装 yunkan / yunkan-openvino addon
• RK3588 板 — 瑞芯微 NPU 加速的低功耗 ARM 小盒子(Orange Pi 5 / Radxa Rock 5 等);推荐 4GB 板,8G+ 实验性

手动部署（高级）

想自己一步步控制部署过程的，按下面 4 步走。一键脚本本质就是把这些命令自动化了。

1. 1

   拉镜像

   选好上面四个变体之一：

   bash复制

   docker pull registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest

2. 2

   建数据 / 录像目录

   小状态（数据库 / cookies / 日志）落在 data/；录像（可达 TB 级）单独放同级的 recordings/，方便单独指到大盘 / NAS。

   bash复制

   mkdir -p ~/skyview/data ~/skyview/recordings && cd ~/skyview

3. 3

   起容器

   用 host 网络让相机直接通过宿主机端口，避免 NAT 影响视频质量。授权绑定要求 bind-mount /etc/machine-id 和 product_uuid，不要省。

   bash复制

   docker run -d --name yunkan --restart=always \
     --network host \
     -v $(pwd)/data:/app/data \
     -v $(pwd)/recordings:/app/data/recordings \
     -v /etc/machine-id:/etc/machine-id:ro \
     -v /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro \
     registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest

4. 4

   打开浏览器

   首次访问跳到 /setup 向导，按 首次启动 一章往下走。

   复制

   http://<服务器 IP>:23406

端口和卷映射

云瞰 用 host 网络模式跑，所有端口都直接绑在宿主机上。生产端口都加了一个非常规偏移到 2xxxx 区间，避免和你机器上已有的 nginx 80/443、redis 6379、其它服务的 8080/8554/8888 冲突。

环境变量参考

以下环境变量全部可选——host 网络的标准部署一个都不用设，只有桥接网络、反向代理、固定内部密钥等进阶场景才用得到。在 compose 文件的 environment: 段（或各 NAS 平台的环境变量表单）里设置。

升级

最方便：网页后台一键升级。 浏览器进 网页后台 → 设置 → 系统 → 检查更新，发现新版本点 "升级" 即可——系统会自动拉取新镜像并重建容器（升级前自动备份数据库，新版本启动异常会自动回滚到升级前版本），几分钟后页面自动重连到新版本。

想自己在 SSH 里手动升级也行：

cd ~/skyview
docker compose -f compose.yml pull
docker compose -f compose.yml up -d

或者重跑一键脚本（带 -y 不打扰）：

curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- -y

卸载

cd ~/skyview
docker compose -f compose.yml down
docker rmi registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest
# 录像 / 数据库继续保留，需要彻底清理：
rm -rf ~/skyview