接入盒安装

接入盒是现场的一台小主机（x86 N100，两个网口），只做两件事：从相机拉画面，经加密通道推到沅虹的处理中心。识别不在盒子上做。

盒子分两种来法：沅虹出厂预装的，到现场只接三根线；自己买机器装的，一条命令。

一、沅虹出厂的盒子：接三根线

给现场安全员或电工。整个过程大约 5 分钟，什么都不用设置。

线	插哪	从哪来
宽带线	盒子上的蓝口	光猫或墙上的宽带网口
相机线	盒子上的黄口	相机交换机上任意一个空口
电源线	盒子的电源口	插座，最好是不会被随手拔掉的那个

蓝口和黄口不能插反。插反了相机不会出画面，换过来就好，不会弄坏东西。

插电后等两分钟。 盒子自己联网、自己找相机。两分钟内不要拔线，不要反复开关。

看灯：电源灯常亮是通电了；蓝口、黄口旁边的小灯亮着或在闪，线就插好了。哪个口的小灯不亮，把那根线拔下来重新插紧，还不亮就换一根网线。

不用做的事：不用接显示器键盘，不用输密码，不用下载手机软件，不用改相机、不用改光猫。装好后，客户管理员在电脑上就能看到盒子和相机。

放在哪：弱电箱或机柜里，旁边有插座。别和发热的设备挤在一起，别被雨淋，别放在积水的地方。盒子一直开着，不要关机。

出了问题：拍两张照片发给沅虹客服（盒子贴纸上有联系方式）。一张盒子正面，能看清灯和贴纸；一张盒子后面，能看清两根网线插在哪个口。别自己拆盒子，别按盒子上的小孔，别把盒子接到办公室的网里。

二、自己的机器：一条命令

适用于 Debian 12 或 Ubuntu 22.04 以上、x86_64 或 arm64、能上网的机器。沅虹自己预装出厂也是走这条。

单网口机器（相机和宽带在同一个网里）

curl -fsSL https://dl.uanhon.cn/box/get.sh | sudo bash -s -- --code 接入码

接入码在智眸「系统设置 → 接入」分区点"生成接入码"拿，24 小时有效，只能用一次。装完直接入网，盒子会出现在接入页。

双网口机器（蓝口接宽带，黄口接相机）

curl -fsSL https://dl.uanhon.cn/box/get.sh | sudo bash -s -- --router
sudo reboot
sudo uanbox-prebind 接入码

--router 会把第一个口配成自动获取地址的宽带口，第二个口配成 192.168.88.1/24 并给相机发地址，两个口之间不转发。网口名不是 enp1s0 / enp2s0 时加 --wan 口名 --lan 口名。改网口要重启才生效，所以入网放在重启之后。

常用参数

参数	什么时候用
--pppoe 账号	宽带是光猫桥接要拨号。口令按提示输入，不写在命令里
--ssh-wan / --ssh-lan	防火墙缺省不放 SSH。要远程维护加前者，技术员带笔记本接黄口兜底加后者
--no-apt	离线镜像里已经装好 chrony、ffmpeg 时跳过装系统包
--dry-run	只打印要做什么，不改任何东西
--reset-machine-id	做出厂镜像克隆前必须带，单台装机不用
--ha 1 / --ha 2	两台盒子接同一台相机交换机互备（要和 --router 一起）：1 号黄口 .2 并给相机发地址，2 号 .3；192.168.88.1 在两台间浮动，相机的网关和对时仍填 .1

一条命令做的事：按机器架构取最新版安装包和校验和，核对，装 uanbox-agent 与 mediamtx 两个程序和两个 systemd 单元，配对时。可以重复执行，再跑一遍就是升级。

装完看什么

journalctl -u uanbox-agent -u uanbox-mediamtx -f     # 日志
sudo /opt/uanbox/current/uanbox-agent probe          # 只跑一次网络与相机自检

接入页上盒子显示"在线"、网络结论绿色"合格"，就可以让客户管理员接相机了。网络不合格时，接入页会给出一段给网络负责人的话，照着转就行。

两台盒子互备

一个现场装两台盒子，各接一条宽带，黄口都接相机交换机，一台装 --router --ha 1、另一台 --router --ha 2，两台各自用接入码入网到同一个现场。之后：

• 盒子坏了或断网超过 90 秒，它的相机由另一台接管；它回来并稳定 10 分钟后相机还回去（接入页可以关掉自动还回）。
• 管理员保存口令时，同一台相机的口令会给两台盒子各封一份；后加的盒子要再保存一次口令，没拿到口令的盒子不会接管。
• 接入页现场卡片显示"冗余"：两台在线且走不同宽带才算有效；走同一条宽带会提示。盒子卡片上有"演练切换"，验收时当着客户切一次。

三、升级、回滚、卸载

• 升级：再跑一遍那条命令。新版本装进自己的目录，原子切换，旧版本不删。
• 回滚：ls /opt/uanbox/versions/ 看有哪些版本，把 /opt/uanbox/current 指回旧目录，重启两个单元。身份与相机口令不随版本走，回滚不用重新入网。
• 卸载：sudo /opt/uanbox/current/install.sh --uninstall，身份与口令保留；加 --purge 连身份一起删，之后请沅虹在后台吊销这台盒子。

四、哪些文件在哪

路径	说明
/opt/uanbox/current/	当前版本的程序
/etc/uanbox/agent.env	控制面地址等配置
/etc/uanbox/cameras.secret	相机口令（600），手填的优先于接入页下发的
/var/lib/uanbox/	盒子身份、下发配置、上送记账、标签

盒子丢了或被偷：马上告诉沅虹停用这台盒子，并把相机的预览口令改掉。