前阵子有位养虾的朋友问我你说的“云养虾”是不是要在手机和电脑上装个什么 App 才行我说不装ArkClaw 部署完之后你只需要一个浏览器地址一输虾塘画面、水温、溶解氧、喂食记录全在眼前。他听完还有点不信觉得“零安装”听起来像营销话术。其实 ArkClaw 的定位很明确它是一个把虾塘监控、数据采集、告警和分析都收拢到 Web 端的管理工具。对使用者来说客户端确实是零安装——不用装 App、不用配播放器、不用折腾内网穿透软件。但在真正上手之前有几个概念必须先捋清楚否则很容易把“零安装”理解成“零部署”然后卡在第一步。这篇文章面向三类人一是自己养虾想远程看塘的养殖户二是帮养殖场做物联网改造的集成商和电工朋友三是纯粹对农业物联网感兴趣、想低成本搭一套监控系统的技术爱好者。我会把 ArkClaw 从部署到日常使用的完整路径讲清楚包括我实际踩过的坑尽量让你看完就能照着做。1. 先搞清楚 ArkClaw 是什么它不是 App是一个“浏览器里的虾塘控制台”很多人第一次听到 ArkClaw第一反应是“这又是一款某某云 App”。不是的。ArkClaw 本质上是一个服务端程序装上之后它替你完成摄像头拉流、传感器接入、录像存储、告警通知这些事情。你平时的操作界面就是网页。1.1 传统虾塘监控为什么麻烦以前我去看一个养殖场他们的监控方案是每个塘口装 4 个摄像头接一台硬盘录像机NVR想看画面的时候必须人在现场或者让会设置端口映射的技术员远程搞一下。水质检测更原始一天测三次拿个溶解氧仪到塘边看数值然后记在本子上。这种模式的问题很明显不在塘边的时候你就是一个瞎子。工人说“水色不错”你没法确认录像机自带的“远程访问”配置繁琐手机 App 绑定摄像头常失败多品牌混用要装好几个 App水质数据不能自动积累等虾出问题再翻本子根本看不出变化趋势ArkClaw 解决的就是把这些分散的东西统一到一个界面里。摄像头只要能出 RTSP 流传感器只要能上报数据ArkClaw 就能把它们都接到一起形成一个按塘口组织的控制台。1.2 ArkClaw 的三种角色采集端、服务端、浏览器端我建议你用“角色”的眼光去看这套系统会好理解很多。采集端指的是摄像头、溶解氧传感器、温度探头、水位计这些设备。它们只负责产生数据不负责展示。摄像头输出 RTSP 流传感器通过 Modbus、RS485 或者 4-20mA 信号输出数据。有条件的会配一个数采仪或网关再把数据通过 MQTT 或 HTTP 传给 ArkClaw。服务端也就是 ArkClaw 本身。它负责接收采集端数据、存录像、跑告警规则、输出网页。装在一台常开的小主机或服务器上我用的是低功耗工控机跑得很稳。浏览器端你、你的合伙人、你的工人用电脑或手机浏览器打开 ArkClaw 的网页地址看实时画面、查历史数据和录像。这就是“零安装”的由来。有不少人问我为什么不用 NVR 自带的平台可以但 NVR 平台多数绑死厂商设备甚至绑死同一型号。ArkClaw 更像一个“翻译层”把不同品牌设备的协议统一成一套 UI这对多品牌摄像头混用的场景特别友好。1.3 零安装真的零吗——给第一次用的人交底严格说使用端零安装是真的但服务端必须要有人做一次性部署。这个“有人部署”躲不掉就像你在手机上用网银不需要装银行客户端但银行服务器总得先有人维护。ArkClaw 的服务端我推荐用 Docker 跑。只要机器上有 Docker 环境拉镜像、起容器、映射端口十几分钟能完成。如果你连 Docker 都还不太熟建议先拿一台 Ubuntu 22.04 或 Debian 12 的机器练手不要直接上生产。部署完成后日常使用就是纯浏览器操作手机上也能用。苹果的 Safari、安卓的 Chrome、电脑上的 Edge 我都试过核心功能都能跑。2. 让“零安装”成立的一次性部署服务器与端口配置既然客户端零安装那重点就在服务端。这一节按我实际部署的顺序走尽量把每一步为什么这样做也讲清楚。2.1 准备一台能长期开机的机器ArkClaw 对硬件的要求不高但它必须长期开机因为虾塘的摄像头和传感器是 7x24 小时工作的。如果你只白天上班时间看一会儿那也得全天录着夜间出问题才能有录像可查。我个人的参考配置CPU4 核就够解码和转流主要看 CPU不看 GPU内存8GB 起步录像索引、Web 服务、前端转推都要吃内存存储建议 1TB 以上机械硬盘或 SSD。如果有 4 路 1080P 摄像头常录一天大概 40-60GB自己算一下保留天数系统Ubuntu 22.04 LTS 或 Debian 12稳定最重要如果你没有现成服务器用云主机也可以但要注意云主机出方向带宽。每一路摄像头远程预览至少要留 1-2Mbps 带宽我看 4 路同屏时带宽不够会出现画面转圈。2.2 用 Docker 完成服务端安装ArkClaw 官方提供 Docker 镜像推荐用 docker-compose 管理。先创建一个目录比如/opt/arkclaw里面放docker-compose.yml内容大致如下version: 3.8 services: arkclaw: image: arkclaw/arkclaw:latest container_name: arkclaw restart: always ports: - 8080:8080 volumes: - /opt/arkclaw/data:/app/data - /opt/arkclaw/recordings:/app/recordings environment: TZ: Asia/Shanghai ARKCLAW_DATA_DIR: /app/data ARKCLAW_RECORDING_DIR: /app/recordings第一次启动前先docker pull arkclaw/arkclaw:latest把镜像拉下来然后cd /opt/arkclaw docker compose up -d启动后在本机浏览器里访问http://服务器IP:8080能看到初始化向导让你设置管理员账号和密码。这个页面做完部署部分基本就结束了。注意/opt/arkclaw/data和/opt/arkclaw/recordings这两个目录一定要挂在宿主机上。如果不挂载容器删掉重来的时候所有配置和历史录像一起没了。这是我第一次部署时差点翻车的点后来养成了习惯任何容器都先把数据卷挂好。2.3 配置端口内网访问与外网访问初次配置完你先在内网测试一下。手机连同一个路由器输入http://192.168.x.x:8080能打开说明服务正常。要想人不在虾塘也能看就得让外网也能访问。常见做法有三种方案优点缺点适合场景公网 IP 路由器端口映射稳定、速度快需要向运营商申请公网 IP且要自己配防火墙有条件拿到公网 IP 的用户内网穿透frp、Tailscale 等无需公网 IP部署快中转带宽受限延迟稍高临时使用、预算有限的场景云服务器中转组网管理最方便最稳定要购置云服务器有一定成本多塘口、多人同时访问的场景我个人最推荐的是“零安装验证”阶段先用 Tailscale 或类似的组网工具因为它不影响 ArkClaw 本身只把你的手机和服务器放进同一个虚拟局域网里手机上照样用浏览器打开内网地址。等确认 ArkClaw 用起来没问题再考虑用公网 IP 做正式对外服务。这样你始终清楚问题出在“ArkClaw 本身”还是“网络链路”。2.4 安全基操不要裸奔在公网ArkClaw 暴露到公网后第一件事不是加功能而是改默认端口、开 HTTPS、设强密码。我见过有人直接把 8080 端口暴露出去密码还是 admin/admin结果被扫到之后人家把他摄像头的 RTSP 地址改得一塌糊涂。我的经验修改 ArkClaw 对外映射端口比如把宿主机的8443映射到容器的8080别用默认端口如果 ArkClaw 支持 HTTPS 配置优先配证书不支持就前面套一个 Nginx 做反向代理把 TLS 终结在 Nginx管理员密码至少 16 位且不要和 Wi-Fi 密码重复这一步看似和养虾没关系但它决定你的系统能活多久。3. 设备接入摄像头和探头进 ArkClaw 的关键一步服务端跑起来只是地基真正花时间的其实是设备接入。不同厂家的摄像头、传感器协议各不相同能顺利接进来才算把“云养虾”从口号变成现实。3.1 摄像头接入RTSP 地址是绕不开的坎ArkClaw 里添加摄像头核心是填写 RTSP 地址。常见的格式是rtsp://用户名:密码摄像头IP:554/Streaming/Channels/101不同品牌的路径不一样但套路一致。你把摄像头接到和服务器同一个局域网先用浏览器登录摄像头管理后台开启 RTSP 功能设一个专用的 RTSP 账号然后在 ArkClaw 里添加通道。我建议你在电脑上先用 VLC 或 PotPlayer 验证一下这个 RTSP 地址能不能出画面再接进 ArkClaw。如果 VLC 能放、ArkClaw 不行那大概率是 ArkClaw 转流模块和该摄像头的编码格式兼容问题如果 VLC 都不行那就先查账号权限、IP 连通性别急着甩锅给 ArkClaw。主码流和子码流的选择也有讲究主码流分辨率高适合录像、回放、放大看细节子码流分辨率低适合手机远程预览、多路同屏ArkClaw 里通常可以为主码流和子码流分别配置预览时用子码流录像时用主码流这样带宽和存储都能平衡。我见过有人只填了一个高清主码流手机上看 4 路卡成幻灯片后来改成双码流才顺畅。3.2 传感器数据让虾塘的“体检指标”自动化现在很多虾塘都会配溶解氧传感器、pH 探头、温度探头、水位计。设备层面的接线方式各不同但上云的方式无非几种传感器直连数采仪数采仪通过 RS485 接到一台边缘网关网关上报到 ArkClaw物联网 4G RTU 直接采集传感器通过 MQTT 把数据推给 ArkClaw有以太网口的智能探头直接走 HTTP API 上报ArkClaw 对 MQTT 支持比较成熟。以常见的溶解氧探头为例你在边缘网关里配置 MQTT Broker 地址和 Topic网关每 5 分钟上报一次 JSON{ tank_id: T01, ts: 2025-06-01 08:00:00, do_mg_l: 6.2, temp_c: 28.4 }ArkClaw 侧要做的就是配置好 Topic 解析规则把do_mg_l和temp_c字段映射成塘口 T01 的指标。我第一次配置时犯过一个低级错误网关上报时间用的是设备本地时间但设备时区没设成北京时间导致数据入库后趋势图整体偏移了 8 个小时。排查很久才想起来是设备时区问题。所以记住物联网设备第一件事就是校时时区统一。3.3 建立塘口用“塘口”把设备和数据绑定摄像头和传感器都接入后要到 ArkClaw 里建“塘口”。一个塘口可以理解为一个逻辑单元绑定若干摄像头、若干传感器、一块池塘平面图。实际操作时我给每个虾塘这样命名T01-南塘对应绑定南塘东 1 号摄像头、南塘西 2 号摄像头、溶解氧探头 DO-01、温度探头 T-01这样做的好处是后续看趋势图、回放录像、配置告警都能以塘口为单位不需要每次分别选设备。界面里一般有“添加塘口”按钮按提示填名称、上传平面图、勾选设备即可。平面图可以简单画不要求多精美主要是让塘口列表看着直观。4. 日常使用打开浏览器就能看的四个核心功能设备接入完成后ArkClaw 就进入“日常服役”阶段。我挑最常用的四个场景展开这些也是我朋友试用后觉得“真香”的地方。4.1 实时预览手机上刷一眼就知道塘边什么情况ArkClaw 的实时预览页面默认带分组视图。你可以把 T01 的四路画面放一屏也可以只挑一路放大看。这里有一个关键技术细节视频流从摄像头到浏览器往往需要 ArkClaw 做一次“转流”。摄像头原始 RTSP 流是 H.264 或 H.265 编码浏览器不能直接播放 RTSP所以 ArkClaw 需要把流转换为浏览器能识别的格式常见的是 HLS 或 WebRTC。HLS 有 3-10 秒左右的延迟适合看回放WebRTC 延迟低到 1 秒内适合看实时画面。如果 ArkClaw 支持双模式切换我的建议是多路预览时用 HLS单独盯某一路时切 WebRTC。别一上来就追求全部 WebRTC摄像头接入路数多时转推压力不小。手机上的操作体验和电脑端差别不大。你只需要记住网址浏览器打开、登录就可以在塘边坐着喝茶的同时看画面。4.2 录像回看抓“漏网之鱼”的关键手段虾塘难免有突发情况半夜增氧机停转、进水口堵塞、工人操作失误。如果没有录像回放这些问题基本就是“事后猜”。ArkClaw 的录像回放我习惯搭配“事件时间轴”用。它会把每个摄像头按秒生成索引你在时间轴上一拖画面就跳到对应时间点。支持拖动播放、逐帧暂停、倍速回放。实际排查问题时的流程我是这么走的先看告警记录确认大概发生时间点在时间轴上跳到事发前 15 分钟用 4 倍速快速播放注意力放在水面变化、人员动作上发现关键节点后切回 1 倍速逐帧看这个流程能解决塘里虾浮头、增氧机停转这类问题。有一次工人凌晨 2 点发现南塘溶解氧掉到 1.2mg/L我通过回放看到是 1 点 47 分时增氧机过载跳闸了录像里甚至能看到机身指示灯熄灭的瞬间。4.3 告警联动让系统替你瞪着眼睛养虾的人不可能 24 小时盯着屏幕看告警规则才是“云养虾”的含金量所在。ArkClaw 的告警规则一般是“指标阈值 持续时间 通知渠道”的组合。比如溶解氧低于 3.0mg/L持续 10 分钟触发预警水位低于警戒线持续 5 分钟触发预警所有摄像头画面丢失超过 5 分钟触发预警通知渠道上最常见的是邮件、Webhook 和自定义 HTTP 请求。国内用得多的还是微信或者钉钉一般通过企业微信机器人或钉钉机器人推送配置方法就是把机器人 Webhook 地址填到 ArkClaw 里。规则里有一个参数很容易被忽略持续时间。如果你只设阈值、不设持续时间那么探头在水里稍微波动一下就会误报一天能推几十次最后人麻了真出大事反而没人看。我实际用的是“连续 2 次采样均超标”或“持续 10 分钟”误报率明显下降。4.4 数据看板把散点数据变成趋势ArkClaw 的数据看板功能可以拉出每个塘口的水温、溶解氧、pH 的历史折线图。我建议你固定一个习惯每天早上打开数据看板看前 24 小时的趋势曲线。单看数值可能看不出问题但曲线能暴露趋势溶解氧每天傍晚开始下降说明藻类呼吸耗氧大增氧机要提前开水温从 28 度缓慢升到 30 度持续一周说明气温回升要关注虾蜕壳频率连续几天 pH 早晚差值过大说明藻相可能不稳定这些不是 ArkClaw 自动算出来的但它给了你足够的基础数据让你有据可依而不是拍脑袋决定。5. 实测遇到的坑从 RTSP 地址到回放时间轴任何工具不实际用一遍都发现不了坑。这一节我把自己在 ArkClaw 部署和日常使用里踩过的坑整理一下都是能复现、能避开的实际问题。5.1 摄像头的“隐形 RTSP 地址”某品牌摄像头包装盒上写着一个云台控制 App 的二维码你扫码装 App 绑定后在 App 里能看画面但始终拿不到 RTSP 地址。查了一圈发现该摄像头默认不启用 RTSP 服务必须登录摄像头本地 Web 管理界面在“网络设置”里手动勾选“启用 RTSP 认证”设置一个有效账号之后才能用rtsp://协议访问。有些便宜的家用摄像头甚至连 RTSP 服务都不提供只能用它自己的私有协议这种摄像头就别指望接入 ArkClaw 了直接换设备。5.2 回放时间轴错位所有设备时间必须统一回放时间轴出现 8 小时或几十分钟的错位是常见故障。根因通常是摄像头和 ArkClaw 服务器的时间不同步。摄像头的做法五花八门有的支持 NTP 同步有的只能手动设置时间。时间一旦漂移录像文件上的时间戳就乱了回放时就会出现“明明 8 点录的时间轴显示 3 点”。解决办法是在接入时给每台摄像头都配置 NTP 服务器至少确保它们和 ArkClaw 服务器使用同一台 NTP 源。如果现场设备没有 NTP 功能定期检查时间就是必做功课。5.3 公网预览卡顿先查带宽再骂 ArkClaw有段时间我在手机上看四路预览时总是转圈一度怀疑是 ArkClaw 转流性能问题。排查后发现我家宽带上行只有 20Mbps四路子码流同时拉流需要约 12Mbps看着数据量不大但放在公网上极易波动。后来我把预览改成只开一路主画面其余路暂停或切到更低分辨率问题立刻缓解。所以判断性能瓶颈时按这个顺序查客户端的网络带宽和信号服务器侧上行带宽摄像头的子码流设置ArkClaw 转流服务的 CPU 占用大多数情况下前三步就能定位问题别一上来就怪 ArkClaw。5.4 手机浏览器看不了 H.265 视频流有一批摄像头默认主码流是 H.265 编码电脑上的 Chrome 能正常回放但手机上的某些浏览器可能播放黑屏。原因很简单浏览器对 H.265 的支持没有 H.264 那么统一。ArkClaw 本身可能做了转封装或转码但转码对 CPU 压力比较大如果服务器性能一般建议摄像头直接切换到 H.264 编码兼容性最好。一台服务器接十几路 H.265 高清码流还想顺畅转码基本不现实远不如在摄像头端改编码省事。5.5 容器重启后配置丢失这个坑最隐蔽。Docker 更新镜像后顺手docker compose down up了一下结果 ArkClaw 账号配置、告警规则全没了。原因就是我前文强调过的容器内部的数据目录没挂载到宿主机。之前图省事直接 run 了一个匿名卷容器一删除数据就没了。后来我吸取教训所有有状态服务都改成 docker-compose 管理并且把 data 和 recordings 目录显式挂载到宿主机。6. 进阶玩法多塘口、多角色、大屏展示基础功能用顺手之后你可以考虑把这些能力进一步铺开我就是这么一步步从一个塘口扩展到全场的。6.1 一个 ArkClaw 管多个塘口原本我只用 ArkClaw 管南塘。后来北塘、育苗池也想纳入直接就在 ArkClaw 里继续加塘口、加设备不用重复部署服务。多塘口场景下我建议在“设备命名”上保持统一规范用“塘口-设备类型-序号”的格式比如T02-DO-02北塘二号溶解氧探头T03-CAM-013 号塘东侧摄像头高密度场景设置清晰命名后无论是配置告警还是找历史数据效率都会高很多。设备一多乱命名的代价真的很大。6.2 给工人和其他合伙人开不同权限ArkClaw 一般支持创建多个账号并分配不同角色。我把自己的账号设成管理员可以改配置、删录像、调设备工人账号只有“查看”权限能看到实时画面和当前指标但碰不了设置。这个功能不要忽略。有一次我自己调试子码流把某路摄像头临时停了几十分钟工人正好想预览他账号没权限操作但也不会因为能看到设置项而误点。权限边界清晰能省掉大量解释成本。6.3 大屏和电视墙周末我在客厅电视上放了一个“虾塘总览”页面ArkClaw 的界面在电视浏览器里全屏显示塘口列表、溶解氧曲线、多路预览同屏滚动。来参观的朋友以为我搞了什么高端监控中心其实就是一台普通电视加浏览器。这套“屏”的思路也可以放在办公室或家里给数字电视装一个浏览器设为开机自动打开 ArkClaw 全屏页面用树莓派或电视盒子接一台大屏定时刷新数据看板播放页面的关键是不能闲置太久导致浏览器休眠我一般会设一个轻量刷新脚本或者使用 ArkClaw 自带的“轮询视图”功能页面自动切换塘口。写在最后给想上手的你一句实在话ArkClaw 真正让我觉得值得的不是“零安装”这个卖点而是它把分散的虾塘数据统一成一个每天可看的入口。早晨打开浏览器扫一眼溶解氧曲线看一眼前一夜录像有没有异常心里就有底——这比半夜被电话吵醒再跑到塘边强太多了。如果你正打算部署我的建议是第一步先在局域网里用一台旧电脑把 ArkClaw 跑起来接一路摄像头试试第二步加一个传感器探头配一条最简单的告警规则第三步确认稳定跑一周后再考虑改公网访问、上 HTTPS、加多塘口我最后悔的就是一开始贪多求全同时接摄像头、传感器、告警机器人结果没跑通就手忙脚乱。小步快跑是这种自托管系统最靠谱的路径你也千万别一上来就追求什么都配齐全。